تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

بدء الاستخدام على Android

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

الإعداد

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

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

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

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

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

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

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

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

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

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

رائع DSL

apply plugin: 'com.android.application'

...

dependencies {
    implementation 'com.google.android.gms:play-services-fitness:21.1.0'
    implementation 'com.google.android.gms:play-services-auth:20.7.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.

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

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

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

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

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

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