Birçok uygulamada, özellik eğitimi veya kullanıcı izni isteme gibi özel bir ilk katılım akışı bulunur. Health Connect'in ilk katılım akışınızı başlatmasını sağlamak 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.SHOW_ONBOARDING" />
</intent-filter>
</activity-alias>
Kullanıcılar, uygulamanıza bağlantıyı uygulamanızdan değil doğrudan Health Connect uygulamasından başlatabilir. Uygulamanız, veri okuma veya yazma izninin verilmesinin ötesinde ek etkileşim gerektiriyorsa ilk katılım etkinliği sağlayın.
Sürüm desteği
Hem Android 14 öncesi hem de Android 14 ve sonraki sürümlere sahip cihazları desteklemek için:
Önerilen yaklaşım: Her iki senaryoyu da ele alan tek bir ilk katılım etkinliği oluşturun. Android sürümleri arasındaki uyumluluğu doğrulamak için örnekte gösterildiği gibi bir etkinlik takma adı kullanın.
Alternatif yaklaşım: Her Android sürümü için bir tane olmak üzere iki ayrı etkinlik dışa aktarın. Bu yaklaşım, bakım karmaşıklığının artmasına neden olabilir.
Dışa aktarılan etkinlik koşulları
Bir kullanıcı uygulamanızı Health Connect'e bağlamayı denediğinde dışa aktarılan etkinlik başlatılır. Bu etkinlik aşağıdakileri yapmalıdır:
- Hangi verilerin yazıldığı veya okunduğu gibi alakalı kullanıcı eğitimlerini gösterin.
- Gerekirse kullanıcıdan izin vermesini isteyin.
- Health Connect'e izin isteği gönderin.
- Düzenli bir işleyici planlama gibi uygulamaya özgü diğer mantık işlemlerini gerçekleştirin.
- İşlem tamamlandığında kullanıcının etkinliği kapatmasına izin verin.
İlk katılım etkinliği dışa aktarmayan uygulamalarda Health Connect, kullanıcı uygulamayı bağlamaya çalıştığında kullanıcıyı İzinleri yönet ekranına yönlendirir. Bu, entegrasyonun çalışması için tek ön koşulun izin verilmesi olduğu uygulamalarda kabul edilebilir.
İlk katılım etkinliğinin birden fazla kez başlatılabileceğini unutmayın. Örneğin, kullanıcı daha sonra uygulamanıza yönelik izinleri iptal edip yeniden bağlarsa.