Android'i kullanmaya başlama

Bir Google Hesabı edinin

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

Google Play hizmetlerini edinin

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

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

OAuth 2.0 istemci kimliği edinme

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

Projenizi oluşturma ve yapılandırma

Fitness API ile uygulama oluşturmak için Android Studio geliştirme ortamını kullanmanızı öneririz. Yeni bir proje oluşturma ve Android Studio'da yapılandırma hakkında 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.3.0")
        implementation("com.google.android.gms:play-services-auth:21.4.0")
}

apply plugin: 'com.android.application'

...

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

Bu sayede Gradle, uygulamanızı oluştururken Fitness SDK'sını otomatik olarak indirir.

Gerekli Android izinlerini alma

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

OAuth izinlerini alma

Uygulamanızın erişim izni olan veri türleri, yetkilendirme kapsamlarına karşılık gelir. Bu izinleri istemek için uygulamanızın hangi veri türlerine erişmesi gerektiğini bir FitnessOptions örneğine eklemeniz gerekir. Uygulamanız Google Fit veri türlerinden herhangi birini kullanmak istediğinde Android SDK, bu veri türlerinin 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 eşlik eden cihazlardaki donanım sensörlerinden gelen farklı sağlık ve zindelik verisi kaynaklarına erişin.
• RecordingClient: Sensör verilerinin düşük güçle, her zaman açık şekilde arka planda toplanması için.
• HistoryClient: Google Fit'te geçmiş verileri ekleme, silme ve okuma.
• SessionsClient: Kullanıcı etkinliğinin oturumlarını oluşturma ve yönetme.
• 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şin.

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

Sonuçta ortaya çıkan kullanıcı yetkilendirme akışı

Aşağıda, kullanıcılardan izin istendiğinde ortaya çıkan 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 ihtiyaç duyduğu çalışma zamanı izinlerini ister ve kullanıcılar bu izinleri verir veya reddeder.
2. Kontrol etme ve bağlanma: 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 kapsamlar dahilindeki veri türlerine erişebilir.