البدء على Android

يوضّح هذا الدليل كيفية بدء تطوير التطبيق باستخدام Google Fit على نظام Android.

ملاحظة: Google Fit هو جزء من "خدمات Google Play". تعرَّف على المزايا التي يحصل عليها تطبيقك من استخدام خدمات Google Play.

ضبط إعدادات الجهاز

قبل البدء في إنشاء تطبيقك، أكمل الخطوات الواردة في الأقسام التالية.

الحصول على حساب Google

لاستخدام واجهات برمجة تطبيقات Google Fit، يجب أن يكون لديك حساب على Google. ويمكنك إنشاء حساب جديد أو استخدام حساب حالي. قد تحتاج إلى إنشاء حساب منفصل لاختبار تطبيقك من منظور المستخدم.

الحصول على خدمات Google Play

احصل على أحدث مكتبة عملاء لخدمات Google Play على مضيف التطوير:

1. افتح مدير حزمة تطوير البرامج (SDK) لنظام التشغيل Android.
2. ضمن أدوات SDK، ابحث عن خدمات Google Play.
3. إذا لم تكن حالة هاتين الحِزمتَين مثبّتة، اختَرهما معًا وانقر على تثبيت الحزم.

الحصول على معرِّف عميل OAuth 2.0

لتفعيل واجهة برمجة تطبيقات Fitness، احصل على معرِّف عميل OAuth 2.0.

إنشاء مشروعك وإعداده

نقترح استخدام بيئة تطوير Android Studio لإنشاء تطبيق باستخدام Fitness API. للحصول على تفاصيل حول كيفية إنشاء مشروع جديد وإعداده في "استوديو Android"، يمكنك الاطّلاع على إنشاء مشروع.

إضافة مكتبة عملاء "خدمات Google Play"

في "استوديو Android"، افتح ملف build.gradle للوحدة التنظيمية وأضِف مكتبة برامج "خدمات Google Play" كملحق:

خدمة 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")
}

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

يضمن ذلك تنزيل Gradle تلقائيًا لحزمة SDK للّياقة البدنية عندما تنشئ تطبيقك.

إنشاء تطبيقك واختباره

بعد الانتهاء من خطوات الإعداد، يمكنك البدء في إنشاء تطبيقك. وللبدء، تعرَّف على أنواع البيانات التي يمكن لتطبيقك تخزينها وقراءتها. تعرّف على المزيد من المعلومات حول استخدام البيانات في Google Fit.

الحصول على أذونات Android اللازمة

لقراءة بعض أنواع البيانات وكتابتها، على تطبيقك طلب أذونات Android.

الحصول على أذونات OAuth

تتوافق أنواع البيانات التي يمتلك تطبيقك إذنًا بالوصول إليها مع نطاقات التفويض. لطلب هذه الأذونات، عليك إضافة أنواع البيانات التي يحتاج تطبيقك إلى الوصول إليها في مثيل FitnessOptions. عندما يطلب تطبيقك استخدام أيٍّ من أنواع بيانات Google Fit، تتحقق حزمة تطوير البرامج (SDK) لنظام التشغيل Android تلقائيًا من النطاقات التي تنتمي إليها وتطلب من المستخدم منح الإذن لهذه النطاقات.

إنشاء عميل واجهة برمجة تطبيقات

أنشئ عميل واجهة برمجة تطبيقات وأضف أنواع البيانات التي يحتاج تطبيقك الوصول إليها لكتابة البيانات أو قراءتها. تتوفّر نقاط النهاية التالية:

• SensorsClient: يمكنك الوصول إلى مصادر مختلفة لبيانات الصحة والعافية من أجهزة الاستشعار في الأجهزة على الجهاز المحلي وفي الأجهزة المصاحبة.
• RecordingClient: لجمع بيانات أداة الاستشعار في الخلفية بتكلفة منخفضة وتكون قيد التشغيل دائمًا.
• HistoryClient: يمكنك إدراج البيانات السابقة وحذفها وقراءتها في Google Fit.
• SessionsClient: إنشاء جلسات لنشاط المستخدم وإدارتها
• GoalsClient: يمكنك قراءة أهداف "نقاط القلب" و"الخطوات" التي أنشأها المستخدمون في Google Fit.
• ConfigClient: الوصول إلى أنواع البيانات المخصّصة وإعداداتها في نظام Google Fit الأساسي.

اطّلِع على مثال حول كيفية إنشاء عميل واجهة برمجة تطبيقات لياقة بدنية.

مسار تفويض المستخدم الناتج

يوضح ما يلي تدفق التفويض الناتج الذي يواجهه المستخدمون عند مطالبتهم بالأذونات:

الشكل 1.مسار التفويض للمستخدمين.

1. أذونات Android: يمكن للمستخدمين الاطّلاع على أذونات Android التي طلبها تطبيقك قبل تنزيله. بعد تنزيل تطبيقك، يطلب الحصول على أي أذونات وقت تشغيل مطلوبة، ويمنح المستخدمون هذه الأذونات أو يرفضونها.
2. التحقّق والربط: يتحقّق تطبيقك ممّا إذا تم منح الأذونات قبل أن يطلب الوصول إلى أنواع بيانات أخرى.
3. طلب نطاقات OAuth: تطلب Google من المستخدم منح تطبيقك نطاقات OAuth اللازمة لأنواع البيانات التي يريد الوصول إليها.
4. تم تطبيق إذن الوصول: بعد أن يمنح المستخدم الأذونات، يمكن لتطبيقك الوصول إلى أنواع البيانات التي تنتمي إلى النطاقات التي منحها المستخدم الإذن.

التقدّم بطلب لإثبات الهوية والأهلية

بعد إنشاء تطبيقك واختباره، عليك التقدّم بطلب لإثبات الهوية والأهلية مع مراعاة مستويات مختلفة من التبرير اللازم للنطاقات الحسّاسة والمحظورة.