البدء على Android

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

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

الإعداد

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

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

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

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

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

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

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

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

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

ننصحك باستخدام بيئة تطوير "استوديو Android" لإنشاء تطبيق باستخدام 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.3.0")
        implementation("com.google.android.gms:play-services-auth:22.0.0")
}

Groovy DSL

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:22.0.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.

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

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

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

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

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

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

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