Banyak aplikasi memiliki alur orientasi kustom untuk alur kerja seperti mengedukasi pengguna tentang fitur aplikasi atau meminta izin pengguna. Untuk membuat alur koneksi yang lancar, aplikasi Anda juga dapat menggunakan Matchmaking API untuk meminta pengguna menghubungkan aplikasi lain yang dapat menulis data yang dikonfigurasi untuk dibaca oleh aplikasi Anda.
Untuk menyertakan alur orientasi kustom, konfigurasi Health Connect untuk meluncurkannya secara otomatis setelah izin diberikan. Namun, perhatikan bahwa Matchmaking API tidak mendukung pemicu ini. Untuk melakukannya, tambahkan kode berikut ke 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.SHOW_ONBOARDING" />
</intent-filter>
</activity-alias>
Pengguna dapat memulai koneksi ke aplikasi Anda langsung dari aplikasi Health Connect, bukan dari dalam aplikasi Anda.
Dukungan versi
Untuk mendukung perangkat sebelum Android 14 dan Android 14+:
Pendekatan yang direkomendasikan: Buat satu aktivitas orientasi yang menangani kedua skenario. Gunakan alias aktivitas, seperti yang ditunjukkan dalam contoh,untuk memverifikasi kompatibilitas di seluruh versi Android.
Pendekatan alternatif: Ekspor dua aktivitas terpisah, satu untuk setiap versi Android. Pendekatan ini dapat menyebabkan peningkatan kompleksitas pemeliharaan.
Persyaratan aktivitas yang diekspor
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.