This is a tool for using Android with open-source mesh radios.

Go to file

andrekir 8405ccd84f chore: disable Jetifier		2023-01-31 18:18:50 -03:00
.github	Create FUNDING.yml	2023-01-28 12:11:35 -03:00
.idea	Remove files about to be added to .gitignore	2022-02-08 14:48:58 -08:00
.settings	Don't include firmware in development builds (speeds install time)	2020-06-28 14:55:02 -07:00
app	feat: use FusedLocationClient for google flavor	2023-01-31 18:17:13 -03:00
design@a5c2cbe937	updating submodules to latest	2022-11-02 14:56:49 -03:00
gradle/wrapper	upgrade gradle libs	2022-11-02 15:38:26 -03:00
images	Fix amazon button	2021-05-28 10:21:20 +08:00
scripts	map analytics optional	2020-04-11 13:20:30 -07:00
.gitignore	remove mapbox reference	2022-08-29 11:06:47 -03:00
.gitmodules	update submodule names	2022-11-02 14:49:38 -03:00
.project	Don't include firmware in development builds (speeds install time)	2020-06-28 14:55:02 -07:00
LICENSE	Add license and copyright	2020-03-01 16:39:53 -08:00
README.md	docs: review badge after mainline repo inclusion	2023-01-22 22:11:33 -03:00
TODO.md	WIP update to android 30	2021-06-10 10:02:28 -07:00
build.gradle	feat: add fdroid and google flavors	2023-01-20 12:27:27 -03:00
debugging-android.md	add instructions on how to capture logcat logs	2020-03-07 17:19:36 -08:00
gradle.properties	chore: disable Jetifier	2023-01-31 18:18:50 -03:00
gradlew	update gradle to 6.4	2020-05-29 14:11:43 -07:00
gradlew.bat	update gradle to 6.4	2020-05-29 14:11:43 -07:00
settings.gradle	remove android-lib from settings.gradle	2022-09-11 23:36:41 -03:00

README.md

Meshtastic-Android

This is a tool for using Android with open-source mesh radios. For more information see our webpage: meshtastic.org. If you are looking for the the device side code, see here.

This project is currently beta testing, if you have questions or feedback please Join our discussion forum. We would love to hear from you!

If you want to join the Play Store beta program go to this URL and opt-in to the alpha/beta test. If you encounter any problems or have questions, post in the forum and we'll help.

However, if you must use 'raw' APKs you can get them from our github releases. This is not recommended because if you manually install an APK it will not automatically update.

Build instructions

If you would like to develop this application we'd love your help! These build instructions are brief and should be improved, please send a PR if you can.

Use Android Studio to build/debug
Use "git submodule update --init --recursive" to pull in the various submodules we depend on
There are a few config files which you'll need to copy from templates included in the project. Run the following commands to do so:

rm ./app/google-services.json
cp ./app/google-services-example.json ./app/google-services.json
rm ./app/src/main/res/values/curfirmwareversion.xml
cp ./app/special/curfirmwareversion.xml ./app/src/main/res/values/

Now you should be able to select "Run / Run" in the IDE and it will happily start running on your phone or the emulator. Note: The emulators don't support bluetooth, so some features can not be used in that environment.

Analytics setup

analytics are included but can be disabled by the user on the settings screen
on dev devices

adb shell setprop debug.firebase.analytics.app com.geeksville.mesh
adb shell setprop log.tag.FirebaseCrashlytics DEBUG

for verbose logging:

adb shell setprop log.tag.FA VERBOSE

Credits

This project is the work of volunteers:

@artemisoftnian: Contributed Spanish translations.
@CycloMies: Contributed Swedish, Finnish and German translations.
@eriktheV-king: Contributed Dutch and French translations.
@Lgoix: Contributed tooltip for radio mode
@Eugene: Contributed Russian translation.
@Jinx17: Contributed Slovenian translation.
@Konradrundfunk: Contributed German fixes.
@Mango-sauce: Contributed Chinese translation.
@NEKLAN: Contributed Japanese translation.
@Ohcdh: Contributed Irish and Italian translations.
@Slavino: Contributed Slovak translation.
@Zone: Contributed Turkish translation.