البدء على Android

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

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

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

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

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

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

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

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

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

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

لتفعيل Fitness API، عليك الحصول على معرّف عميل OAuth 2.0.

إنشاء مشروعك وضبطه

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

إضافة مكتبة برامج "خدمات Google Play"

في Android Studio، افتح ملف build.gradle الخاص بوحدتك وأضِف مكتبة عملاء "خدمات Google Play" كعنصر تابع:

لغة Kotlin المحددة من جهة العميل

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

Groovy 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.3.0'
}

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

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

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

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

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

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

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

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

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

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

اطّلِع على مثال على كيفية إنشاء برنامج Fitness API client.

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

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

الشكل 1: عملية التفويض للمستخدمين

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

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

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