وقّع تطبيق iOS: الشهادات وملفات التعريف وطلب إعداد AppPresser
Publish and Grow · مستندات AppPresser
وقّع تطبيق iOS: الشهادات وملفات التعريف وطلب إعداد AppPresser
تغيّرت النسخة الإنجليزية من هذه المقالة منذ ترجمتها، لذا قد تكون هذه الترجمة غير محدّثة.
الغرض من هذا
لا تسمح Apple لتطبيق بالعمل على iPhone إلا إن حمل "توقيعًا" رقميًا يثبت من صنعه. فكّر فيه كظرف مختوم بختم شركتك. دون الختم، ترفض أجهزة iPhone فتح التطبيق.
لوضع ذلك الختم على تطبيقك، تحتاج Apple بضعة ملفات وتفاصيل من حساب Apple Developer. يتحقق AppPresser منها قبل بناء تطبيق iOS. إن نقص أي منها، يمكنك طلب فريق AppPresser إعدادها لك.
يبيّن هذا المقال كيفية:
- التحقق مما إذا كان إعداد iOS جاهزًا.
- فهم معنى النتائج.
- طلب فريق AppPresser إعداد شهاداتك.
- إضافة أو استبدال ملفات التعريف.
- التحقق مرة أخرى، والبناء.
لماذا لا يمكن أن يبدأ بناء iOS بعد
لا يمكن بناء تطبيق iOS حتى تكون شهاداتك وملفات التعريف جاهزة. حتى ذلك الحين، يعرض كل بناء iOS في صفحة Builds (Development وAd Hoc وApp Store) Not Validated، ولن يعمل البناء. هذا طبيعي لتطبيق جديد، ولا يعني أن شيئًا خاطئ في التطبيق الذي صممته.
Android مختلف. بناءات Android لا تحتاج شهادات Apple، لذا يمكنك بناء تطبيق Android واختباره أثناء انتظار إعداد iOS.
بمجرد إكمال الخطوات أدناه وعرض Validate Setup أن كل شيء جاهز، يمكن أن تبدأ بناءات iOS.
كلمات ستراها
لا تحتاج لحفظ هذه. عد هنا كلما كانت كلمة غير واضحة.
حساب Apple Developer (Apple Developer Program) عضويتك المدفوعة مع Apple التي تتيح وضع تطبيقات على أجهزة iPhone وفي App Store. تتقاضى Apple 99 دولارًا أمريكيًا سنويًا (قد تختلف الأسعار حسب البلد). تسجّل الدخول إليها في developer.apple.com.
حساب Apple (Apple ID) البريد وكلمة المرور اللذان تستخدمهما مع Apple. عضوية Apple Developer مرتبطة بحساب Apple واحد.
Organization أو Individual الطريقتان للانضمام إلى Apple Developer Program. Organization تعني شركة أو كيانًا قانونيًا آخر. Individual تعني شخصًا أو مالكًا فرديًا. يأتي اسم البائع لتطبيقك في App Store من هذا. يسأل النموذج أيهما لديك.
App Store Connect موقع Apple لإدارة تطبيقاتك في App Store: قوائم المتجر وإصدارات الاختبار والإرسالات. تسجّل الدخول في appstoreconnect.apple.com بنفس حساب Apple.
اسم مستخدم App Store Connect عنوان بريد حساب Apple الذي تستخدمه لتسجيل الدخول إلى App Store Connect.
المصادقة الثنائية خطوة أمان إضافية. عند تسجيل الدخول، ترسل Apple رمزًا إلى هاتفك أو جهاز Apple آخر، وتكتبه. تطلبه Apple لحسابات المطوّرين.
App-specific password كلمة مرور منفصلة تصنعها Apple لك، لخدمة خارجية واحدة فقط. تتيح لتلك الخدمة تسجيل الدخول إلى حساب Apple دون معرفة كلمة مرورك الحقيقية. يمكنك حذفها في أي وقت. تصنع واحدة في account.apple.com (الخطوات أدناه).
معرّف فريق Apple رمز من 10 أحرف (حروف وأرقام، مثل AB12CD34EF) تعطيه Apple لعضوية المطوّر. يشبه رقم حساب لفريق المطوّرين.
اسم فريق Apple اسم فريق المطوّرين كما تعرضه Apple. عادةً اسم شركتك أو اسمك.
الشهادة بطاقة هوية رقمية تثبت أنك (أو شركتك) صنعت التطبيق. هناك نوعان: – شهادة التطوير: يُستخدم لإصدارات الاختبار التي تعمل على هواتفك. – شهادة التوزيع: يُستخدم للإصدارات التي تشاركها مع المختبرين (Ad Hoc) أو ترسلها إلى App Store.
ملف .p12 (شهادة مع مفتاحها الخاص)
ملف واحد يجمع شهادتك مع "مفتاحها الخاص" السرّي. الشهادة وحدها مثل النصف العام للتوقيع، والمفتاح الخاص هو النصف الذي يجب أن تحتفظ به وحدك. لا يمكن توقيع التطبيقات إلا عندما يكون النصفان معًا، لذا .p12 هو الملف الذي تحتاجه خدمة البناء فعليًا. بعض الأمور لمعرفتها:
- تسمح Apple بتنزيل جزء الشهادة فقط (ملف .cer). يُصنع المفتاح الخاص على الجهاز الذي طلب الشهادة، لذا يجب تصدير .p12 من ذلك الجهاز (على Mac، من تطبيق Keychain Access).
- عند تصدير .p12، تختار كلمة مرور له. أي شخص يرفع الملف سيحتاج أيضًا تلك كلمة المرور، فاحتفظ بالاثنين معًا في مكان آمن، مثل مدير كلمات المرور.
- عامل .p12 كمفتاح لتطبيقك. لا ترسله بالبريد ولا تنشره علنًا.
- إذا فُقد .p12، لا يمكنك إعادة تنزيله من Apple. تصنع شهادة جديدة بدلًا من ذلك.
- سترى .p12 في موضعين: شهادات التوقيع (تطوير وتوزيع) وشهادة الدفع.
ملف التعريف تصريح من Apple. يقول أي تطبيق، من أي فريق، قد يعمل على أي أجهزة iPhone. هناك ثلاثة أنواع: – ملف تعريف Development: لبناءات الاختبار على هواتفك المسجّلة. – ملف تعريف Ad Hoc: لمشاركة إصدار اختبار مع قائمة صغيرة من الهواتف المسجّلة، دون App Store. – ملف تعريف App Store: للإصدار الذي ترسله إلى App Store.
أجهزة اختبار مسجّلة أجهزة iPhone أخبرت Apple عنها (بمعرّف الجهاز) حتى تتمكّن من تثبيت بناءات Development وAd Hoc.
شهادات الدفع ملفات تتيح لتطبيقك استقبال إشعارات الدفع (الرسائل المنبثقة التي ترسلها من AppPresser). جزء من إعداد Apple نفسه، ولهذا يقول نموذج AppPresser "Signing and Push Certificates."
Development Build, Ad Hoc Build, App Store Build أنواع بناء iOS الثلاثة في صفحة Builds. Development لهواتف الاختبار الخاصة بك. Ad Hoc لمجموعة هواتف اختبار مسجّلة. App Store هو الإصدار الذي ترسله إلى Apple لـ App Store.
Validate Setup and Re-Validate أزرار في صفحة Builds. تتحقق مما إذا كان كل ما تحتاجه Apple جاهزًا، قبل أن تقضي وقتًا في بناء. لا تبني شيئًا، ولا تغيّر شيئًا. Re-Validate هو نفس الفحص، يُشغَّل مرة أخرى بعد إصلاح شيء.
Bitrise خدمة البناء التي يستخدمها AppPresser خلف الكواليس لتحويل تطبيقك إلى ملف لأجهزة iPhone. لا تحتاج حساب Bitrise خاصًا. يذكر طلب الإعداد بـ 99 دولارًا ذلك لأن فريق AppPresser يضبطه لك.
ماذا تعني رسائل "Missing …"
بعد التحقق، قد ترى أسطرًا كهذه. بكلمات بسيطة:
Swipe sideways to see the rest of this table.
| الرسالة على الشاشة | معناها |
|---|---|
| Missing APP_DEVELOPMENT_TEAM environment variable. | ليس لدى AppPresser معرّف فريق Apple بعد. |
| Missing APP_STORE_TEAM_NAME environment variable. | ليس لدى AppPresser اسم فريق Apple بعد. |
| Missing APP_DEVELOPMENT_PROFILE environment variable. | ليس لدى AppPresser ملف تعريف Development في الملف. |
| Missing APP_ADHOC_PROFILE environment variable. | ليس لدى AppPresser ملف تعريف Ad Hoc في الملف. |
| Missing APP_RELEASE_PROFILE environment variable. | ليس لدى AppPresser ملف تعريف App Store في الملف. |
| Missing valid development certificate. | لا توجد شهادة تطوير صالحة (لا شيء بعد، أو انتهت). |
| Missing valid distribution certificate. | لا توجد شهادة توزيع صالحة (لا شيء بعد، أو انتهت). |
| Missing valid development provisioning profile. | ملف تعريف Development مفقود أو منتهٍ. |
| Missing valid Ad Hoc provisioning profile. | ملف تعريف Ad Hoc مفقود أو منتهٍ. |
| Missing valid App Store provisioning profile. | ملف تعريف App Store مفقود أو منتهٍ. |
| Missing APP_STORE_USERNAME secret for App Store authentication. | ليس لدى AppPresser اسم مستخدم App Store Connect الذي يحتاجه لإرسال تطبيقك إلى Apple. |
| Missing APP_SPECIFIC_PW secret for App Store authentication. | ليس لدى AppPresser كلمة المرور الخاصة بالتطبيق التي يحتاجها لإرسال تطبيقك إلى Apple. |
"متغير البيئة" أو "السرّ" ببساطة إعداد محفوظ يستخدمه البناء. "السرّ" إعداد محفوظ يُبقى مخفيًا، مثل كلمة مرور.
قبل أن تبدأ
جهّز هذه:
- عضوية مدفوعة في Apple Developer Program (99 دولارًا أمريكيًا سنويًا، كـ Organization أو Individual). إن لم يكن لديك واحدة، انظر مقال إعداد Apple عن التسجيل أولًا.
- بريد حساب Apple وكلمة مروره الذي يملك العضوية.
- هاتفك قريبًا. تستخدم Apple المصادقة الثنائية، لذا ستحصل على رموز تسجيل دخول. قد يحتاج فريق AppPresser أيضًا رمزًا منك لاحقًا (انظر حقل Timezone أدناه).
- وصول مسؤول إلى App Store Connect، حتى تتمكن من إضافة فريق دعم AppPresser كمستخدم.
- طريقة دفع في حساب AppPresser، إن طلبت من فريق AppPresser تنفيذ الإعداد (99 دولارًا لكل طلب، انظر أدناه).
- تطبيقك مفتوح في AppPresser. في الشريط الجانبي، ضمن Publishing، انقر Builds.
الخطوة 1: تحقق من إعداد iOS (Validate Setup)
- في صفحة Builds، اعثر على بطاقة iOS . تقول "Validate your setup before building."
- يعرض كل نوع بناء (Development Build وAd Hoc Build وApp Store Build) Not Validated و"Run validation to check setup."
- انقر Validate Setup في أعلى بطاقة iOS.
- يتغيّر الزر إلى Validating… وتصبح أزرار Build رمادية لبضع ثوانٍ. انتظر.
نصيحة: إذا نقرت زر Build قبل التحقق، يشغّل AppPresser الفحص أولًا بدل بدء بناء. هذا متوقع، لم يُبنَ شيء بعد.
الخطوة 2: اقرأ النتائج
عند انتهاء الفحص:
- إذا كان كل شيء جاهزًا، يصبح كل نوع بناء جاهزًا للبناء. (لم نرَ شاشة "all passed" هذه بعد على staging.)
- إذا نقص شيء، تقول البطاقة "Some checks failed. Review issues before building."، يتغيّر الزر إلى Re-Validate، ويعرض كل نوع بناء تسمية حمراء Issues Found مع قائمة مشاكل.
في تطبيق جديد تمامًا بلا إعداد، سترى:
- Development Build: 4 issues. Team ID، ملف تعريف Development، شهادة تطوير، ملف تعريف تطوير.
- Ad Hoc Build: 4 issues. Team ID، ملف تعريف Ad Hoc، شهادة توزيع، ملف تعريف Ad Hoc.
- App Store Build: 7 issues. Team ID، اسم الفريق، ملف تعريف App Store، شهادة توزيع، ملف تعريف App Store، اسم مستخدم App Store، كلمة المرور الخاصة بالتطبيق.
تحت كل قائمة روابط تفتح الإصلاح المناسب:
- شهادات توقيع ودفع iOS: اطلب من فريق AppPresser إعداد الشهادات (الخطوة 3).
- ملفات التعريف: ارفع ملفات تعريف Development أو Ad Hoc (الخطوة 4).
- App Store submission credentials (App Store Build فقط): تصف قائمة Repair Utilities ذلك بـ "Update the Apple ID or app-specific password used for automatic App Store submissions."
نفس الأدوات الثلاث مدرجة أيضًا في أسفل صفحة Builds ضمن Repair Utilities.
لاحظ أيضًا: بعد فحص فاشل، قد تفتح نافذة iOS App Signing and Push Certificates بنفسها. هذا هو النموذج في الخطوة 3.
الخطوة 3: اطلب من فريق AppPresser إعداد شهاداتك
يمكن لفريق AppPresser إنشاء شهاداتك وإعداد خدمة البناء لك. تملأ نموذجًا واحدًا، وتمنح الفريق وصولًا إلى App Store Connect، وتوافق على رسوم 99 دولارًا.
3a. افتح النموذج
- تحت أي نوع بناء iOS فيه مشاكل، انقر شهادات توقيع ودفع iOS. (أو مرّر إلى Repair Utilities وانقر شهادات توقيع ودفع iOS.)
- تفتح نافذة تسمى iOS App Signing and Push Certificates، مع السطر "Request certificate setup or renewal when iOS signing certificates are missing or expired."
- مربع أصفر، Validation needs attention، يكرر ما ينقص.
- اقرأ السطر تحته: "Our team can manage your app's iOS build and push certificates. After you submit a request, someone from our team will reach out to handle your setup within 1-2 business days."
3b. املأ كل حقل
Apple account type 1. اختر Organization أو Individual من القائمة. 2. غير متأكد؟ انقر How do I check? بجانب الحقل. يقول: سجّل الدخول إلى حساب Apple Developer، واختر فريق تطبيقك إن طُلب، وافتح Membership details، وانظر إلى Entity Type. اختر Organization لـ "Company / Organization"، أو Individual لـ "Individual / Sole Proprietor".
اسم مستخدم App Store Connect 1. اكتب عنوان البريد الذي تستخدمه لتسجيل الدخول إلى App Store Connect.
App Store Connect password 1. اكتب كلمة مرور حساب Apple ذلك. يلاحظ النموذج أنها "Stored temporarily for certificate setup."
App-specific password 1. اصنع كلمة مرور خاصة بالتطبيق لدى Apple (الخطوات أدناه)، ثم الصقها هنا.
كيفية صنع كلمة مرور خاصة بالتطبيق (خطوات Apple): 1. انتقل إلى account.apple.com وسجّل الدخول. 2. في Sign-In and Security، اختر App-Specific Passwords. 3. اختر Generate an app-specific password، أعطِه اسمًا تتعرّف عليه (مثل "AppPresser")، واتبع الخطوات. 4. انسخ كلمة المرور التي تعرضها Apple والصقها في النموذج.
من المفيد معرفة: يحتاج حساب Apple إلى تفعيل المصادقة الثنائية لصنع واحدة. إذا غيّرت كلمة مرور Apple الرئيسية، تلغي Apple كل كلمات المرور الخاصة بالتطبيق، وستحتاج لصنع واحدة جديدة.
معرّف فريق Apple 1. سجّل الدخول في developer.apple.com وافتح حسابك. 2. انقر Membership details. إن كنت تنتمي لأكثر من فريق، اختر الفريق الصحيح أولًا. 3. انسخ Team ID (10 أحرف وأرقام) والصقه هنا.
اسم فريق Apple 1. في صفحة Membership details نفسها، انسخ اسم فريقك تمامًا كما تعرضه Apple، والصقه هنا.
Timezone 1. اختر منطقتك الزمنية. يشرح النموذج: "We may need an SMS verification code. Your timezone helps us arrange a suitable time." بمعنى آخر، قد ترسل Apple رمزًا نصيًا إلى هاتفك عندما يسجّل الفريق الدخول، وسيحتاجون منك قراءته لهم.
3c. امنح AppPresser وصولًا إلى App Store Connect
يحتاج الفريق وصوله الخاص إلى حساب App Store Connect لإنشاء الشهادات. منحهم تسجيل مستخدم آمن أكثر من مشاركة حسابك، ويمكنك إزالته لاحقًا.
- سجّل الدخول في appstoreconnect.apple.com.
- افتح Users and Access. (تحتاج دور Account Holder أو Admin أو App Manager لإضافة أشخاص.)
- ضمن People، انقر plus (+) .
- أدخل الاسم الأول واسم العائلة والبريد support@apppresser.com.
- اختر الدور والوصول الذي يحتاجه فريق AppPresser، بما في ذلك الوصول إلى Certificates, Identifiers & Profiles.
- انقر Next، ثم Invite. تنتهي دعوات Apple بعد 3 أيام، فافعل هذا قرب وقت إرسال النموذج.
- عد إلى نموذج AppPresser، وضع علامة على "I've added support@apppresser.com to App Store Connect with certificate access."
3d. وافق على رسوم 99 دولارًا
- اقرأ المربع البرتقالي Certificate setup · $99. يقول: "Certificate creation or renewal and Bitrise configuration are charged separately for reseller accounts."
- ضع علامة على "I authorize AppPresser to charge my current payment method $99 for this certificate creation/renewal and Bitrise configuration request."
3e. أرسل الطلب
- انقر Request certificate setup لإرساله إلى فريق AppPresser.
- أو انقر Save certificate details للاحتفاظ بما كتبته وإرساله لاحقًا.
- انتظر تواصل فريق AppPresser، خلال 1 إلى 2 يوم عمل. أبقِ هاتفك قريبًا إن احتاجوا رمز Apple.
الخطوة 4: أضف أو استبدل ملفات التعريف
استخدم هذا إن كان لديك ملفات تعريف خاصة (تنتهي بـ .mobileprovision)، أو انتهت صلاحية ملف، أو أضفت هواتف اختبار جديدة.
- تحت نوع بناء، انقر ملفات التعريف. (أو في Repair Utilities، انقر ملفات التعريف.)
- تفتح نافذة: Replace iOS Provisioning Profiles، "Replace an expired development or Ad Hoc profile, or add registered test devices."
- يسرد المربع الأصفر أي ملفات تعريف ناقصة ويقول "After making changes, validate again from the Builds page."
- لملف تعريف Development: ضمن ملف تعريف Development، انقر Choose File، اختر الملف، ثم انقر Upload Development Profile.
- لملف تعريف Ad Hoc: ضمن ملف تعريف Ad Hoc، انقر Choose File، اختر الملف، ثم انقر Upload Ad Hoc Profile.
- تبقى أزرار Upload رمادية حتى تختار ملفًا.
الخطوة 5: بعد الإعداد، تحقق مرة أخرى وابنِ
- عندما يخبرك فريق AppPresser أن إعدادك انتهى (أو بعد رفع ملفات التعريف)، افتح Builds مرة أخرى.
- في بطاقة iOS، انقر Re-Validate.
- تحقق من اختفاء المشاكل لنوع البناء الذي تريده.
- انقر Build في ذلك الصف (مثل Development Build لهاتف الاختبار الخاص بك).
- تابع البناء ضمن Recent Builds And Logs.
ماذا لو نقص شيء؟
Swipe sideways to see the rest of this table.
| ما تراه | معناها | ماذا تفعل |
|---|---|---|
| Missing APP_DEVELOPMENT_TEAM | لا معرّف فريق Apple في الملف | اطلب إعداد الشهادات (الخطوة 3) وأدخل Team ID |
| Missing APP_STORE_TEAM_NAME | لا اسم فريق Apple في الملف | اطلب إعداد الشهادات (الخطوة 3) وأدخل اسم فريقك |
| Missing valid development certificate | لا شهادة تطوير صالحة | اطلب إعداد الشهادات (الخطوة 3) |
| Missing valid distribution certificate | لا شهادة توزيع صالحة (مطلوبة لـ Ad Hoc وApp Store) | اطلب إعداد الشهادات (الخطوة 3) |
| Missing APP_DEVELOPMENT_PROFILE or valid development provisioning profile | لا ملف تعريف Development، أو انتهت صلاحيته | ارفع واحدًا (الخطوة 4)، أو ضمّنه في طلب الإعداد |
| Missing APP_ADHOC_PROFILE or valid Ad Hoc provisioning profile | لا ملف تعريف Ad Hoc، أو انتهت صلاحيته، أو هاتف اختبار جديد ليس عليه | ارفع واحدًا (الخطوة 4)، أو ضمّنه في طلب الإعداد |
| Missing APP_RELEASE_PROFILE or valid App Store provisioning profile | لا ملف تعريف App Store | ضمّنه في طلب الإعداد (الخطوة 3). لا يوجد موضع رفع له بعد |
| Missing APP_STORE_USERNAME secret | لا اسم مستخدم App Store Connect لإرسال تطبيقك إلى Apple | استخدم App Store submission credentials تحت App Store Build |
| Missing APP_SPECIFIC_PW secret | لا كلمة مرور خاصة بالتطبيق لإرسال تطبيقك إلى Apple | اصنع واحدة في account.apple.com، ثم استخدم App Store submission credentials |
| يعرض مربع نموذج كلمة “false” | خلل معروف في staging | احذف “false” واكتب القيمة الحقيقية |
| نقرت Build ويقول Validating… | يفحص AppPresser إعدادك قبل أي بناء | انتظر النتائج، ثم اتبع هذا المقال |
| توقفت كلمة المرور الخاصة بالتطبيق عن العمل | غيّرت كلمة مرور Apple الرئيسية، مما يلغي كلمات المرور الخاصة بالتطبيق | اصنع كلمة مرور خاصة جديدة وحدّثها |
- حقول نموذج مملوءة مسبقًا بـ "false" (Username وTeam ID وTeam name وTimezone). AP5-163.
- النقر على Build في صف iOS غير متحقق يشغّل التحقق بصمت. ملاحظة على AP5-043.
- تستخدم رسائل التحقق أسماء إعدادات المطوّر. AP5-164.
- مربع 99 دولارًا يقول "reseller accounts" لكن خانة الاختيار تظهر للجميع. من يدفع؟ AP5-165.
- لا موضع رفع لملف تعريف App Store. AP5-166.
- لا رفع شهادات في أي مكان. هل يمكن للعملاء إعداد الشهادات بأنفسهم، أم فقط عبر طلب 99 دولارًا؟
- رابط "Instructions" (إضافة support@apppresser.com) لم يُفتح. أي دور App Store Connect مطلوب؟
- نافذة "App Store submission credentials" لم تُفتح.
- العنوان يقول "Push Certificates"، لكن النموذج بلا حقل دفع. هل تُنشأ شهادة الدفع (أو مفتاح الدفع من Apple) ضمن طلب الفريق؟ شاشة Push Notifications لها خيارات iOS Managed (99 دولارًا) وManual الخاصة (AP5-095). هل هي نفس 99 دولارًا أم رسوم ثانية؟
- ما الذي يفعّل زرّي Save وRequest، وماذا يحدث بعد الإرسال (بريد، حالة في Builds، متابعة)؟
- لم يُرَ تحقق iOS ناجح أو بناء iOS بعد على staging. أيضًا، أوامر بناء iOS في Bitrise ما زالت تفتقد "staging"، لذا قد تفشل بناءات iOS على staging بعد إصلاح التوقيع.
هل كان هذا مفيدًا؟
تتحدّث النتائج أثناء الكتابة. اضغط الشرطة المائلة للانتقال إلى البحث.
لم تجده؟
يمكن لفريق الدعم المساعدة في الإعداد والبناء وأسئلة المتاجر.








