Kami merekomendasikan panduan berikut untuk melakukan aktivasi pengguna ke aplikasi Anda.
Melakukan aktivasi aplikasi
Banyak aplikasi memiliki alur orientasi kustom seperti edukasi tentang fitur atau meminta izin pengguna. Developer sangat disarankan untuk mengekspor aktivitas orientasi yang diluncurkan Health Connect saat pengguna berinteraksi dengan aplikasi untuk pertama kalinya. Untuk melakukannya, tambahkan kode berikut dalam manifes Anda:
<!-- 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>
Perhatikan bahwa dukungan untuk fitur ini belum tersedia untuk Android 14, tetapi akan segera hadir.
Saat pengguna mencoba menghubungkan aplikasi Anda ke Health Connect, aktivitas yang diekspor akan diluncurkan. Aktivitas ini harus melakukan hal berikut:
- Menampilkan edukasi pengguna yang relevan seperti menjelaskan data yang ditulis atau dibaca.
- Meminta pengguna untuk memberikan izin jika diperlukan.
- Membuat permintaan izin ke Health Connect.
- Melakukan logika khusus aplikasi lainnya seperti menjadwalkan pekerja berkala.
- Setelah selesai, mengizinkan pengguna menutup aktivitas.
Untuk aplikasi yang tidak mengekspor aktivitas orientasi, Health Connect akan mengarahkan pengguna ke layar Kelola izin setelah pengguna mencoba menghubungkan aplikasi. Hal ini dapat diterima untuk aplikasi yang hanya membutuhkan izin yang diberikan sebagai satu-satunya prasyarat agar integrasi berfungsi.
Perhatikan bahwa aktivitas orientasi dapat diluncurkan lebih dari sekali, misalnya jika pengguna nantinya mencabut izin ke aplikasi Anda, lalu menghubungkannya kembali.