Android'i kullanmaya başlama

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.

Google Fit API'lerini kullanmak için bir Google Hesabınız olmalıdır. Yeni hesap oluşturabilir veya mevcut bir hesabı kullanabilirsiniz. Uygulamanızı kullanıcı açısından test etmek için ayrı bir hesap oluşturabilirsiniz.

Geliştirme ana makinenizde Google Play Hizmetleri için en yeni istemci kitaplığını edinin:

  1. Android SDK Yöneticisi'ni açın.
  2. SDK Tools (SDK Araçları) bölümünde Google Play Hizmetleri'ni bulun.
  3. Bu paketlerin durumu Yüklü değilse ikisini de seçip Paketleri Yükle'yi tıklayın.

Fitness API'yi etkinleştirmek için OAuth 2.0 istemci kimliği alın.

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.

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:

Kotlin DSLGroovy DSL
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.

Bazı veri türlerini okuyup yazmak için uygulamanızın Android izinleri istemesi gerekir.

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.

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.

Aşağıda, kullanıcılardan izin istendiğinde ortaya çıkan yetkilendirme akışı gösterilmektedir:

Şekil 1. Kullanıcılar için yetkilendirme akışı.
  1. 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.
  2. Kontrol et ve bağlan: Uygulamanız, diğer veri türlerine erişim isteğinde bulunmadan önce izinlerin verilip verilmediğini kontrol eder.
  3. 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.
  4. 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.