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
.idea
app
geeksville-androidlib@8ccbd0b688
gradle/wrapper
images
scripts
.gitignore
.gitmodules
LICENSE
README.md
TODO.md
build.gradle
debugging-android.md
gradle.properties
gradlew
gradlew.bat
settings.gradle

README.md

Meshtastic-Android

Android CI

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:

Download at https://play.google.com/store/apps/details?id=com.geeksville.mesh

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:

  1. Join this Google group with the account you use in Google Play.
  2. Go to this URL to opt-in to the alpha test.
  3. 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.

Copyright 2019, Geeksville Industries, LLC. GPL V3 license