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

Go to file

geeksville 65eb859a61 update credits		2020-05-29 14:02:03 -07:00
.github/workflows	ci fighting	2020-04-02 22:32:53 -07:00
.idea	wip decomposing channel	2020-04-07 16:04:58 -07:00
app	fix warnings	2020-05-29 14:00:50 -07:00
geeksville-androidlib@8ccbd0b688	set aside ble sw update for now	2020-05-15 10:18:15 -07:00
gradle/wrapper	update to dev07 compose	2020-03-29 13:38:50 -07:00
images	firmware update progress bar kinda works	2020-05-14 11:47:24 -07:00
scripts	map analytics optional	2020-04-11 13:20:30 -07:00
.gitignore	fix gitignore	2020-04-11 13:37:20 -07:00
.gitmodules	Pull in geeksville-androidlib via git submodule	2020-03-02 10:02:50 -08:00
LICENSE	Add license and copyright	2020-03-01 16:39:53 -08:00
README.md	update credits	2020-05-29 14:02:03 -07:00
TODO.md	Making app aware of device sleep states, Fix #4	2020-04-04 17:00:38 -07:00
build.gradle	Thanks to @NEKLAN for Japanese translations!	2020-05-29 14:00:25 -07:00
debugging-android.md	add instructions on how to capture logcat logs	2020-03-07 17:19:36 -08:00
gradle.properties	update to latest IDE	2020-01-20 16:13:40 -08:00
gradlew	initial checkin of virgin project	2020-01-20 15:53:22 -08:00
gradlew.bat	initial checkin of virgin project	2020-01-20 15:53:22 -08:00
settings.gradle	Pull in geeksville-androidlib via git submodule	2020-03-02 10:02:50 -08: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 early-alpha, if you have questions or feedback please Join our discussion forum. We would love to hear from you.

Once out of alpha the companion Android application will be released here:

But if you want the bleeding edge app now, we'd love to have your help testing. Three steps to opt-in to the alpha- test:

Join this Google group with the account you use in Google Play.
Go to this URL to opt-in to the alpha test.
If you encounter any problems or have questions, post in our gitter chat and we'll help.

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

Build instructions

These build instructions are brief and should be improved, please send a PR if you can.

Use Android Studio 4.0 RC 1 to build/debug (other versions might work but no promises)
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/mapbox-token.xml
        cp ./app/special/mapbox-token.xml ./app/src/main/res/values/
        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.

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.
@Eugene: Contributed Russian translation.
@Konradrundfunk: Contributed German fixes.
@Mango-sauce: Contributed Chinese translation.
@NEKLAN: Contributed Japanese translation.
@Ohcdh: Contributed Irish and Italian translations.