Small fixees

This commit is contained in:
apt105 2021-05-26 23:17:36 +01:00
parent 4b100951c2
commit 445d4536ae
3 changed files with 17 additions and 17 deletions

View file

@ -4,16 +4,13 @@ title: Creating a build/development environment for the Android App
sidebar_label: Building Android App
---
## 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.
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 4.1.2 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:
* 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
@ -24,21 +21,22 @@ Run the following commands to do so:
cp ./app/special/curfirmwareversion.xml ./app/src/main/res/values/
```
* (unfortunately) you need to get a (free) mapbox developer token [here](https://docs.mapbox.com/android/maps/guides/install/) and put that token in your user gradle.properties.
* (Unfortunately) you need to get a (free) mapbox developer token [here](https://docs.mapbox.com/android/maps/guides/install/) and put that token in your user gradle.properties.
```
~/development/meshtastic/MeshUtil$ cat ~/.gradle/gradle.properties
MAPBOX_DOWNLOADS_TOKEN=sk.yourtokenherexxx
```
* 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.
* Now you should be able to select "Run / Run" in the IDE and it will happily start running on your phoneor 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
* Analytics are included but can be disabled by the user on the settings screen
* On dev devices
```shell
adb shell setprop debug.firebase.analytics.app com.geeksville.mesh
@ -52,4 +50,4 @@ adb shell setprop log.tag.FA VERBOSE
## Publishing to google play
(Only supported if you are a core developer that needs to do releases)
* Only supported if you are a core developer that needs to do releases

View file

@ -22,4 +22,6 @@ This project uses the simple PlatformIO build system. PlatformIO is an extension
10. The hardware can be configured for different countries by adding a definition to the `configuration.h` file. `#define HW_VERSION_US` or `HW_VERSION_EU433, HW_VERSION_EU865, HW_VERSION_CN, HW_VERSION_JP`. Other country settings can be found in `MeshRadio.h`. The default is `HW_VERSION_US`.
11. Click the PlatformIO icon on the side bar. Under `Project Tasks` you can now build or upload.
Note - To get a clean build you may have to delete the auto-generated file `./.vscode/c_cpp_properties.json`, close and re-open Visual Studio and WAIT until the file is auto-generated before compiling again.
:::note
To get a clean build you may have to delete the auto-generated file `./.vscode/c_cpp_properties.json`, close and re-open Visual Studio and WAIT until the file is auto-generated before compiling again.
:::

View file

@ -19,10 +19,10 @@ After that you will be added to the waiting list and will be contacted when you
![On the Codespaces waiting list](/img/codespaces/codespaces-waitinglist-sm.png)
Once you have been granted access, go to the project you wish to develop (for example the [Meshtastic device code](https://github.com/meshtastic/Meshtastic-device) or the [backend server code](https://github.com/meshtastic/meshtastic-backend)) and click the button in the upper right that says "Fork". It will ask you to confirm, then GitHub will generate your "fork" of the master code.
<!--add images for this section once I have access to Codespaces-->
Browse to your fork of the code and in the upper right of the window click on the "Code" dropdown button, then click "Open with Codespaces"
<!--add images for this section once I have access to Codespaces-->
Browse to your fork of the code and in the upper right of the window click on the "Code" dropdown button, then click "Open with Codespaces".
Github will then create a new virtual machine for you. This will take a few minutes the first time it is created as it installs Platformio and other dependancies.
You can now edit code and click to build and run just like you are on your own machine.
<!--add examples of usage-->
<!--add examples of usage-->