لاستخدام واجهة برمجة التطبيقات Google Awareness API، عليك إضافة مفتاح واجهة برمجة تطبيقات Google إلى تطبيقك. يجب أن يكون نوع مفتاح واجهة برمجة التطبيقات الذي تحتاجه هو مفتاح واجهة برمجة تطبيقات Android.
يتم توقيع جميع تطبيقات Android باستخدام شهادة رقمية تمتلك مفتاحها الخاص. لمزيد من المعلومات عن الشهادات الرقمية، يُرجى الرجوع إلى دليل Android حول كيفية توقيع تطبيقك.
تكون مفاتيح واجهة برمجة التطبيقات لنظام التشغيل Android مرتبطة بمجموعات محدّدة من الحِزم والشهادات. تحتاج فقط إلى مفتاح واحد لكل شهادة، بغض النظر عن عدد مستخدمي التطبيق.
يجب اتّباع عدة خطوات للحصول على مفتاح لتطبيقك. وقد تم وصفها بالتفصيل في هذا الدليل، ويمكن تلخيصها على النحو التالي:
- الحصول على معلومات عن شهادة تطبيقك
- سجِّل مشروعًا في Google Developers Console وأضِف واجهة برمجة التطبيقات User Context API كخدمة للمشروع.
- اطلب مفتاحًا.
- أضِف المفتاح إلى تطبيقك. ولإجراء ذلك، أضِف عنصرًا إلى بيان تطبيقك.
العثور على معلومات شهادة تطبيقك
يستند مفتاح واجهة برمجة التطبيقات إلى نموذج مختصر لشهادة تطبيقك الرقمية، ويُعرف باسم مرجع SHA-1. لعرض الملف المرجعي لشهادة SHA-1 ، تأكَّد أولاً من استخدام الشهادة الصحيحة. قد تتوفّر لك الشهادتان التاليتان للاختيار من بينهما:
- شهادة تصحيح الأخطاء: تنشئ أدوات حزمة تطوير البرامج (SDK) لنظام التشغيل Android هذه الشهادة تلقائيًا عند إنشاء إصدار لتصحيح الأخطاء. لا تستخدِم هذه الشهادة إلا مع التطبيقات التي تختبرها. لا تحاول نشر تطبيق موقَّع باستخدام شهادة تصحيح أخطاء. يمكنك الاطّلاع على مزيد من التفاصيل حول شهادة تصحيح الأخطاء في القسم توقيع إصدار تصحيح الأخطاء ضمن مستندات مطوّري تطبيقات Android.
- شهادة الإصدار: تنشئ أدوات حزمة SDK لنظام التشغيل Android
هذه الشهادة عند إنشاء إصدار علني. يمكنك أيضًا إنشاء هذه الشهادة باستخدام برنامج
keytool
. استخدِم هذه الشهادة عندما تكون مستعدًا لطرح تطبيقك على مستوى العالم.
لمزيد من المعلومات عن keytool
، يُرجى الاطّلاع على
مستندات Oracle.
عرض الملف المرجعي لشهادة تصحيح الأخطاء
استخدِم برنامج keytool
مع المَعلمة -v
لعرض
الملف المرجعي لشهادة SHA-1. لإجراء ذلك، يُرجى إكمال الخطوات التالية:
حدِّد موقع ملف تخزين مفاتيح تصحيح الأخطاء. اسم الملف هو
debug.keystore
، ويتم إنشاؤه في المرة الأولى التي تُنشئ فيها مشروعك. يتم تخزينه تلقائيًا في الدليل نفسه الذي تتوفّر فيه ملفات جهاز Android Virtual Device (AVD):- OS X وLinux:
~/.android/
- Windows Vista وWindows 7:
C:\Users\your_user_name\.android\
- OS X وLinux:
إدراج بصمة SHA-1:
بالنسبة إلى نظام التشغيل Linux أو OS X، افتح نافذة محطة طرفية وأدخِل ما يلي:
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
عرض الملف المرجعي لشهادة الإصدار
استخدِم برنامج keytool
مع المَعلمة -v
لعرض
الملف المرجعي لشهادة SHA-1. لإجراء ذلك، يُرجى إكمال الخطوات التالية:
- حدِّد مكان ملف تخزين مفاتيح شهادة الإصدار. لا يتوفّر موقع أو اسم تلقائيان
لمستودع مفاتيح الإصدار. إذا لم تحدِّد توقيعًا عند
إنشاء تطبيقك للإصدار، سيبقى
.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 رقمًا سداسيًا عشريًا
يتكوّن من رقمَين مفصولَين بنقطتَين.
الحصول على مفتاح واجهة برمجة التطبيقات من Google Developers Console
لبدء استخدام Google Awareness API، انقر على الزر الحصول على مفتاح. ويرتبط بـ Google Developers Console التي ترشدك خلال العملية وتفعِّل بدورها واجهة برمجة التطبيقات Awareness API تلقائيًا.
بدلاً من ذلك، يمكنك اتّباع الخطوات التالية للحصول على مفتاح واجهة برمجة التطبيقات:
- انتقِل إلى Google Developers Console.
- اختَر مشروعًا أو أنشئ مشروعًا جديدًا.
- انقر على متابعة لتفعيل واجهة برمجة التطبيقات Awareness API.
في صفحة "بيانات الاعتماد"، أنشئ مفتاح Android واضبط بيانات اعتماد واجهة برمجة التطبيقات.
في مربّع الحوار "إنشاء مفتاح"، عليك حصر الاستخدام على تطبيقات 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.awareness-example
انقر على إنشاء. سيظهر مفتاح واجهة برمجة التطبيقات الجديد لنظام التشغيل Android في قائمة مفاتيح واجهة برمجة التطبيقات لمشروعك. مفتاح واجهة برمجة التطبيقات هو سلسلة من الأحرف، مثل ما يلي:
AIzaSyBdVl-cTICSwYKrZ95LoVuw7dbMuDt1KG0
بعد أن حصلت على مفتاح واجهة برمجة التطبيقات، يمكنك إضافته إلى بيان تطبيقك كما هو описан في دليل البدء.
تفعيل واجهات برمجة التطبيقات الإضافية
تتيح لك واجهة برمجة التطبيقات Awareness API الوصول إلى أنواع متعدّدة من البيانات السياقية، مثل الإشارة. لاستخدام هذه الأنواع، عليك تفعيل واجهتَي برمجة التطبيقات المعنيّتَين في Google Developers Console.
الخدمة | طرق Awareness API | واجهة برمجة التطبيقات المطلوب تفعيلها |
---|---|---|
الإشارات | SnapshotApi.getBeaconState() ،
FenceApi.BeaconFence |
Nearby Messages API |