Developer guides

Build the Android app

Tool versions and prerequisites from the current project.

Reviewed
On this page

Tools and modules

ItemCurrent setting
App module:app
Gradle wrapper9.3.1
Android Gradle Plugin9.1.0
Kotlin2.3.0
Java source/target compatibility17
Android SDKcompile/target 36, min 30
applicationIdcom.hdil.datacollection

Use the project's wrapper and version catalog. Java source compatibility and the Gradle JDK used by the build are distinct settings; check Android Studio's Gradle execution environment too.

Before building

  1. Prepare Android SDK 36 and a compatible Gradle JDK.
  2. Configure local development settings such as sdk.dir. Obtain research-server configuration and service files from the study team.
  3. Check the Samsung module's libs/samsung-health-data-api-1.0.0.aar dependency.
  4. Align the study's UI, survey, collection, notification, and storage-mode assets.
  5. The debug signing configuration references .android/debug.keystore in the user's home directory. Changing the signature can affect Samsung Health app verification.

Basic commands

Run from the repository root. These are build instructions, not a claim that a new Android build was validated during documentation work.

CODE
./gradlew :app:assembleDebug

To install on a connected device, enable its developer options and USB debugging first.

CODE
./gradlew :app:installDebug

App APK versus SDK artifact

A successful APK build does not establish that an external-app SDK can be distributed. Packaging a library with the original Samsung AAR has additional constraints. See the current assessment in the SDK integration plan.

Validation scope

After launch, verify enrollment, permissions, survey submission, local sensor/health records, and remote sync. Record release/R8, physical-device, and background collection validation separately from a debug compile result.

Documentation evidence

Working-tree baseline · source paths · HEAD 8213e6b7

  • app/build.gradle.kts
  • gradle/libs.versions.toml
  • gradle/wrapper/gradle-wrapper.properties
  • plugins/samsunghealth/build.gradle.kts
  • settings.gradle.kts
DTRAC AndroidYonsei University · Bongshin Lee’s research team