البدء على Android

أنشئ حسابًا على Google

لاستخدام Google Fit APIs، يجب أن يكون لديك حساب على 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"، افتح ملف build.gradle للوحدة وأضِف مكتبة برامج عملاء "خدمات Google Play" كإحدى التبعيات:

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.6.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.6.0'
}

يضمن ذلك أن ينزّل Gradle تلقائيًا حزمة تطوير البرامج (SDK) الخاصة بتطبيق Google Fit عند إنشاء تطبيقك.

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

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

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

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

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

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

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

يمكنك الاطّلاع على مثال حول كيفية إنشاء عميل Fitness API.

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

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

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