البدء على Android

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

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

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

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

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

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

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

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

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

لغة Kotlin DSLDSL رائعة
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")
}
 
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 للياقة البدنية تلقائيًا عند ينشئ تطبيقك.

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

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

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

أنواع البيانات التي يملك تطبيقك إذنًا بالوصول إليها، بما يتوافق مع أنواع البيانات نطاقات التفويض للسؤال لهذه الأذونات، عليك إضافة أنواع البيانات التي يحتاج تطبيقك إلى الوصول إليها في 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. تم تطبيق إمكانية الوصول: بعد أن يمنح المستخدم الأذونات، سيتمكّن تطبيقك من تنفيذ ما يلي: الوصول إلى أنواع البيانات التي تنتمي إلى النطاقات التي منحها المستخدم إذن من أجله.

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

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