Android kullanmaya başlayın

Bu kılavuzda, Android'de Google Fit ile geliştirme yapmaya nasıl başlayacağınız açıklanmaktadır.

Not: Google Fit, Google Play Hizmetleri'nin bir parçasıdır. Uygulamanızın Google Play Hizmetleri'ni kullanmasının avantajları hakkında bilgi edinin.

Kurulum

Uygulamanızı oluşturmaya başlamadan önce aşağıdaki bölümlerde açıklanan adımları uygulayın.

Bir Google Hesabı edinin

Google Fit API'lerini kullanmak için Google Hesabınızın olması gerekir. Yeni hesap oluşturabilir veya mevcut bir hesabı kullanabilirsiniz. Uygulamanızı kullanıcıları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 yeni istemci kitaplığını edinin:

1. Android SDK Manager'ı açın.
2. SDK araçları altında Google Play Hizmetleri'ni bulun.
3. Bu paketlerin durumu Yüklü değilse ikisini de seçin ve 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 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. Android Studio'da yeni proje oluşturma ve yapılandırmayla ilgili ayrıntılar için Proje oluşturma sayfasına göz atın.

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:

Kotlin DSL'si

plugin {
    id("com.android.application")
}

...

dependencies {
        implementation("com.google.android.gms:play-services-fitness:21.1.0")
        implementation("com.google.android.gms:play-services-auth:20.5.0")
}

Eski DSL

apply plugin: 'com.android.application'

...

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

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

Uygulamanızı derleyip test etme

Kurulum adımlarını tamamladıktan sonra uygulamanızı derlemeye başlayabilirsiniz. Başlamak için uygulamanızın depolayabileceği ve okuyabileceği veri türleri hakkında bilgi edinin. Google Fit'te verilerle çalışma hakkında daha fazla bilgi edinin.

Gerekli Android izinlerini alın

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

OAuth izinlerini al

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 FitnessOptions örneğine 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ı yetkilendirmesini ister.

API istemcisi oluşturma

Bir API istemcisi oluşturun ve veri yazmak veya okumak için uygulamanızın 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 verilerine erişebilirsiniz.
• RecordingClient: Sensör verilerinin düşük güçte, her zaman açık arka planda toplanması için kullanılır.
• HistoryClient: Google Fit'te geçmiş verileri ekleyin, silin ve okuyun.
• SessionsClient: Kullanıcı etkinliği için Oturumlar oluşturun ve yönetin.
• GoalsClient: Google Fit'teki kullanıcılar tarafından oluşturulan Kardiyo Puanı ve Adım hedefleri'ni okuyun.
• 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 karşılaşılacak sonuç yetkilendirme akışı gösterilmektedir:

Şekil 1.Kullanıcılar için yetkilendirme akışı.

1. Android izinleri: Kullanıcılar uygulamanızı indirmeden önce, Android'in istediği izinleri görür. Uygulamanız indirildikten sonra ihtiyaç duyduğu çalışma zamanı izinlerini ister ve kullanıcılar bu izinleri verir ya da 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 kapsamlara ait veri türlerine erişebilir.

Doğrulama başvurusunda bulunun

Uygulamanızı derleyip test ettikten sonra hassas ve kısıtlanmış kapsamlar için gerekli farklı gerekçe seviyeleriyle doğrulama başvurusu yapmanız gerekir.