An Android app for recording hypertension-related data.
An Android app for recording blood pressure measurements.
The application currently requires JDK 17 to build. If you already have JDK 17 installed, skip this step.
Check if the right JDK is already available
Run the command java -version
. If you have the right version of the JDK installed, you should see something like:
openjdk 17.0.7 2023-04-18 LTS
OpenJDK Runtime Environment Zulu17.42+19-CA (build 17.0.7+7-LTS)
OpenJDK 64-Bit Server VM Zulu17.42+19-CA (build 17.0.7+7-LTS, mixed mode, sharing)
If this command has an error, or shows a different version, you can follow the instructions below to install the JDK.
Install the JDK
We recommend using jEnv to manage your JDK installations. Here are instructions to setup a working JDK 17 installation (macOS only):
Setup up Homebrew.
Install jEnv
using Homebrew.
brew install jenv
~/.bash_profile
if you're using bash, or ~/.zshrc
if you're using zsh).export PATH="$HOME/.jenv/bin:$PATH"
eval "$(jenv init -)"
jenv
command to be recognised.source <path to shell configuration file>
brew tap mdogan/zulu
brew install zulu-jdk17
jEnv
jenv add /Library/Java/JavaVirtualMachines/zulu-17.jdk/Contents/Home/
jenv versions
. You should see something like: system
* 17.0
17.0.7
zulu64-17.0.7
Clone the project using git.
Run the following command in a terminal.
$ git clone [email protected]:simpledotorg/simple-android.git
Install Android Studio
Download and install Android Studio from their website.
Import the project into Android Studio.
When Android Studio starts up, it will prompt you to create a new project or import an existing project. Select the option to import an existing
project, navigate to the simple-android
directory you cloned earlier, and select it.
When building for the first time, gradle will download all dependencies so it'll take a few minutes to complete. Subsequent builds will be faster.
If during the build process you see the message: "Warning: License for package Android SDK Build-Tools 30.0.2 not accepted." Then you may need to install the Google Play Licensing Library:
The Simple App can be run locally on an Android emulator using Android Studio. To do this,
Install the NDK library
The NDK library is currently required by the project to enable an SQLite extension. To install it:
NDK will now be installed.
Create a Run/Debug configuration
Android App
templateapp
, and finish creating the configurationCreate a virtual device
Set the right build variant
qaDebug
Run the app
The code styles which the project uses have been exported as an IntelliJ code style XML file and are saved as
quality/code-style.xml
. To import them into Android Studio,
<project>/quality/code-style.xml
.Simple
scheme into the IDE and set it as the project code style.An Android Studio plugin that provides some quality of life improvements like live templates can be found HERE.
There are currently 2 ways to build an app pointing to different environments:
qa
API URL in gradle.properties
file to point to the environment you want. These builds will be debuggable and require us to clone
the project and build it using Android Studio. [*
Warning*: These changes should not be commited back to master
branch]build-debuggable-sandbox-apk
.Simple Server is in a separate repository, and you should follow the instructions there.
You can use Flipper to run SQL queries on Simple:
brew install Flipper
red-db
and choose whichever table’s data you want to inspect.Check out the following documents for more information.