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

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

Подключите свое приложение

Многие приложения имеют собственный процесс адаптации, например обучение функциям или запрос согласия пользователя. Разработчикам настоятельно рекомендуется экспортировать действие, которое 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.ACTION_SHOW_ONBOARDING" />
  </intent-filter>
</activity-alias>

Обратите внимание, что поддержка этой функции для Android 14 пока недоступна, но появится в ближайшее время.

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

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

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

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