DTRAC실행 환경
현재 앱 모듈은 Android 11 이상(minSdk 30)을 대상으로 하며, compileSdk와 targetSdk는 36입니다. 연구팀이 제공하는 해당 연구용 앱을 사용하세요. 이 저장소에서 공통 공개 앱스토어 다운로드 주소는 확인되지 않았습니다.
삼성헬스 데이터를 읽으려면 휴대폰에 Samsung Health가 설치되어 있고 읽을 기록이 있어야 합니다. Health Connect를 사용하는 연구는 제공 앱의 데이터 공유와 DTRAC의 항목별 읽기 권한을 함께 확인합니다.
연구를 시작하는 순서
- 연구용 앱의 이름·버전과 참여 기기가 연구 설정에 맞는지 확인합니다.
- 연구에서 사용하는 참여자 등록 절차를 완료합니다.
studyId와participantId는 데이터 귀속과 서버 전송에 사용됩니다. - 권한과 백그라운드 설정을 확인합니다.
- 설문 1회 제출과 필요한 센서·건강 기록의 저장을 점검합니다.
- 서버 저장을 사용하는 연구는 로컬 기록이 실제 서버에 반영되는지 확인합니다.
현재 ui/index.json의 시작 화면은 home이며, 연구마다 화면 구성과 등록 절차가 달라질 수 있습니다. 발표자료의 화면은 모든 연구에 동일하게 적용되는 기본 화면이 아닙니다.
무엇을 설정하나요?
| 설정 | Android에서 읽는 위치 | 역할 |
|---|---|---|
| 플러그인·수집 항목 | manifests/plugins/registry.json | 활성 여부, 유형, 소스 우선순위, allowlist |
| 문항·설문 일정 | 설문 모듈의 survey.json | 질문, 선택지, 응답 기한, 음성 정책 |
| 화면 | ui/index.json, ui/screens/*.json | 시작 화면, 화면 목록, UI 노드 |
| 알림 | manifests/notifications/config.json | 채널과 일정 설정 |
| 연구 런타임 설정 | study_config.json | 연구 식별자·기간·가용 구간·시간 기준 정책 |
| 서버 선택 | manifests/services/backend.json | Firebase/Supabase, 로컬 전용/서버 병행 저장 |
자산 위치는 APK 내부 기준입니다. 일부 파일은 연구용 빌드 과정에서 주입되므로 저장소 기본 자산과 설치된 앱의 설정이 다를 수 있습니다.
현재 기본 수집 범위
기준 registry는 sensor와 samsung_health를 허용합니다. 삼성헬스의 일반 자동 조회는 운동·수면·심박 3종으로 제한됩니다. health_connect는 기본 비활성이며 allowlist에도 없습니다. 개발자가 구성 파일의 이름만 보고 실제 동작을 판단하지 않도록 플러그인 확장의 실행 필터를 함께 확인하세요.