Memulai di Android

Panduan ini menjelaskan cara memulai pengembangan dengan Google Fit di Android.

Penyiapan

Sebelum Anda mulai membangun aplikasi, selesaikan langkah-langkah berikut bagian.

Untuk menggunakan Google Fit API, Anda memerlukan Akun Google. Anda dapat membuat akun baru atau menggunakan akun yang sudah ada. Anda mungkin ingin membuat akun terpisah untuk menguji aplikasi Anda dari perspektif pengguna.

Dapatkan library klien terbaru untuk layanan Google Play terkait pengembangan Anda host:

  1. Buka Android SDK Manager.
  2. Di bagian SDK Tools, temukan layanan Google Play.
  3. Jika status untuk paket ini bukan Terinstal, pilih keduanya dan klik Install Packages.

Untuk mengaktifkan Fitness API, dapatkan client ID OAuth 2.0.

Sebaiknya gunakan lingkungan pengembangan Android Studio untuk membuat aplikasi dengan Fitness API. Sebagai detail tentang cara membuat project baru dan mengonfigurasinya di Android Studio, lihat Buat project.

Di Android Studio, buka file build.gradle untuk modul Anda dan tambahkan library klien layanan Google Play sebagai dependensi:

DSL KotlinDSL Groovy
plugin {
    id("com.android.application")
}

...

dependencies {
        implementation("com.google.android.gms:play-services-fitness:21.2.0")
        implementation("com.google.android.gms:play-services-auth:21.3.0")
}
 
apply plugin: 'com.android.application'

...

dependencies {
    implementation 'com.google.android.gms:play-services-fitness:21.2.0'
    implementation 'com.google.android.gms:play-services-auth:21.3.0'
}

Hal ini memastikan Gradle akan otomatis mendownload SDK kebugaran saat SDK tersebut membangun aplikasi Anda.

Membangun dan menguji aplikasi

Setelah menyelesaikan langkah-langkah penyiapan, Anda dapat mulai membangun aplikasi. Untuk mendapatkan memulai, pelajari jenis data yang dapat disimpan dan disimpan oleh aplikasi Anda dibaca. Pelajari lebih lanjut cara bekerja dengan data di Google Fit.

Untuk membaca dan menulis beberapa jenis data, aplikasi Anda perlu meminta izin Android.

Jenis data yang izin aksesnya dimiliki aplikasi Anda cakupan otorisasi. Untuk bertanya untuk izin ini, Anda perlu menambahkan jenis data yang perlu diakses oleh aplikasi Anda di FitnessOptions instance Anda. Saat aplikasi meminta untuk menggunakan salah satu data Google Fit Android SDK otomatis memeriksa cakupan mana saja yang dimilikinya dan menanyakan pengguna untuk otorisasi atas cakupan tersebut.

Membuat klien API dan menambahkan jenis data yang perlu diakses oleh aplikasi Anda menulis atau membaca data. Tersedia endpoint berikut:

  • SensorsClient: Mengakses berbagai sumber data kesehatan dan kebugaran dari sensor hardware di perangkat lokal dan di perangkat pendamping.
  • RecordingClient: Untuk pengumpulan data sensor latar belakang yang selalu aktif dan berdaya rendah.
  • HistoryClient: Menyisipkan, menghapus, dan membaca data historis di Google Fit.
  • SessionsClient: Membuat dan mengelola Sesi aktivitas pengguna.
  • GoalsClient: Membaca sasaran Poin Jantung dan Langkah yang dibuat oleh pengguna di Google Fit.
  • ConfigClient: Mengakses jenis dan setelan data kustom di platform Google Fit.

Lihat contoh cara membuat klien Fitness API.

Berikut ini adalah hasil alur otorisasi yang dialami pengguna saat mereka dimintai izin:

Gambar 1.Alur otorisasi untuk pengguna.
  1. Izin Android: Pengguna melihat izin Android yang digunakan aplikasi Anda yang diminta sebelum mengunduhnya. Setelah diunduh, aplikasi meminta izin runtime apa pun yang diperlukan, dan pengguna memberikan atau menolak izin akses ini.
  2. Periksa dan hubungkan: Aplikasi Anda memeriksa apakah izin telah diberikan sebelum meminta akses ke jenis data lain.
  3. Permintaan cakupan OAuth: Google meminta pengguna untuk memberikan izin aplikasi Anda cakupan OAuth yang diperlukan untuk tipe data yang ingin diakses.
  4. Akses diterapkan: Setelah pengguna memberikan izin, aplikasi Anda dapat mengakses jenis data yang termasuk dalam cakupan yang telah diberikan pengguna izin akses.

Ajukan permohonan verifikasi

Setelah membuat dan menguji aplikasi, Anda perlu mengajukan permohonan verifikasi dengan alamat email tingkat pembenaran yang diperlukan untuk cakupan sensitif dan dibatasi.