Android'i kullanmaya başlama

Bu kılavuzda, Android'de Google Fit ile geliştirmeye nasıl başlanacağı açıklanmaktadır.

Not: Google Fit, Google Play Hizmetleri'nin bir parçasıdır. Daha fazla bilgi edinin: uygulamanızın Google Play'i kullanmanın sağladığı avantajlar Hizmetler.

Kurulum

Uygulamanızı derlemeye başlamadan önce aşağıdaki adımları tamamlayın bölümlerini kontrol edin.

Bir Google Hesabı edinin

Google Fit API'lerini kullanmak için Google Hesabınızın olması gerekir. İsterseniz yeni bir hesap oluşturabilir veya mevcut bir hesabı kullanın. Kampanyaları test etmek için ayrı bir hesap bakış açısından değerlendireceğiz.

Google Play hizmetlerini edinin

Geliştirme sürecinde Google Play Hizmetleri için en yeni istemci kitaplığını edinin barındırıcı:

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 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. Örneğin, Android Studio'da yeni bir projenin nasıl oluşturulacağı ve yapılandırılacağı ile ilgili ayrıntılar için bkz. Proje oluşturun.

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:

Kotlin 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.2.0")
}

Eski DSL

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'
}

Bu sayede Gradle, temel bilgilerdir.

Uygulamanızı derleyip test edin

Kurulum adımlarını tamamladıktan sonra uygulamanızı oluşturmaya başlayabilirsiniz. Şunları almak için: önce uygulamanızın depolayabileceği veri türleri okuyun. Daha fazla bilgi için ekibinizin verileri Google Fit'te gösterilir.

Gerekli Android izinlerini alma

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

OAuth izinleri alma

Uygulamanızın erişme iznine sahip olduğu veri türleri şunlara karşılık gelir: yetkilendirme kapsamlarına sahip olmanız gerekir. Sormak istediğiniz sorular için bu izinler için şunları eklemeniz gerekir: uygulamanızın FitnessOptions içinde hangi veri türlerine erişmesi gerektiğini örneğine bakın. Uygulamanız Google Fit verilerini kullanmak istediğinde Android SDK, hangi kapsamlara ait olduklarını otomatik olarak kontrol eder ve kullanıcıya yetki vermeniz gerekir.

API istemcisi oluşturma

API istemcisi oluşturma ve uygulamanızın erişmesi gereken veri türlerini ekleme veri yazma veya okuma Aşağıdaki uç noktalar kullanılabilir:

• SensorsClient: Yerel cihazdaki ve tamamlayıcı cihazlardaki donanım sensörlerinden alınan farklı sağlık ve sağlıklı yaşam verisi kaynaklarına erişebilirsiniz.
• RecordingClient: Sensör verilerinin düşük güçte, her zaman açık arka planda toplanması için kullanılır.
• HistoryClient: Buraya geçmiş verileri ekleyin, silin ve okuyun Google Fit'e dokunun.
• SessionsClient: Kullanıcı etkinliği Oturumları oluşturun ve yönetin.
• GoalsClient: Google Fit'te kullanıcılar tarafından oluşturulan Kardiyo Puanı ve Adımlar hedeflerini okuma.
• 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ıların deneyimlediği, sonuçta ortaya çıkan yetkilendirme akışı gösterilmektedir sizden izin istendiğinde:

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

1. Android izinleri: Kullanıcılar, uygulamanız için hangi Android izinlerini görür? istekte bulunabilirsiniz. Uygulamanız indirildikten sonra ve kullanıcılar gereken çalışma zamanı izinlerini ister ve kullanıcılar verir veya reddeder bu izinleri verebilirsiniz.
2. Kontrol et ve bağlan: Uygulamanız, izinlerin yapılıp yapılmadığını kontrol eder. diğer veri türlerine erişim istemeden önce verilmiş olmalıdır.
3. OAuth kapsamları isteği: Google, kullanıcıdan uygulamanıza izin vermesini ister Erişim sağlamak istediği veri türleri için gereken OAuth kapsamlarını belirleyin.
4. Erişim uygulandı: Kullanıcı izin verdikten sonra uygulamanız şunları yapabilir: Kullanıcının izin verdiği kapsamlara ait veri türlerine erişin izni vermiş olursunuz.

Doğrulama için başvurun

Uygulamanızı derleyip test ettikten sonra doğrulama gereken gerekçe düzeyleri hassas ve kısıtlanmış kapsamları kapsamaz.