قبل البدء
قبل أن تبدأ في استخدام حزمة تطوير البرامج (SDK) لأماكن Google على نظام التشغيل Android، يجب أن يكون لديك مشروع يحتوي على حساب فوترة وأن تكون حزمة تطوير برامج الأماكن لأجهزة Android مفعّلة. لمزيد من المعلومات، يُرجى الاطِّلاع على الإعداد في Cloud Console.
إنشاء مفاتيح واجهة برمجة التطبيقات
مفتاح واجهة برمجة التطبيقات هو معرّف فريد يصادق على الطلبات المرتبطة بمشروعك لأغراض الاستخدام والفوترة. يجب أن يكون لديك مفتاح واجهة برمجة تطبيقات واحد على الأقل مرتبط بمشروعك.
لإنشاء مفتاح واجهة برمجة تطبيقات:
وحدة التحكّم
-
انتقِل إلى صفحة منصة خرائط Google > وبيانات الاعتماد.
-
في صفحة بيانات الاعتماد، انقر على إنشاء بيانات اعتماد >؛ مفتاح واجهة برمجة التطبيقات.
يعرض مربع الحوار تم إنشاء مفتاح واجهة برمجة التطبيقات مفتاح واجهة برمجة التطبيقات الذي تم إنشاؤه حديثًا. -
انقر على إغلاق.
يتم إدراج مفتاح واجهة برمجة التطبيقات الجديد في صفحة بيانات الاعتماد ضمن مفاتيح واجهة برمجة التطبيقات.
(تذكّر تقييد واجهة برمجة التطبيقات قبل استخدامها في الإنتاج).
Cloud SDK
gcloud alpha services api-keys create \ --project "PROJECT" \ --display-name "DISPLAY_NAME"
يمكنك الاطّلاع على مزيد من المعلومات حول Google Cloud SDK وتثبيت Cloud SDK والطلبات التالية:
تقييد مفاتيح واجهة برمجة التطبيقات
تنصح Google بشدة بتقييد مفاتيح واجهة برمجة التطبيقات من خلال حصر استخدامها على واجهات برمجة التطبيقات المطلوبة فقط لتطبيقك. يؤدي تقييد مفاتيح واجهة برمجة التطبيقات إلى إضافة أمان إلى تطبيقك عن طريق حمايته من الطلبات غير المرغوب فيها. لمزيد من المعلومات، يُرجى الاطّلاع على أفضل ممارسات أمان واجهة برمجة التطبيقات.
عند حظر مفتاح واجهة برمجة التطبيقات، عليك تقديم الملف المرجعي لشهادة SHA-1 لمفتاح التوقيع الذي تم استخدامه لتوقيع التطبيق. هناك نوعان من الشهادات:
- شهادة تصحيح الأخطاء: استخدِم نوع الشهادة هذا فقط مع التطبيقات التي تختبرها أنت وغير ذلك من الرموز غير الإنتاجية. لا تحاول نشر تطبيق تم توقيعه باستخدام شهادة تصحيح أخطاء. تنشئ أدوات حزمة تطوير البرامج (SDK) لنظام التشغيل Android هذه الشهادة تلقائيًا عند تشغيل إنشاء تصحيح أخطاء.
- شهادة الإصدار: استخدِم هذه الشهادة عندما تكون مستعدًا لإصدار تطبيقك إلى متجر تطبيقات. تنشئ أدوات حزمة تطوير البرامج (SDK) لنظام التشغيل Android هذه الشهادة عند تشغيل إصدار إصدار.
ولمزيد من المعلومات حول الشهادات الرقمية، راجِع دليل توقيع تطبيقك.
للحصول على معلومات حول الحصول على بصمة إصبع شهادتك، راجع مصادقة البرنامج. إذا كنت تستخدم ميزة توقيع التطبيق من Play بدلاً من ذلك، عليك الانتقال إلى صفحة توقيع التطبيق على Play Console للحصول على الملف المرجعي للشهادة.
لتقييد مفتاح واجهة برمجة تطبيقات:
وحدة التحكّم
-
انتقِل إلى صفحة منصة خرائط Google > وبيانات الاعتماد.
- اختَر مفتاح واجهة برمجة التطبيقات الذي تريد إعداد قيود عليه. تظهر صفحة موقع مفتاح واجهة برمجة التطبيقات.
- ضمن القيود الرئيسية، اضبط القيود التالية:
- قيود التطبيق:
- اختَر تطبيقات Android.
- انقر على + إضافة اسم حزمة وبصمة إصبع.
- أدخِل اسم الحزمة وبصمة إصبع شهادة SHA-1. مثلاً:
com.example.android.mapexample
BB:0D:AC:74:D3:21:E1:43:67:71:9B:62:91:AF:A1:66:6E:44:5D:75
- قيود واجهة برمجة التطبيقات:
- انقر على تقييد المفتاح.
- اختر واجهة برمجة تطبيقات الأماكن من القائمة المنسدلة اختيار واجهات برمجة التطبيقات. إذا لم تكن واجهة برمجة تطبيقات الأماكن مدرجة، عليك تفعيلها.
- لإنهاء التغييرات التي أجريتها، انقر على حفظ.
Cloud SDK
يمكنك إدراج المفاتيح الحالية.
gcloud services api-keys list --project="PROJECT"
محو القيود الحالية على المفتاح الحالي.
gcloud alpha services api-keys update "projects/PROJECT/keys/KEY_ID" \ --clear-restrictions
يمكنك ضبط قيود جديدة على المفتاح الحالي.
gcloud alpha services api-keys update "projects/PROJECT/keys/KEY_ID" \ --api_target="places-backend.googleapis.com" --allowed-application="sha1_fingerprint=SHA1_FINGERPRINT,package_name=ANDROID_PACKAGE_NAME"
يمكنك الاطّلاع على مزيد من المعلومات حول Google Cloud SDK وتثبيت Cloud SDK والطلبات التالية:
العثور على معلومات شهادة التطبيق
يستند مفتاح واجهة برمجة التطبيقات إلى نموذج قصير من الشهادة الرقمية لتطبيقك، يُعرف باسم بصمة إصبع SHA-1. لعرض الملف المرجعي لشهادة SHA-1 للشهادة، تأكّد أولاً من أنك تستخدم الشهادة الصحيحة. قد تكون لديك شهادتان:
- شهادة تصحيح الأخطاء: تنشئ أدوات حزمة تطوير البرامج (SDK) لنظام التشغيل Android هذه الشهادة تلقائيًا عند إنشاء تصحيح الأخطاء. لا تستخدم هذه الشهادة إلا مع التطبيقات التي تختبرها. لا تحاول نشر تطبيق تم توقيعه باستخدام شهادة تصحيح أخطاء. يتم وصف شهادة تصحيح الأخطاء بمزيد من التفصيل في التوقيع في وضع تصحيح الأخطاء في مستندات مطوّري برامج Android.
- شهادة إصدار: تنشئ أدوات حزمة تطوير البرامج (SDK) لنظام التشغيل Android هذه الشهادة عند إنشاء إصدار. ويمكنك أيضًا إنشاء هذه الشهادة باستخدام برنامج
keytool
. استخدِم هذه الشهادة عندما تكون مستعدًا لإطلاق تطبيقك للعالم.
استخدام المربّع
يسهّل تطبيق Gradle الحصول على معلومات توقيع تطبيقك،
وما عليك سوى تشغيل ./gradlew signingReport
.
من المفترض أن يظهر الناتج على النحو التالي:
Task :app:signingReport Variant: debug Config: debug Store: ~/.android/debug.keystore Alias: AndroidDebugKey MD5: 76:4E:BF:C3:59:DA:D3:8F:98:D6:3C:DB:87:A4:5B:E7 SHA1: 99:8E:73:B8:3A:A3:A3:C4:C1:D4:19:08:F6:7E:9E:F6:75:29:4C:B2 SHA-256: 6C:01:12:53:90:94:73:B5:66:D6:07:FF:A5:6F:AB:30:AE:99:20:55:0F:B3:12:22:4C:46:7E:02:3D:7E:6D:1D Valid until: Friday, June 25, 2049 ---------- Variant: release Config: release Store: app/keystore.jks Alias: keystore MD5: 1E:63:0F:14:67:E0:04:BD:98:4C:EB:2B:09:EF:7E:1E SHA1: 2C:DF:9F:D1:A3:0D:1E:01:48:34:5D:91:52:0B:D8:8A:5A:07:45:C3 SHA-256: 12:66:CE:4B:90:FD:64:1A:4D:79:9E:78:AD:59:0C:21:D8:53:61:EE:2B:90:E4:67:CE:65:A0:76:04:13:23:89 Valid until: Tuesday, September 29, 2116
يدويًا
اتّبع الخطوات التالية لعرض بصمة إصبع 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
بالاسم المستعار الذي حدّدته للشهادة عند إنشائها.
من المفترَض أن تظهر لك نتيجة مثل هذه:
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 رقمًا سداسيًا عشريًا مكونًا من رقمين، مع الفصل بينها بنقطتين.