التسجيل في Android Developer Console

إذا كنت توزع التطبيقات خارج Google Play فقط، استخدِم Android Developer Console لإدارة هوية المطوِّر وتسجيل أسماء حِزم التطبيقات. يوضّح هذا الدليل كيفية إثبات ملكية حسابك والتأكّد من إمكانية تثبيت تطبيقاتك على أجهزة Android معتمَدة.

إنشاء حساب

يمكنك الاشتراك للحصول على حساب باستخدام حساب Google. إذا كنت طالبًا أو من هواة التصوير، يمكنك إنشاء نوع حساب خاص يتضمّن متطلبات أقل للتحقّق من الهوية وبدون أي رسوم.

اختيار طريقة توزيع تطبيقاتك

سيظل بإمكانك تثبيت التطبيقات من مصادر غير معروفة. تعتمد تجربة المستخدم على المسار الذي تختاره.

إكمال إثبات الهوية

تختلف المتطلبات باختلاف أنواع الحسابات. راجِع دليلَي حساب التوزيع الكامل وحساب محدود التوزيع لتحديد الخيار الأنسب لك.

تسجيل أسماء الحزم

بعد إكمال عملية التحقّق، يمكنك تسجيل أسماء حِزم تطبيقك في صفحة الحِزم. تربط عملية التسجيل تطبيقك بهوية المطوّر التي تم إثباتها. أكمِل ما يلي في Android Developer Console للتسجيل:

  1. أدخِل اسم الحزمة: أدخِل اسم الحزمة الفريد الذي تريد تسجيله.
  2. إضافة المفتاح: أدخِل الملف المرجعي لشهادة SHA-256 من زوج مفاتيح توقيع تطبيقك. ستتغيّر الحالة بعد ذلك إلى قيد المراجعة.
  3. إثبات الملكية: بالنسبة إلى أسماء الحِزم الحالية، يجب توقيع حزمة APK باستخدام مفتاحك الخاص وتحميلها. توفّر أداة Android Developer Console مقتطفًا لإضافته إلى مجلد مواد العرض في حزمة APK لهذا التحدي. بعد التسجيل، سيتم إعلامك عبر البريد الإلكتروني وسيتم تعديل حالة اسم الحزمة في Developer Console إلى مسجَّل.

أتمتة سير العمل

يمكنك إعداد عملية التحقّق من هوية المطوّر وتسجيل الحِزم تلقائيًا باستخدام واجهات برمجة التطبيقات التالية:

  • واجهة برمجة التطبيقات الخاصة بحالة رقم تعريف مطوّر تطبيقات Android: تتيح لك التحقّق مما إذا كان اسم الحزمة قد تم تسجيله من قبل والتحقّق من الأهلية.
  • واجهة برمجة التطبيقات Android Developer Console: تتيح لك تسجيل أسماء الحِزم والمفاتيح وإدارتها مباشرةً ضمن بيئة التطوير أو مسار CI/CD.

تتيح كلتا واجهتَي برمجة التطبيقات تفويض OAuth، ما يسمح للمنصات التابعة لجهات خارجية (مثل متاجر تطبيقات Android البديلة) بتنفيذ هذه العمليات بأمان نيابةً عنك.

التعامل مع أسماء الحِزم المكرّرة

إذا استخدم عدة مطوّرين اسم الحزمة نفسه، يتم تحديد حق التسجيل وفقًا لقواعد تسجيل اسم الحزمة. تهدف القواعد التالية إلى تخصيص اسم الحزمة للمطوّر الذي يمثّل مفتاح التوقيع الخاص به أكثر من ‎50% من إجمالي عمليات التثبيت المعروفة:

  • المجموعة الأكبر: إذا كانت مفاتيح المطوّر تمثّل أكثر من ‎50% من جميع عمليات التثبيت، تكون الأولوية للمطوّر في التسجيل.
  • مجموعة كبيرة: إذا لم يمثّل أي مفتاح أكثر من ‎50% من عمليات التثبيت، يمكن لأي مطوّر لديه "مجموعة كبيرة" (50 عملية تثبيت أو أكثر) تسجيل اسم الحزمة.
  • مبدأ الأسبقية: إذا لم تتوفر مجموعة كبيرة، يمكن لأي مطوّر لديه مفتاح معروف تسجيل اسم الحزمة وفقًا لمبدأ الأسبقية.

توضّح الأمثلة التالية هذه القواعد:

الأولوية لصاحب المفتاح ذي الحصة الأكبر:

تكون الأولوية في التسجيل للمطوِّر الذي يمثّل مفتاح التوقيع الخاص به أكثر من ‎50% من إجمالي عمليات التثبيت المعروفة. سيكون على جميع المطوّرين الآخرين استخدام اسم حزمة مختلف.

المطوِّر

اسم الحزمة

المفتاح

عمليات التثبيت

A

com.test.1

11

1000

B

com.test.1

12

100

في هذه الحالة، يكون "المطوّر أ" مؤهَّلاً لتسجيل اسم الحزمة. على المطوّر (ب) استخدام اسم آخر أو تقديم طلب للحصول على استثناء.

الأهلية لاستخدام المفاتيح التي تم تثبيتها أكثر من 50 مرة:

إذا لم يمثّل أي مفتاح أكثر من ‎50% من عمليات التثبيت، تكون جميع المفاتيح المرتبطة بـ 50 عملية تثبيت أو أكثر مؤهَّلة للتسجيل. على جميع المطوّرين الآخرين الذين ترتبط مفاتيحهم بأقل من 50 عملية تثبيت إرسال طلب للحصول على إذن باستخدام اسم الحزمة.

المطوِّر

اسم الحزمة

المفتاح

عمليات التثبيت

C

com.test.2

21

100

D

com.test.2

22

100

E

com.test.2

23

10

في هذه الحالة، لا يملك أي مفتاح أغلبية. يمكن للمطوّرين C وD تسجيل اسم الحزمة إذا كان لديهما 50 عملية تثبيت أو أكثر. على المطوّر (هـ) استخدام اسم حزمة مختلف أو طلب الإذن باستخدام هذا الاسم.

الأسبقية في استخدام المفاتيح التي تم تثبيتها أقل من 50 مرة:

إذا لم يستوفِ أي من المفاتيح الحدّ الأدنى البالغ 50 عملية تثبيت، يمكن تسجيل أي مفتاح وفقًا لمبدأ الأسبقية. وبمجرد أن يسجّل أحد المطوّرين اسم الحزمة، سيكون على المطوّرين الآخرين استخدام اسم مختلف لأسماء الحِزم (أو طلب استثناءات).

المطوِّر

اسم الحزمة

المفتاح

عمليات التثبيت

F

com.test.3

31

10

G

com.test.3

31

10

في هذا السيناريو، يكون جميع المطوّرين الذين لديهم مفاتيح مؤهّلين. بعد تسجيل مطوّر واحد لاسم الحزمة، يجب أن يطلب المطوّر الآخر الحصول على إذن.