OpenSensorHub Android Build Guide
Build
- Building the latest version of the OSH App tested with Gradle v7 and Android Studio Giraffe v2022.3.1
- Open the directory where the project is located
- cd
Prerequisites
- OSH Android GitHub Repository
- OSH Node GitHub Repository
- Java v17+
- Git
- Gradle v7.2
- Android Studio
- macOS, Windows, and Linux are supported.
- Android Device v13 with Developer Options enabled
Setup
git clone --recursive https://github.com/opensensorhub/osh-android.git
cd osh-android
git checkout connected-systems
git submodule update --init --recursive
Verify Submodules
There are two ways to verify the status of your submodules, either through the command line or inside the project IDE.
Using the command line, you can use the following command:
git submodule status
If successful, you should see the status of both submodules osh-addons
and osh-core
.
Branches
For the project to build properly, we need to ensure we are checking out the correct branches in each project. Here are the following suggested branches to ensure the build process runs smoothly.
For osh-android:
- osh-core :
Master
orcon-sys-android
- osh-addons:
Master
- lib-ogc:
Master
- project :
Master
Build OSH Android App
- open the terminal to the Android project directory
- Run these two commands
cd osh-android/sensorhub-android-app
../gradlew build