مفاتيح الاشتراك وواجهة برمجة التطبيقات

لاستخدام Google Aware Aware API، عليك إضافة مفتاح Google API إلى تطبيقك. نوع مفتاح واجهة برمجة التطبيقات الذي تحتاج إليه هو مفتاح لواجهة برمجة تطبيقات Android.

يتم توقيع جميع تطبيقات Android باستخدام شهادة رقمية تحتفظ بها بالمفتاح الخاص. لمزيد من المعلومات حول الشهادات الرقمية، يمكنك مراجعة دليل Android حول كيفية توقيع تطبيقك.

يتم ربط مفاتيح واجهة برمجة تطبيقات Android بأزواج معيّنة من حزم الشهادات. ما عليك سوى استخدام مفتاح واحد لكل شهادة، بغض النظر عن عدد المستخدمين لديك.

يجب أن تتّخذ العديد من الخطوات للحصول على مفتاح لتطبيقك، مع توضيحها بالتفصيل في هذا الدليل:

1. احصل على معلومات عن شهادة تطبيقك.
2. تسجيل مشروع في وحدة تحكم Google Developers وإضافة واجهة برمجة تطبيقات سياق المستخدم كخدمة للمشروع
3. اطلب مفتاحًا.
4. أضِف المفتاح إلى تطبيقك. ولإجراء ذلك، أضِف عنصرًا إلى بيان التطبيق.

العثور على معلومات شهادة تطبيقك

يستند مفتاح واجهة برمجة التطبيقات إلى نموذج قصير من الشهادة الرقمية لتطبيقك، التي يُطلق عليها اسم بصمة الإصبع SHA-1. لعرض الملف المرجعي لشهادة SHA-1 لشهادتك، تأكّد أولاً من استخدام الشهادة الصحيحة. قد تكون لديك الشهادتان التاليتان للاختيار من بينهما:

• شهادة تصحيح الأخطاء: تنشئ أدوات حزمة تطوير البرامج (SDK) لنظام التشغيل Android هذه الشهادة تلقائيًا عند إنشاء إصدار تصحيح الأخطاء. لا تستخدم هذه الشهادة إلا مع التطبيقات التي تختبرها. لا تحاول نشر تطبيق تم توقيعه باستخدام شهادة تصحيح أخطاء. يمكنك الاطّلاع على شهادة تصحيح الأخطاء بمزيد من التفاصيل في القسم توقيع إصدار تصحيح الأخطاء الخاص بك في مستندات مطوّري برامج Android.
• شهادة إصدار: تنشئ أدوات حزمة تطوير البرامج (SDK) لنظام التشغيل Android هذه الشهادة عند إنشاء إصدار. يمكنك أيضًا إنشاء هذه الشهادة باستخدام برنامج keytool. استخدِم هذه الشهادة عندما تكون مستعدًا لإصدار تطبيقك للجميع.

للحصول على مزيد من المعلومات عن keytool، يُرجى الاطّلاع على مستندات Oracle.

شهادة تصحيح الأخطاء

عرض الملف المرجعي لشهادة تصحيح الأخطاء

استخدِم البرنامج keytool مع المَعلمة -v لعرض الملف المرجعي لشهادة SHA-1. ولإجراء ذلك، أكمِل الخطوات التالية:

1. حدِّد موقع ملف تخزين مفاتيح التشفير. واسم الملف هو debug.keystore، ويتم إنشاؤه في المرة الأولى التي تُنشئ فيها مشروعك. ويتم تخزينه تلقائيًا في الدليل نفسه الذي يتضمّن ملفات جهاز Android الافتراضي: (AVD):

   • نظاما التشغيل X وLinux: ~/.android/
   • نظاما التشغيل Windows Vista وWindows 7: C:\Users\your_user_name\.android\

2. أدرِج بصمة الإصبع 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. ولإجراء ذلك، أكمِل الخطوات التالية:

1. حدِّد موقع ملف تخزين مفاتيح شهادة الإصدار. ما مِن موقع جغرافي أو اسم لتخزين مفاتيح التشفير بشكل تلقائي. إذا لم تحدّد إصدارًا واحدًا عند إنشاء تطبيقك لإصداره، لن يتم إنشاء الإصدار .apk بدون توقيع وسيكون عليك توقيعه قبل نشره. بالنسبة إلى شهادة الإصدار، ستحتاج أيضًا إلى العنوان البديل للشهادة وكلمات مرور ملف تخزين المفاتيح والشهادة.

2. أدخِل ما يلي لإدراج الأسماء المستعارة لجميع المفاتيح في ملف تخزين مفاتيح:

   keytool -list -keystore your_keystore_name
         

3. استبدِل your_keystore_name بالمسار المؤهَّل بالكامل واسم ملف تخزين المفاتيح. أدرِج الإضافة .keystore. أدخِل كلمة مرور ملف تخزين المفاتيح عندما يُطلب منك ذلك. بعد ذلك، يعرض keytool جميع الأسماء المستعارة في ملف تخزين المفاتيح.

4. أدخِل ما يلي في نافذة طرفية أو موجِّه أوامر:

         keytool -list -v -keystore your_keystore_name -alias your_alias_name
         

5. استبدِل your_keystore_name بالمسار المؤهَّل بالكامل واسم ملف تخزين المفاتيح. أدرِج الإضافة .keystore.
6. استبدِل your_alias_name بالاسم المستعار الذي خصَّصته للشهادة عند إنشائه.

ينبغي أن تظهر مُخرجات مشابهة لما يلي:

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 رقمًا سداسيًا عشريًا مكوّنًا من رقمين، مع الفصل بينهما بنقطتين.

تنبيه: لحماية ملف تخزين المفاتيح والمفتاح، لا تُدخل وسيطتَي storepass أو keypass في سطر الأوامر ما لم تكن واثقًا من أمان الكمبيوتر. على سبيل المثال، على جهاز كمبيوتر متاح للجميع، يمكن لأي مستخدم الاطّلاع على سجلّ نافذة المتصفّح أو قائمة العمليات قيد التشغيل، والحصول على كلمة المرور، ثم الوصول إلى شهادة التوقيع. وسيتيح هذا للمستخدم تعديل تطبيقك أو استبداله بنفسه.

الحصول على مفتاح لواجهة برمجة التطبيقات من Google Developers Console

لبدء استخدام Google Awareness API، انقر على الزر Get a key (الحصول على مفتاح). وهو يؤدي إلى Google Play Console، الذي يرشدك خلال العملية ويفعّل واجهة برمجة تطبيقات الوعي تلقائيًا.

الحصول على مفتاح

وبدلاً من ذلك، يمكنك اتّباع الخطوات التالية للحصول على مفتاح لواجهة برمجة التطبيقات:

1. انتقل إلى Google Developers Console.
2. اختَر مشروعًا أو أنشئ مشروعًا جديدًا.
3. انقر على متابعة لتفعيل الوعي.

4. في صفحة "بيانات الاعتماد"، يمكنك إنشاء مفتاح Android وضبط بيانات اعتماد واجهة برمجة التطبيقات.

   ملاحظة: إذا كان لديك مفتاح Android حالي، يمكنك استخدامه.

5. في مربّع الحوار "إنشاء مفتاح"، عليك قصر استخدامك على تطبيقات 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
   

6. انقر على إنشاء. سيظهر مفتاح Android API الجديد في قائمة مفاتيح واجهة برمجة التطبيقات لمشروعك. مفتاح واجهة برمجة التطبيقات هو سلسلة من الأحرف، مثل ما يلي:

   AIzaSyBdVl-cTICSwYKrZ95LoVuw7dbMuDt1KG0
   

الآن بعد أن حصلت على مفتاح واجهة برمجة التطبيقات، يمكنك إضافته إلى بيان تطبيقك، كما هو موضَّح في دليل البدء.

تفعيل واجهات برمجة تطبيقات إضافية

تتيح لك واجهة برمجة تطبيقات الوعي الوصول إلى أنواع متعددة من البيانات السياقية، مثل الإشارات. لاستخدام هذه الأنواع، تحتاج إلى تفعيل واجهات برمجة التطبيقات التابعة لها في Google Developers Console.

خدمة	طرق واجهة برمجة تطبيقات الوعي	واجهة برمجة التطبيقات للتفعيل
الإشارات	SnapshotApi.getBeaconState()، FenceApi.BeaconFence	واجهة برمجة تطبيقات الرسائل القريبة