Планируйте привлечение пользователей

Во многих приложениях есть собственный поток онбординга, такой как обучение функциям или запрос согласия пользователя. Чтобы разрешить Health Connect запустить ваш поток онбординга, добавьте в манифест следующее:

<!-- 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>

Пользователи могут инициировать подключение к вашему приложению напрямую из приложения Health Connect, а не из вашего приложения. Если ваше приложение требует дополнительного взаимодействия помимо предоставления разрешения на чтение или запись данных, предоставьте действие по подключению.

Поддержка версий

Для поддержки устройств с ОС Android 14 и более поздних версий:

  • Рекомендуемый подход: Создайте единую onboarding-активность, которая обрабатывает оба сценария. Используйте псевдоним активности, как показано в примере, чтобы проверить совместимость между версиями Android.

  • Альтернативный подход: экспорт двух отдельных действий, по одному для каждой версии Android. Такой подход может привести к увеличению сложности обслуживания.

Требования к экспортируемой деятельности

Когда пользователь пытается подключить ваше приложение к Health Connect, запускается экспортированная активность. Эта активность должна выполнять следующие действия:

  • Демонстрируйте любую соответствующую информацию для пользователей, например, объясняйте, какие данные записываются или считываются.
  • При необходимости попросите пользователя дать согласие.
  • Отправьте запрос на получение разрешений в Health Connect.
  • Выполнять любые другие специфические для приложения логические действия, например, планирование периодического работника.
  • После завершения разрешите пользователю закрыть действие.

Для приложений, которые не экспортируют активность онбординга, Health Connect вместо этого переносит пользователя на экран управления разрешениями, как только пользователь пытается подключить приложение. Это может быть приемлемо для приложений, где предоставление разрешений является единственным предварительным условием для функционирования интеграции.

Обратите внимание, что процесс регистрации может быть запущен несколько раз, например, если пользователь позднее отзовет разрешения на доступ к вашему приложению, а затем снова подключит его.