Installing the App SDK

Follow these instructions to install, build, and verify the app SDK.

If you are installing the full stack, this installation requires successful prior completion of the backend system installation.

Prerequisites

I. Install OpenJDK 17

Set up and install OpenJDK 17 using the instructions at https://openjdk.org/install/.

II. Install Android Studio

Set up and install Android Studio on Windows, macOS, or Linux using the instructions at https://developer.android.com/studio.

III. Clone the Repository

Clone the app SDK repository (we recommend cloning into the same INSTALL_PATH as the backend-system so app-sdk and backend-system are at the same level)
```
git clone https://github.com/S-HealthStack/app-sdk.git
```

Build

IV. Prepare the Modules

cd app-sdk

Clean all modules.

(Mac users may need to run chmod +x gradlew and/or rm -rf /Users/<YOUR_ID>/.gradle/wrapper/dists/gradle-7.3.3-bin/ first)
```
./gradlew clean 
```

Build all modules

./gradlew build -x detekt -x lint

V. Create a Firebase Project

Follow the instructions at https://firebase.google.com/docs/android/setup to add a Firebase project to the Firebase account you created during backend system installation, and note that our app file name (to place the google-services.json file is kit.
```
applicationId = "healthstack.sample"
```

NOTE that you should download the resulting google-services.json file from firbase into app-sdk -> samples (as you'll notice there is no app folder as the firebase documentation suggests).

VI. Per App Configuration

After app creation, for each app you need to:

Register your app with your Firebase project by updating the \<repository\>*/app/google-service.json configuration file.
For full-stack implementations only, associate your app with the backend system and portal study.

Refer to Configuring the App Environment for details.

VII. Reference Documentation

Refer to our API reference and SDK reference documentation for details on all the backend API endpoints and SDK packages.

Essential Cookies

These cookies are essential as they enable you to move around the website. This category cannot be disabled.

Analytical/Performance Cookies

These cookies collect information about how you use our website. for example which pages you visit most often. All information these cookies collect is used to improve how the website works.

Functionality Cookies

These cookies allow our website to remember choices you make (such as your user name, language or the region your are in) and tailor the website to provide enhanced features and content for you.

Advertising Cookies

These cookies gather information about your browser habits. They remember that you've visited our website and share this information with other organizations such as advertisers.