SDK guidePlanned

Android SDK integration plan

Reusable foundations and work remaining before external app integration.

Reviewed
On this page

Current stage

Planned: A public unified SDK initialization API, distribution repository/version, and compatibility with an external host app have not been established as completed deliverables.

The September 17 presentation proposes a unified SDK for surveys, sensors, and health records. The repository's September 15 assessment identifies reusable modules, but does not conclude that copying three folders produces a distributable SDK.

Reusable foundations

AreaExisting foundationRemaining work
SurveysJSON models/loader, Compose screens, submission contractsSeparate participant, timing, notification, audio and storage wiring for a host
SensorsCollectors, foreground service, Room batch ingestionPublic configuration, start/stop and payload access; restart policy
Samsung HealthReads, permissions, mapping and ingestionOriginal SDK dependency delivery, app verification, read-range/failure contracts

Database, repository, store, registry, theme, and shared-renderer dependencies are connected to these modules. They are not documented as one completed independent AAR.

Historical build assessment

The September 15 assessment reports successful Debug AAR generation for survey and sensor. For Samsung Health, it distinguishes a passed compilation stage from failed AAR packaging. These are historical assessment results, not builds repeated during documentation work.

External-host integration, release/R8, and long-running physical-device collection remain separate validation steps. Building the Android app and distributing a library are different checks.

Decisions for a partner integration

  • Study/participant identifiers and configuration supplied by the host.
  • Ownership of permission requests, foreground services, and notifications.
  • Local-only versus server storage and audio-file retention.
  • Result contracts separating empty data from errors, missing provider apps, and denied access.
  • Explicit stop/reboot behavior and notification-ID collision avoidance.
  • Original Samsung SDK dependency delivery and partner app registration.

Suggested validation sequence

A small Kotlin Android host can connect one survey, one sensor, and one health record type, then verify storage, retries, and process restart. This documentation does not implement that SDK or sample host. It does not supply unconfirmed Maven coordinates or initialization API examples.

Documentation evidence

Working-tree baseline · source paths · HEAD 8213e6b7

  • docs/plans/2026-09-15-collection-sdk-feasibility.md
  • plugins/survey/build.gradle.kts
  • plugins/sensor/build.gradle.kts
  • plugins/samsunghealth/build.gradle.kts
  • app/src/main/java/com/hdil/datacollection/ingest/SurveyResponseSubmitterImpl.kt
  • plugins/sensor/src/main/java/com/hdil/datacollection/plugins/sensor/foreground/SensorForegroundService.kt

References

DTRAC SDKYonsei University · Bongshin Lee’s research team