Kullanıcıları uygulamanıza kabul etmek için aşağıdaki kılavuzu incelemenizi öneririz.
Uygulamanıza ilk katılım
Birçok uygulamanın, özellik eğitimi veya kullanıcıdan izin isteme gibi özel bir ilk katılım akışı vardır. Geliştiricilerin, kullanıcı uygulamayla ilk kez etkileşimde bulunduğunda Health Connect'ten başlattığı bir ilk katılım etkinliğini dışa aktarmaları önemle tavsiye edilir. Bunu yapmak için manifest dosyanıza aşağıdakileri ekleyin:
<!-- 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>
Bu özellik için henüz Android 14'te destek sunulmadığını ancak yakında sunulacağını lütfen unutmayın.
Bir kullanıcı, uygulamanızı Health Connect'e bağlamaya çalıştığında dışa aktarılan etkinlik başlatılır. Bu etkinlik şunları gerçekleştirmelidir:
- Hangi verilerin yazıldığını veya okunduğunu açıklamak gibi alakalı kullanıcı eğitimlerini görüntüleyin.
- Gerekirse kullanıcıdan izin vermesini isteyin.
- Health Connect için izin isteğinde bulunun.
- Periyodik çalışma planlaması gibi uygulamaya özel diğer mantıkları yürütün.
- İşlem tamamlandığında, kullanıcının etkinliği kapatmasına izin verin.
Health Connect, ilk katılım etkinliğini dışa aktarmayan uygulamalarda, kullanıcı uygulamayı bağlamaya çalıştığında kullanıcıyı İzinleri yönet ekranına getirir. Entegrasyonun çalışması için tek ön koşul izin verilen uygulamalarda bu durum kabul edilebilir.
İlk katılım etkinliğinin birden fazla kez başlatılabileceğini (örneğin, kullanıcı daha sonra uygulamanızın izinlerini iptal edip yeniden bağlarsa) unutmayın.