نظرة عامة
لاستخدام Google Fit لنظام التشغيل Android، يجب أن يكون لديك معرِّف عميل OAuth 2.0 تطبيقات Android.
يتم توقيع جميع تطبيقات Android باستخدام شهادة رقمية تحمل لها الخاص. يُرجى الرجوع إلى دليل Android لتوقيع تطبيقاتك لمزيد من المعلومات عن الشهادات الرقمية.
يتم ربط معرِّفات عملاء OAuth في Android بأزواج شهادات/حِزم محدَّدة. تحتاج فقط إلى معرّف واحد لكل شهادة، بغض النظر عن عدد مستخدمي التطبيق.
يتطلّب الحصول على رقم تعريف لتطبيقك عدة خطوات. تم توضيح هذه الخطوات أدناه.
- ابحث عن معلومات شهادة تطبيقك.
- إنشاء مشروع أو تعديله في وحدة التحكم في واجهة Google API
- طلب معرِّف عميل OAuth 2.0.
العثور على معلومات شهادة تطبيقك
يستند مفتاح واجهة برمجة التطبيقات إلى شكل مختصر من الشهادة الرقمية لتطبيقك، المعروف باسم بصمة إصبع SHA-1. لعرض خوارزمية SHA-1 بصمة الإصبع لشهادتك، فتأكد أولاً من استخدام الطريقة الصحيحة الشهادة. قد يكون لديك شهادتان:
- شهادة تصحيح الأخطاء: تنشئ أدوات حزمة تطوير البرامج (SDK) لنظام التشغيل Android هذه الشهادة تلقائيًا عند إنشاء إصدار لتصحيح الأخطاء. لا تستخدِم هذه الشهادة إلا مع التطبيقات التي تختبرها. لا تحاول نشر تطبيق تم توقيعه باستخدام شهادة تصحيح أخطاء. يتم وصف شهادة تصحيح الأخطاء بمزيد من التفصيل في التوقيع في وضع تصحيح الأخطاء في مستندات مطوّري برامج Android.
- شهادة الإصدار: تنشئ أدوات حزمة تطوير البرامج (SDK) لنظام التشغيل Android.
هذه الشهادة عند إنشاء إصدار. يمكنك أيضًا إنشاء هذه الشهادة
باستخدام برنامج
keytool
. استخدِم هذه الشهادة عندما تكون مستعدًا لإصدار تطبيقك للجميع.
اتّبِع الخطوات التالية لعرض بصمة SHA-1 للشهادة باستخدام
برنامج keytool
مع المَعلمة -v
. لمزيد من
المعلومات حول Keytool، يُرجى الاطّلاع على
مستندات Oracle.
يتم عرض الملف المرجعي لشهادة تصحيح الأخطاء.
حدِّد موقع ملف تخزين مفاتيح تصحيح الأخطاء. اسم الملف هو
debug.keystore
، ويتم إنشاؤه في المرة الأولى التي تنشئ فيها مشروعك. يتم تخزينه تلقائيًا في الدليل نفسه الذي تتوفّر فيه ملفات "جهاز Android العامودي (AVD)":- macOS وLinux:
~/.android/
- Windows Vista وWindows 7:
C:\Users\your_user_name\.android\
- macOS وLinux:
إدراج بصمة SHA-1:
في نظام التشغيل Linux أو macOS، افتح نافذة محطة طرفية وأدخِل ما يلي:
keytool -list -v -keystore ~/.android/debug.keystore -alias androiddebugkey -storepass android -keypass android
بالنسبة إلى نظامي التشغيل Windows Vista وWindows 7، شغِّل:
keytool -list -v -keystore "%USERPROFILE%\.android\debug.keystore" -alias androiddebugkey -storepass android -keypass android
من المفترض أن تظهر لك نتيجة مشابهة لما يلي:
Alias name: androiddebugkey Creation date: Jan 01, 2013 Entry type: PrivateKeyEntry Certificate chain length: 1 Certificate[1]: Owner: CN=Android Debug, O=Android, C=US Issuer: CN=Android Debug, O=Android, C=US Serial number: 4aa9b300 Valid from: Mon Jan 01 08:04:04 UTC 2013 until: Mon Jan 01 18:04:04 PST 2033 Certificate fingerprints: MD5: AE:9F:95:D0:A6:86:89:BC:A8:70:BA:34:FF:6A:AC:F9 SHA1: BB:0D:AC:74:D3:21:E1:43:07:71:9B:62:90:AF:A1:66:6E:44:5D:75 Signature algorithm name: SHA1withRSA Version: 3
عرض الملف المرجعي لشهادة الإصدار
-
حدِّد موقع ملف تخزين مفاتيح شهادة الإصدار. لا يتوفّر موقع أو اسم تلقائيان لمستودع مفاتيح الإصدار. إذا لم تحدد واحدًا عندما إنشاء تطبيقك لإصداره، سيترك الإصدار لم يتم التوقيع من قِبل "
.apk
"، وعليك التوقيع قبل أن تتمكّن من ونشرها. بالنسبة إلى شهادة الإصدار، ستحتاج أيضًا إلى اسم البديل للشهادة وكلمات مرور ملف تخزين المفاتيح والشهادة. يمكنك إدراج الأسماء المستعارة لجميع المفاتيح في ملف تخزين المفاتيح من خلال إدخال:keytool -list -keystore your_keystore_name
استبدِل
your_keystore_name
بالمسار المُؤهَّل بالكامل واسم ملف تخزين المفاتيح، بما في ذلك اللاحقة.keystore
. سيُطلب منك إدخال كلمة مرور ملف تخزين المفاتيح. بَعْدَ ذَلِكْ يعرضkeytool
جميع الأسماء المستعارة في ملف تخزين المفاتيح. -
أدخِل ما يلي في وحدة طرفية أو موجّه الأوامر:
keytool -list -v -keystore your_keystore_name -alias your_alias_name
استبدِل
your_keystore_name
بالمسار المُؤهَّل بالكامل واسم ملف تخزين المفاتيح، بما في ذلك اللاحقة.keystore
. استبدِلyour_alias_name
بالاسم المستعار الذي assigned قدّمته للشهادة عند إنشائها.
من المفترض أن تظهر لك نتيجة مشابهة لما يلي:
Alias name: <alias_name> Creation date: Feb 02, 2013 Entry type: PrivateKeyEntry Certificate chain length: 1 Certificate[1]: Owner: CN=Android Debug, O=Android, C=US Issuer: CN=Android Debug, O=Android, C=US Serial number: 4cc9b300 Valid from: Mon Feb 02 08:01:04 UTC 2013 until: Mon Feb 02 18:05:04 PST 2033 Certificate fingerprints: MD5: AE:9F:95:D0:A6:86:89:BC:A8:70:BA:34:FF:6B:AC:F9 SHA1: BB:0D:AC:74:D3:21:E1:43:67:71:9B:62:90:AF:A1:66:6E:44:5D:75 Signature algorithm name: SHA1withRSA Version: 3
يحتوي السطر الذي يبدأ بالرمز SHA1
على الملف المرجعي لشهادة SHA-1
. البصمة هي تسلسل 20 رقمًا سداسيًا عشريًا
يتكوّن من رقمَين مفصولَين بنقطتَين.
طلب معرّف عميل OAuth 2.0 في "وحدة تحكّم واجهة برمجة تطبيقات Google"
اتّبِع الخطوات التالية لإنشاء مشروع أو تعديله لتطبيقك في وحدة التحكم في واجهة برمجة تطبيقات Google، وتفعيل واجهة برمجة تطبيقات اللياقة البدنية، وطلب معرّف عميل OAuth 2.0.
إذا أردت الحصول على إرشادات خلال العملية وتفعيل واجهة برمجة التطبيقات Fitness API تلقائيًا، انقر على
يمكنك بدلاً من ذلك اتّباع الخطوات التالية لتفعيل Fitness API في وحدة التحكم في واجهة Google API والحصول على معرِّف عميل OAuth 2.0.
- انتقِل إلى وحدة تحكّم واجهة Google API.
- اختَر مشروعًا أو أنشِئ مشروعًا جديدًا. استخدام المشروع نفسه لنظام Android وREST الخاصة بتطبيقك.
- انقر على متابعة لتفعيل Fitness API.
- انقر على الانتقال إلى بيانات الاعتماد.
- انقر على بيانات الاعتماد الجديدة، ثم اختَر معرِّف عميل OAuth.
- ضمن نوع التطبيق، اختَر Android.
في مربّع الحوار الناتج، أدخِل الملف المرجعي SHA-1 لتطبيقك واسم الحزمة. على سبيل المثال:
BB:0D:AC:74:D3:21:E1:43:67:71:9B:62:91:AF:A1:66:6E:44:5D:75
com.example.android.fit-example
انقر على إنشاء. يظهر معرّف عميل وسر OAuth 2.0 الجديدان لنظام التشغيل Android في قائمة أرقام تعريف مشروعك. معرِّف عميل OAuth 2.0 عبارة عن سلسلة من الشخصيات، شيء من هذا القبيل:
780816631155-gbvyo1o7r2pn95qc4ei9d61io4uh48hl.apps.googleusercontent.com