Android'i kullanmaya başlama

Bir Google Hesabı edinin

Google Fit API'larını kullanmak için bir Google Hesabınızın olması gerekir. Yeni bir hesap oluşturabilir veya mevcut bir hesabı kullanabilirsiniz. Uygulamanızı bir kullanıcının bakış açısından test etmek için ayrı bir hesap oluşturmak isteyebilirsiniz.

Google Play hizmetlerini yükle

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

1. Android SDK Yöneticisi'ni açın.
2. SDK Araçları'nın altında Google Play Hizmetleri'ni bulun.
3. Bu paketlerin durumu Yüklü değilse her ikisini de seçin ve Paketleri Yükle'yi tıklayın.

OAuth 2.0 istemci kimliği alın

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

Projenizi oluşturun ve yapılandırın

Fitness API ile uygulama oluşturmak için Android Studio geliştirme ortamını kullanmanızı öneririz. Yeni bir proje oluşturma ve bunu Android Studio'da yapılandırmayla ilgili ayrıntılar için Proje oluşturma bölümüne bakın.

Google Play Hizmetleri istemci kitaplığını ekleme

Android Studio'da modülünüz için 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.2.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.2.0'
}

Böylece, uygulamanızı oluştururken Gradle'ın fitness SDK'sını otomatik olarak indirmesi sağlanır.

Gerekli Android izinlerini alın

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

OAuth izinlerini alma

Uygulamanızın erişim iznine sahip olduğu veri türleri, yetkilendirme kapsamlarına karşılık gelir. Bu izinleri istemek için bir FitnessOptions örneğinde uygulamanızın hangi veri türlerine erişmesi gerektiğini eklemeniz gerekir. Uygulamanız Google Fit veri türlerinden herhangi birini kullanmak istediğinde, Android SDK 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şebilirsiniz.
• RecordingClient: Sensör verilerinin düşük güçle, her zaman açık arka planda toplanması için kullanılır.
• HistoryClient: Google Fit'e geçmiş verileri ekleme, silme ve okuma.
• SessionsClient: Kullanıcı etkinliği Oturumlarını oluşturun ve yönetin.
• GoalsClient: Google Fit'teki kullanıcılar tarafından oluşturulan Kardiyo Puanı ve Adım hedeflerini okur.
• ConfigClient: Google Fit platformunda özel veri türlerine ve ayarlara erişebilirsiniz.

Fitness API istemcisi oluşturma örneğini inceleyin.

Elde edilen kullanıcı yetkilendirme akışı

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

1. Android izinleri: Kullanıcılar, uygulamanızı indirmeden önce uygulamanızın istediği Android izinlerini görür. Uygulamanız indirildikten sonra, gereken çalışma zamanı izinlerini 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 istemeden ö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.