2021-05-25 14:12:57 -07:00
---
2022-11-02 15:26:47 -07:00
id: android
2022-11-03 17:10:08 -07:00
title: Building the Android App
2022-11-02 15:26:47 -07:00
sidebar_label: Android
2022-11-03 17:10:08 -07:00
sidebar_position: 1
2021-05-25 14:12:57 -07:00
---
## Build instructions
2022-03-08 23:10:41 -08:00
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.
2021-05-25 14:12:57 -07:00
2022-04-03 20:11:50 -07:00
- Use Android Studio to build/debug
2022-03-08 23:10:41 -08:00
- 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:
2022-11-03 17:10:08 -07:00
```sh
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/
2021-05-25 14:12:57 -07:00
```
2022-03-08 23:10:41 -08:00
- Now you should be able to select "Run / Run" in the IDE and it will happily start running on your phone or the emulator.
2021-05-25 14:12:57 -07:00
2021-05-26 15:17:36 -07:00
:::note
2021-12-27 11:39:42 -08:00
The emulators don't support Bluetooth, so some features can not be used in that environment.
2021-05-26 15:17:36 -07:00
:::
2021-05-25 14:12:57 -07:00
2021-05-26 15:17:36 -07:00
## Analytics setup
2021-05-25 14:12:57 -07:00
2022-03-08 23:10:41 -08:00
- Analytics are included but can be disabled by the user on the settings screen
- On dev devices
2021-05-25 14:12:57 -07:00
2022-11-03 17:10:08 -07:00
```sh
2021-05-25 14:12:57 -07:00
adb shell setprop debug.firebase.analytics.app com.geeksville.mesh
adb shell setprop log.tag.FirebaseCrashlytics DEBUG
```
for verbose logging:
2022-03-08 23:10:41 -08:00
2022-11-03 17:10:08 -07:00
```sh
2021-05-25 14:12:57 -07:00
adb shell setprop log.tag.FA VERBOSE
```
## Publishing to google play
2022-03-08 23:10:41 -08:00
- Only supported if you are a core developer that needs to do releases