Android 빌드

도구와 모듈

프로젝트의 wrapper와 버전 카탈로그를 사용합니다. Java 소스 호환성 값과 빌드에 사용하는 Gradle JDK 설정을 혼동하지 않도록 Android Studio의 Gradle 실행 환경도 확인하세요.

빌드 전 준비

1. Android SDK 36과 프로젝트에 맞는 Gradle JDK 환경을 준비합니다.
2. 로컬 sdk.dir 등 개발 환경 설정을 구성합니다. 연구 서버의 설정·서비스 파일은 연구팀이 제공한 값을 사용합니다.
3. 삼성헬스 모듈이 참조하는 libs/samsung-health-data-api-1.0.0.aar를 확인합니다.
4. 연구용 UI·설문·수집·알림·저장 모드 자산이 서로 일치하는지 확인합니다.
5. debug 서명은 현재 사용자 홈의 .android/debug.keystore를 참조합니다. 다른 서명으로 변경하면 삼성헬스 앱 검증 조건에도 영향을 줄 수 있습니다.

기본 명령

저장소 루트에서 실행합니다. 아래는 실행 안내이며, 이번 문서 작성에서 Android 빌드를 새로 검증했다는 의미는 아닙니다.

./gradlew :app:assembleDebug

연결된 기기에 설치하려면 기기의 개발자 옵션과 USB 디버깅을 준비한 뒤 사용합니다.

./gradlew :app:installDebug

APK와 SDK의 차이

Android 앱 APK 빌드 성공은 외부 앱용 SDK 배포 성공과 다릅니다. 삼성 원본 AAR을 포함한 라이브러리 패키징에는 추가 제약이 있습니다. SDK 연동 계획의 현재 검토 결과를 확인하세요.

검증 범위

앱 실행 후 연구 등록, 권한, 설문 제출, 센서·건강 데이터 저장, 서버 전송을 확인합니다. release/R8와 실제 기기·백그라운드 수집 검증은 debug 컴파일 결과와 별도로 기록해야 합니다.