다음 안내에 따라 사용자를 앱에 온보딩하는 것이 좋습니다.
앱 온보딩
많은 앱에는 기능 교육 또는 사용자 동의 요청과 같은 맞춤 온보딩 흐름이 있습니다. 개발자는 사용자가 처음 앱과 상호작용할 때 헬스 커넥트가 시작하는 온보딩 활동을 내보내는 것이 좋습니다. 이를 위해 매니페스트에 다음을 추가하세요.
<!-- Required to support pre-Android 14 devices with APK Health Connect -->
<activity
android:name=".OnboardingActivity"
android:exported="true"
android:permission="com.google.android.apps.healthdata.permission.START_ONBOARDING"
<intent-filter>
<action android:name="androidx.health.ACTION_SHOW_ONBOARDING"/>
</intent-filter>
</activity>
<!-- Required to support Android 14+ devices with platform Health Connect -->
<activity-alias
android:name="UAndAboveOnboardingActivity"
android:exported="true"
android:targetActivity=".OnboardingActivity"
android:permission="android.permission.health.START_ONBOARDING">
<intent-filter>
<action android:name="android.health.connect.action.ACTION_SHOW_ONBOARDING" />
</intent-filter>
</activity-alias>
이 기능 지원은 Android 14에서 아직 사용할 수 없지만 곧 지원될 예정입니다.
사용자가 앱을 헬스 커넥트에 연결하려고 하면 내보낸 활동이 실행됩니다. 이 활동은 다음 작업을 실행해야 합니다.
- 쓰거나 읽은 데이터를 설명하는 등 관련 사용자 교육을 표시합니다.
- 필요한 경우 사용자에게 동의를 요청합니다.
- 헬스 커넥트에 권한을 요청합니다.
- 주기적 worker를 예약하는 등 기타 애플리케이션별 로직을 실행합니다.
- 완료되면 사용자가 활동을 닫을 수 있도록 합니다.
온보딩 활동을 내보내지 않는 앱의 경우 헬스 커넥트는 사용자가 앱을 연결하려고 하면 사용자를 대신 권한 관리 화면으로 안내합니다. 통합이 작동하기 위해 권한이 부여되기만 하면 되는 앱에는 이 방식이 적합할 수 있습니다.
온보딩 활동은 두 번 이상 실행될 수 있습니다(예: 사용자가 나중에 앱에 대한 권한을 취소한 후 다시 연결하는 경우).