İlk katılım aşamasındaki kullanıcıları planlayın
Koleksiyonlar ile düzeninizi koruyun
İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.
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.
Bu sayfadaki içerik ve kod örnekleri, İçerik Lisansı sayfasında açıklanan lisanslara tabidir. Java ve OpenJDK, Oracle ve/veya satış ortaklarının tescilli ticari markasıdır.
Son güncelleme tarihi: 2025-07-27 UTC.
[[["Anlaması kolay","easyToUnderstand","thumb-up"],["Sorunumu çözdü","solvedMyProblem","thumb-up"],["Diğer","otherUp","thumb-up"]],[["İhtiyacım olan bilgiler yok","missingTheInformationINeed","thumb-down"],["Çok karmaşık / çok fazla adım var","tooComplicatedTooManySteps","thumb-down"],["Güncel değil","outOfDate","thumb-down"],["Çeviri sorunu","translationIssue","thumb-down"],["Örnek veya kod sorunu","samplesCodeIssue","thumb-down"],["Diğer","otherDown","thumb-down"]],["Son güncelleme tarihi: 2025-07-27 UTC."],[],[],null,["# Plan for onboarding users\n\nMany apps have a custom onboarding flow such as feature education or asking user\nconsent. To enable Health Connect to launch your onboarding flow, add the\nfollowing to your manifest: \n\n \u003c!-- Required to support pre-Android 14 devices with APK Health Connect --\u003e\n \u003cactivity\n android:name=\".OnboardingActivity\"\n android:exported=\"true\"\n android:permission=\"com.google.android.apps.healthdata.permission.START_ONBOARDING\"\u003e\n \u003cintent-filter\u003e\n \u003caction android:name=\"androidx.health.ACTION_SHOW_ONBOARDING\"/\u003e\n \u003c/intent-filter\u003e\n \u003c/activity\u003e\n \u003c!-- Required to support Android 14+ devices with platform Health Connect --\u003e\n \u003cactivity-alias\n android:name=\"UAndAboveOnboardingActivity\"\n android:exported=\"true\"\n android:targetActivity=\".OnboardingActivity\"\n android:permission=\"android.permission.health.START_ONBOARDING\"\u003e\n \u003cintent-filter\u003e\n \u003caction android:name=\"android.health.connect.action.SHOW_ONBOARDING\" /\u003e\n \u003c/intent-filter\u003e\n \u003c/activity-alias\u003e\n\nUsers may initiate the connection to your app directly from the Health\nConnect app, rather than from within your app. If your app requires any\nadditional interaction beyond being granted permission to read or write data,\nprovide an onboarding activity.\n\nVersion support\n---------------\n\nTo support both pre-Android 14 and Android 14+ devices:\n\n- **Recommended approach:** Create a single onboarding activity that handles\n both scenarios. Use an activity alias, as shown in the example,to verify\n compatibility across Android versions.\n\n- **Alternative approach:** Export two separate activities,\n one for each Android version. This approach may lead to increased maintenance\n complexity.\n\nExported activity requirements\n------------------------------\n\nWhen a user attempts to connect your app to Health Connect, the exported\nactivity is launched. This activity must do the following:\n\n- Display any relevant user education such as explaining what data is written or read.\n- Ask the user to grant consent if required.\n- Make a permissions request to Health Connect.\n- Carry out any other application specific logic such as scheduling a periodic worker.\n- Once complete, allow the user to dismiss the activity.\n\nFor apps that *don't* export an onboarding activity, Health Connect instead\nbrings the user to the **Manage permissions** screen once the user attempts to\nconnect the app. This may be acceptable for apps where permissions being\ngranted is the only prerequisite for the integration to function.\n\nNote that the onboarding activity may be launched more than once, for example if\nthe user later revokes permissions to your app and then reconnects it."]]
