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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

لبدء استخدام Google Awareness API، انقر على الزر الحصول على مفتاح. ويرتبط بـ Google Developers Console التي ترشدك خلال العملية وتفعِّل بدورها واجهة برمجة التطبيقات Awareness API تلقائيًا.

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

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

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

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 في قائمة مفاتيح واجهة برمجة التطبيقات لمشروعك. مفتاح واجهة برمجة التطبيقات هو سلسلة من الأحرف، مثل ما يلي:

   AIzaSyBdVl-cTICSwYKrZ95LoVuw7dbMuDt1KG0
   

بعد أن حصلت على مفتاح واجهة برمجة التطبيقات، يمكنك إضافته إلى بيان تطبيقك كما هو описан في دليل البدء.

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

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

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