Многие приложения имеют настраиваемый процесс адаптации для таких задач, как ознакомление пользователя с функциями приложения или запрос согласия пользователя. Для создания бесперебойного процесса подключения ваше приложение также может использовать API Matchmaking , чтобы предлагать пользователям подключаться к другим приложениям, которые могут записывать данные, для чтения которых настроено ваше приложение.
Чтобы добавить пользовательский процесс адаптации, настройте Health Connect так, чтобы он запускался автоматически после предоставления разрешений. Однако имейте в виду, что API Matchmaking не поддерживает этот триггер. Для этого добавьте следующее в свой манифест:
<!-- 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, и устройств, выпущенных под управлением Android 14 и более поздних версий:
Рекомендуемый подход: Создайте единое интерактивное приложение для адаптации новых пользователей, которое будет обрабатывать оба сценария. Используйте псевдоним приложения, как показано в примере, чтобы проверить совместимость с различными версиями Android.
Альтернативный подход: экспортировать два отдельных действия, по одному для каждой версии Android. Такой подход может привести к увеличению сложности обслуживания.
Требования к экспортируемой деятельности
Когда пользователь пытается подключить ваше приложение к Health Connect, запускается экспортированная активность. Эта активность должна выполнять следующие действия:
- Отобразите любую соответствующую информацию для пользователей, например, объяснение того, какие данные записываются или считываются.
- При необходимости запросите у пользователя согласие.
- Отправьте запрос на предоставление разрешений в Health Connect.
- Выполните любые другие действия, специфичные для приложения, например, запланируйте периодическое выполнение задачи.
- После завершения предоставьте пользователю возможность закрыть это действие.
Для приложений, которые не экспортируют данные о процессе регистрации, Health Connect вместо этого переводит пользователя на экран «Управление разрешениями» после попытки подключения приложения. Это может быть приемлемо для приложений, где предоставление разрешений является единственным необходимым условием для работы интеграции.
Обратите внимание, что процесс регистрации может запускаться несколько раз, например, если пользователь впоследствии отзовет разрешения на использование вашего приложения, а затем восстановит к нему доступ.