توقيع التطبيق

قد تختلف إجراءات التوقيع في أنظمة التشغيل، إلا أنها تتبع نفس المنظور. يجب توقيع التطبيقات التي يتم توزيعها لاستخدام الآخرين. على الرغم من قيام ArcGIS AppStudio بتنفيذ توقيع التطبيق وعملية الإنشاء لك، يجب عليك الاستمرار في الحصول على ملفات التوقيع من كل بائعي نظم التشغيل لتقديمها كمدخلات إلى AppStudio.

إعداد تطبيق جديد

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

يجب توفير معرف عميل ArcGIS - يعرف أيضًا باسم AppID - لتسجيل دخول المستخدم المحدد لكل التطبيقات. للحصول على معرف عميل، انتقل إلى https://developers.arcgis.com، وسجل الدخول ببيانات اعتماد المطور، ثم انقر على السهم المنسدل بجانب لوحة المعلومات، واختر تطبيق جديد. بمجرد التسجيل، ستستلم مُعرف العميل، الذي يمكنك نسخه في تطبيق AppStudio. إذا كنت تستخدم ArcGIS AppStudio، يمكن أيضًا إنشاء معرف عميل في الإعدادات > الترخيص بالنقر على زر تسجيل.

إذا تطلب التطبيق تسجيل دخول مستخدم محدد، يجب عليك أيضًا توفير عنوان URI لإعادة التوجيه. تمثل عناوين URI لإعادة التوجيه أماكن صحيحة يمكن إعادة توجيه المستخدم إليها بعد إكمال تسجيل دخول OAuth. لإضافة عنوان URI جديد لإعادة التوجيه في تطبيقك، انتقل إلى علامة تبويب مصادقة في التطبيق على https://developers.arcgis.com. وهنا، سجل تطبيقك إذا لم تكن قد سجلت بالفعل، ثم أضف عنوان URI لإعادة التوجيه أو أضف urn:ietf:wg:oauth:2.0:oob لاستخدام صفحة إعادة التوجيه المستضافة في تطبيقك مجددًا في ArcGIS Online. يتم أيضًا تعيين عنوان URI urn:ietf:wg:oauth:2.0:oob تلقائيًا لأي تطبيقات منشأة ومسجلة في ArcGIS AppStudio.

مطلوب سلسلة ترخيص لإنشاء التطبيقات التي تستخدم الإصدار 100.x من ArcGIS Runtime. يتعذر إنشاء تطبيق دون سلسلة ترخيص، وهو ما يشير إلى وظائف نظام ArcGIS التي يمكن للتطبيق تنفيذها. للحصول على معلومات بشأن كيفية الحصول على سلسلة ترخيص، راجع موضوع ترخيص التطبيق.

توقيع تطبيق iOS الخاص بك

يجب توقيع كل تطبيقات iOS. يجب توقيع التطبيقات المُنشأة بهدف الاختبار من خلال شهادة مُطوّر مرتبطة بحساب مُطوّر Apple الخاص بك والجهاز الذي يجري عليه الاختبار. لا ترتبط شهادة الإنتاج إلا بحساب مُطوّر Apple الخاص بك.

قبل تشغيل أداة Make في اللوحة الجانبية للمعرض في AppStudio، سواء كان الإصدار سحابي أو محلي، في AppStudio، تأكد من توفير التالي في علامة تبويب iOS في الإعدادات، التي توجد أسفل عنوان الأنظمة الأساسية:

• مُعرف المجموعة - استخدم اسم مجال إنترنت عكسي دائمًا، مثل com.companyname.applicationname. اسم الحزمة هو مُعرّف فريد للتطبيق، وهو الاسم الافتراضي لعملية التطبيق. بمجرد نشر التطبيق، يتعذر عليك تغيير اسم الحزمة. لمزيد من التفاصيل، راجع شرح معرف الحزمة في موضوعالإعداد لتوزيع التطبيق.
• الملف التعريفي للتوفير - يُشير إلى الأجهزة التي تخطط لتشغيل تطبيقك عليها.
• شهادة (ملف .p12) - شهادة لـ App Store أو التوزيع الداخلي. يتم إنشاء هذا الملف في Keychain Access. إذا لم توفر هذه المعلومات ومعرف الحزمة في AppStudio، لن يتم إنشاء ملفات التثبيت. لمزيد من المعلومات، راجع موضوع ما هو توقيع التطبيق؟

في وقت تشغيل أداة Make ، سيُطلب منك تقديم كلمة مرور الشهادة.

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

1. تنزيل شهادة المُطوّر (على سبيل المثال، ios_developer.cer) من مركز iOS Dev.
2. تنزيل الملف التعريفي لتوفير الجوال (على سبيل المثال، ios_developer.mobileprovision) من مركز iOS Dev.
3. استخدم أداة البحث للاستعراض إلى التطبيقات > الأدوات المساعدة > Keychain Access.
4. استيراد الشهادة إلى Keychain Access.
5. في Keychain Access، من قائمة Keychain اختر تسجيل الدخولومن قائمة الفئة اختر الشهادات. اختر الشهادة المُسمّاة مُطور الهاتف: الاسم وقم بتصدير الشهادة بالمفتاح الخاص بكلمة مرور (على سبيل المثال، john_doe_private_key.p12).

   تم إنشاء ملف الشهادة.

6. في AppStudio، استعرض إلى الإعدادات > الأنظمة > iOS.
7. قم بتعيين مسار ملف تعريف التوفير.
8. قم بتعيين نوع التوزيع لتطبيقك. لمزيد من المعلومات حول الخيارات، راجع وثائق Xcode حول طرق التوزيع.

ملاحظة:‏

انقر نقرًا مزدوجًا فوق ملف شهادة .p12 وملف تعريف التوفير للهاتف المحمول لاستيراد الملفات.

إذا كنت تستخدم AppStudio على macOS، فيجب تعيين خاصيتين إضافيتين لإنشاء تطبيقات iOS باستخدام الإصدار المحلي لأداة Make. يمكن العثور على محتويات هذه الحقول في شهادة التطوير أو التوزيع، حيث يمكن الاطلاع عليها باستخدام أداة البحث للاستعراض إلى التطبيقات > الأدوات المساعدة > Keychain Access.

قدم الوحدة التنظيمية للشهادة في حقل معرف الفريق.

قدم الاسم الشائع للشهادة في حقل هوية توقيع التعليمات البرمجية.

توقيع تطبيق Android الخاص بك

لإعداد إنشاء إصدار Android، يجب إنشاء ملف مستودع شهادات توقيع أولاً. لمعلومات تفصيلية عن كيفية إنشاء الملف، راجع وثائق Android.

قبل تشغيل أداة Make، سواء كان الإصدار سحابي أو محلي، تأكد من توفير التالي في علامة تبويب Android في الإعدادات، التي توجد في عنوان الأنظمة:

• اسم الحزمة - استخدم اسم مجال إنترنت عكسي دائمًا، مثل com.companyname.applicationname. اسم الحزمة هو مُعرّف فريد للتطبيق، وهو الاسم الافتراضي لعملية التطبيق. بمجرد نشر التطبيق، يتعذر عليك تغيير اسم الحزمة. لمزيد من التفاصيل، راجع شرح اسم الحزمة في عنصر البيان لـ Android SDK.
• مسار ملف Keystore - موقع ملف Keystore على جهاز سطح المكتب.
• الاسم المستعار للمفتاح - الاسم المُنشأ عند إنشاء keystore.

إذا لم توفّر هذه المعلومات، سيتم أيضًا إنشاء ملفات التثبيت، إلا أنه سيتم إلغاء توقيعها. يمكن تثبيت الملفات غير الموقعة لأغراض الاختبار، ولكن يتعذر إرسالها إلى متجر Google Play أو Amazon Appstore.

في وقت تشغيل أداة Make ، سيُطلب منك تقديم keystore وكلمات مرور أساسية.

لإنشاء keystore، يجب على كل مُطوّر تنفيذ الخطوات التالية لمرة واحدة:

1. قم بتنزيل وتثبيت حزمة تطوير الجافا (JDK) من https://www.oracle.com/technetwork/java/javase/downloads/index.html.
2. إنشاء متغير بيئة باسم JAVA_HOME على جهاز سطح المكتب https://docs.oracle.com/cd/E19182-01/820-7851/inst_cli_jdk_javahome_t/index.html.
3. أضف مسار مجلد سلة JDK إلى متغير بيئة PATH.
4. في نافذة الأوامر، استخدام التالي لإنشاء المفتاح: keytool -genkey -v -keystore [keystore_name].keystore -alias [alias_name] -keyalg RSA -keysize 2048 -validity 10000 حيث يكون keystore_name هو الاسم الذي اخترته لملف keystore الناتج، ويكون alias_name هو الاسم الذي اخترته كاسم مستعار.
5. أدخل كلمة مرور keystore، وقم بالتأكيد.
6. أدخل المعلومات الإضافية وقم بالتأكيد.
7. أدخل كلمة مرور أساسية. يمكن أن تكون كلمة المرور فريدة، أو اضغط على إدخال لاستخدام نفس كلمة المرور ككلمة مرور keystore.

   سيتم إنشاء ملف keystore الخاص بك في المجلد حيث قمت بتشغيل هذا الأمر.

توقيع تطبيق macOS الخاص بك

بالمثل في Android، إذا لم تقم بتوفير شهادة عند طلب ملفات تثبيت macOS، سيتم إنشائها، ولكنها ستكون غير موقعة. يمكن تثبيت الملفات غير الموقعة لأغراض الاختبار، ولكن يتعذر إرسالها إلى متجر Mac. تتوافق الخطوات التالية مع iOS، على الرغم من ملف التوفير التعريفي الغير مطلوب لـ macOS. لمزيد من المعلومات، راجع موضوع ما هو توقيع التطبيق؟

قبل تشغيل أداة Make، سواء كان الإصدار سحابي أو محلي، تأكد من توفير التالي في علامة تبويب macOS في الإعدادات، التي توجد في عنوان الأنظمة:

• مُعرف المجموعة - استخدم اسم مجال إنترنت عكسي دائمًا، مثل com.companyname.applicationname. اسم الحزمة هو مُعرّف فريد للتطبيق، وهو الاسم الافتراضي لعملية التطبيق. بمجرد نشر التطبيق، يتعذر عليك تغيير اسم الحزمة. لمزيد من التفاصيل، راجع شرح معرف الحزمة في موضوعالإعداد لتوزيع التطبيق.
• شهادة (ملف .p12) - شهادة لـ App Store أو التوزيع الداخلي. يتم إنشاء هذا الملف في Keychain Access. إذا لم توفر هذه المعلومات ومعرف الحزمة في AppStudio، لن يتم إنشاء ملفات التثبيت. لمزيد من المعلومات، راجع موضوع ما هو توقيع التطبيق؟

في وقت تشغيل أداة Make ، سيُطلب منك تقديم كلمة مرور الشهادة.

لإنشاء ملف الشهادة المطلوب لتسجيل الدخول إلى تطبيق macOS، اتبع نفس الخطوات كما هو موصوف سابقًا لتطبيقات iOS.

توقيع تطبيق Windows الخاص بك

بالمثل في Android، إذا لم تقم بتوفير شهادة عند طلب ملفات تثبيت Windows، سيتم إنشائها، ولكنها ستكون غير موقعة.

قبل تشغيل أداة Make، سواء كان الإصدار سحابي أو محلي، تأكد من توفير ملف شهادة في علامة تبويب Windows في الإعدادات، التي توجد في عنوان الأنظمة: هذه الشهادة (ملف .p12 أو .pfx) - شهادة لمتجر Windows أو التوزيع الداخلي. راجع موضوع إنشاء شهادة لتوقيع الحزمة في وثائق مطور Microsoft لمزيد من المعلومات.