사용자 온보딩 계획

많은 앱에는 기능 교육 또는 사용자 동의 요청과 같은 맞춤 온보딩 흐름이 있습니다. 헬스 커넥트에서 온보딩 흐름을 실행하도록 하려면 매니페스트에 다음을 추가합니다.

<!-- 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.SHOW_ONBOARDING" />
  </intent-filter>
</activity-alias>

사용자는 앱 내에서가 아니라 헬스 커넥트 앱에서 직접 앱에 대한 연결을 시작할 수 있습니다. 앱에 데이터 읽기 또는 쓰기 권한 부여 외의 추가 상호작용이 필요한 경우 온보딩 활동을 제공하세요.

버전 지원

Android 14 이전 기기와 Android 14 이상 기기를 모두 지원하려면 다음을 실행하세요.

  • 권장 접근 방식: 두 시나리오를 모두 처리하는 단일 온보딩 활동을 만듭니다. 예와 같이 활동 별칭을 사용하여 Android 버전 간의 호환성을 확인합니다.

  • 대체 접근 방식: Android 버전별로 하나씩 두 개의 별도 활동을 내보냅니다. 이 접근 방식은 유지보수 복잡성을 증가시킬 수 있습니다.

내보낸 활동 요구사항

사용자가 앱을 헬스 커넥트에 연결하려고 하면 내보낸 활동이 실행됩니다. 이 활동은 다음 작업을 실행해야 합니다.

  • 쓰거나 읽은 데이터를 설명하는 등 관련 사용자 교육을 표시합니다.
  • 필요한 경우 사용자에게 동의를 요청합니다.
  • 헬스 커넥트에 권한을 요청합니다.
  • 주기적 worker를 예약하는 등 기타 애플리케이션별 로직을 실행합니다.
  • 완료되면 사용자가 활동을 닫을 수 있도록 합니다.

온보딩 활동을 내보내지 않는 앱의 경우 헬스 커넥트는 사용자가 앱을 연결하려고 하면 사용자를 대신 권한 관리 화면으로 안내합니다. 통합이 작동하기 위해 권한이 부여되기만 하면 되는 앱에는 이 방식이 적합할 수 있습니다.

온보딩 활동은 두 번 이상 실행될 수 있습니다(예: 사용자가 나중에 앱에 대한 권한을 취소한 후 다시 연결하는 경우).