Birçok uygulama, kullanıcıyı uygulama özellikleri hakkında bilgilendirme veya kullanıcı izni isteme gibi iş akışları için özel bir ilk katılım akışına sahiptir. Uygulamanız, sorunsuz bir bağlantı akışı oluşturmak için Matchmaking API'yi kullanarak kullanıcılardan, uygulamanızın okumak üzere yapılandırıldığı verileri yazabilen diğer uygulamaları bağlamalarını isteyebilir.
Özel bir ilk katılım akışı eklemek için Health Connect'i, izinler verildikten sonra akışı otomatik olarak başlatacak şekilde yapılandırın. Ancak Matchmaking API'nin bu tetikleyiciyi desteklemediğini unutmayın. 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.SHOW_ONBOARDING" />
</intent-filter>
</activity-alias>
Kullanıcılar, uygulamanıza bağlantıyı doğrudan uygulamanızdan değil, Health Connect uygulamasından başlatabilir.
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 işleyen 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 ayrı ayrı olmak üzere iki 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ğlamaya çalıştığında 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 ilgili kullanıcı eğitimlerini gösterin.
- Gerekirse kullanıcıdan izin vermesini isteyin.
- Health Connect'e izin isteği gönderin.
- Periyodik bir çalışan planlama gibi uygulamaya özel başka bir mantık yürütün.
- İşlem tamamlandıktan sonra kullanıcının etkinliği kapatmasına izin verin.
Bir tanıtım etkinliğini dışa aktarmayan uygulamalarda Health Connect, kullanıcı uygulamayı bağlamaya çalıştığında kullanıcıyı izinleri yönetme ekranına yönlendirir. Bu, entegrasyonun çalışması için izin verilmesinin tek ön koşul 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ızın izinlerini iptal edip uygulamayı yeniden bağlarsa bu durum yaşanabilir.