Bu kılavuzda, Android'de Google Fit ile geliştirmeye nasıl başlayacağınız açıklanmaktadır.
Kurulum
Uygulamanızı oluşturmaya başlamadan önce aşağıdaki bölümlerdeki adımları tamamlayın.
Bir Google Hesabı edinin
Google Fit API'lerini kullanmak için bir Google Hesabınız olmalıdır. Yeni hesap oluşturabilir veya mevcut bir hesabı kullanabilirsiniz.
Google Play hizmetlerini edinin
Geliştirme ana makinenizde Google Play Hizmetleri için en yeni istemci kitaplığını edinin:
- Android SDK Yöneticisi'ni açın.
- SDK Tools (SDK Araçları) bölümünde Google Play Hizmetleri'ni bulun.
- Bu paketlerin durumu Yüklü değilse ikisini de seçip Paketleri Yükle'yi tıklayın.
OAuth 2.0 istemci kimliği alma
Fitness API'yi etkinleştirmek için OAuth 2.0 istemci kimliği alın.
Projenizi oluşturup yapılandırma
Fitness API ile uygulama oluşturmak için Android Studio geliştirme ortamını kullanmanızı öneririz. Android Studio'da yeni proje oluşturma ve yapılandırmaya dair ayrıntılı bilgi için Proje oluşturma başlıklı makaleyi inceleyin.
Google Play Hizmetleri istemci kitaplığını ekleme
Android Studio'da, modülünüzün build.gradle
dosyasını açın ve Google Play Hizmetleri istemci kitaplığını bağımlılık olarak ekleyin:
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' }
Bu sayede Gradle, uygulamanızı derlediğinde fitness SDK'sını otomatik olarak indirir.
Uygulamanızı derleyip test etme
Kurulum adımlarını tamamladıktan sonra uygulamanızı oluşturmaya başlayabilirsiniz. Başlamak için uygulamanızın depolayıp okuyabileceği veri türleri hakkında bilgi edinin. Google Fit'te verilerle çalışma hakkında daha fazla bilgi edinin.
Gerekli Android izinlerini alma
Bazı veri türlerini okuyup yazmak için uygulamanızın Android izinleri istemesi gerekir.
OAuth izinleri alma
Uygulamanızın erişme izni olan veri türleri yetkilendirme kapsamlarına karşılık gelir. Bu izinleri istemek için uygulamanızın erişmesi gereken veri türlerini bir FitnessOptions
örneğinde eklemeniz gerekir. Uygulamanız Google Fit veri türlerinden herhangi birini kullanmak istediğinde Android SDK'sı, bu verilerin hangi kapsamlara ait olduğunu otomatik olarak kontrol eder ve kullanıcıdan bu kapsamlar için yetkilendirme ister.
API istemcisi oluşturma
Bir API istemcisi oluşturun ve uygulamanızın veri yazmak veya okumak için erişmesi gereken veri türlerini ekleyin. Aşağıdaki uç noktalar kullanılabilir:
-
SensorsClient
: Yerel cihazdaki ve tamamlayıcı cihazlardaki donanım sensörlerinden farklı sağlık ve sağlıklı yaşam verisi kaynaklarına erişme -
RecordingClient
: Düşük güç tüketimi ve her zaman açık arka planda sensör verisi toplama için. -
HistoryClient
: Google Fit'e geçmiş verileri ekleme, silme ve okuma -
SessionsClient
: Kullanıcı etkinliği oturumları oluşturun ve yönetin. -
GoalsClient
: Google Fit'te kullanıcılar tarafından oluşturulan kalp puanı ve adım hedeflerini okuyun. -
ConfigClient
: Google Fit platformundaki özel veri türlerine ve ayarlara erişme
Fitness API istemcisinin nasıl oluşturulacağına dair bir örneğe bakın.
Sonuçta ortaya çıkan kullanıcı yetkilendirme akışı
Aşağıda, kullanıcılardan izin istendiğinde ortaya çıkan yetkilendirme akışı gösterilmektedir:

- Android izinleri: Kullanıcılar, uygulamanızı indirmeden önce uygulamanızın istediği Android izinlerini görür. Uygulamanız indirildikten sonra ihtiyaç duyduğu tüm çalışma zamanında izinleri ister ve kullanıcılar bu izinleri verir veya reddeder.
- Kontrol et ve bağlan: Uygulamanız, diğer veri türlerine erişim isteğinde bulunmadan önce izinlerin verilip verilmediğini kontrol eder.
- OAuth kapsamları isteği: Google, kullanıcıdan uygulamanıza erişmek istediği veri türleri için gereken OAuth kapsamlarını vermesini ister.
- Erişim uygulandı: Kullanıcı izin verdikten sonra uygulamanız, kullanıcının izin verdiği kapsamlara ait veri türlerine erişebilir.
Doğrulama başvurusu yapma
Uygulamanızı oluşturup test ettikten sonra, hassas ve kısıtlanmış kapsamlar için gereken farklı gerekçelendirme düzeyleriyle doğrulama için başvurmanız gerekir.