Ad Hoc Distribution — ما هو، قيود اختبار iOS

ما هو Ad Hoc Distribution؟

Ad Hoc Distribution هي طريقة لتوزيع تطبيقات iOS متاحة لجميع أعضاء Apple Developer Program (99$/سنة). تسمح بتثبيت التطبيقات مباشرة على الأجهزة دون المرور بمراجعة App Store. الغرض الرئيسي هو الاختبار قبل الإصدار: يمكن للمطورين والمختبرين والعملاء تثبيت التطبيق على أجهزتهم قبل الإصدار الرسمي.

يستخدم Ad Hoc Distribution ملف تعريف تزويد (Provisioning Profile) يتضمن قائمة بأجهزة UDID المسموح بها. عند توقيع التطبيق، ينشئ Xcode أو Fastlane ملف IPA يمكن تثبيته فقط على الأجهزة الموجودة في هذه القائمة. كل UDID يُضاف عبر Apple Developer Portal، ولا يمكن أن يتجاوز الإجمالي 100 جهاز لكل حساب مطور.

وفقاً لـ Apple (2025)، لا يزال Ad Hoc Distribution مطلوباً لـ الاختبار قبل الإصدار عندما لم يجتاز التطبيق بعد مراجعة App Store ولكن يلزم عرضه على العميل أو اختباره على أجهزة حقيقية. ومع ذلك، توصي Apple باستخدام TestFlight للاختبار التجريبي الواسع النطاق، تاركة Ad Hoc للمجموعات الصغيرة والحالات الخاصة.

كيف يعمل توزيع Ad Hoc؟

يعمل توزيع Ad Hoc من خلال التثبيت عبر الهواء (OTA) أو عبر iTunes/Finder. ينشئ المطور ملف تعريف تزويد Ad Hoc مع UDID المحددة، ويوقع التطبيق بهذا الملف التعريفي، ويصدر ملف IPA. يقوم المستخدم بتثبيت التطبيق عبر Safari من خلال رابط أو عبر Finder على macOS.

من الناحية الفنية، يتضمن توزيع Ad Hoc عدة مراحل. أولاً، يجمع المسؤول UDID لأجهزة الاختبار — كل UDID هو معرف فريد مكون من 40 حرفاً لجهاز iOS. ثم تُضاف UDID إلى Apple Developer Portal، ويُنشأ ملف تعريف تزويد، ويُولد IPA موقع. صلاحية ملف تعريف Ad Hoc هي سنة واحدة، وبعدها تتوقف التطبيقات عن الفتح.

# Fastlane — أتمتة توزيع Ad Hoc
lane :adhoc do
    match(type: "adhoc")
    gym(scheme: "MyApp",
        export_method: "ad-hoc")
    pilot(
        distribute_only: true,
        devices_file: "./devices.txt"
    )
end

لتثبيت تطبيق Ad Hoc، يجب على المستخدم الوثوق بشهادة المطور على جهازه. للقيام بذلك، في إعدادات iOS انتقل إلى «عام» ← «VPN وإدارة الجهاز» ← «الملف التعريفي» واضغط «وثوق». بدون هذه الخطوة، لن يبدأ التطبيق.

تسجيل UDID والحد الأقصى 100 جهاز

UDID (معرف الجهاز الفريد) هو معرف فريد لكل جهاز iOS. لتوزيع Ad Hoc، تحتاج إلى جمع UDID لجميع أجهزة الاختبار وإضافتها إلى Apple Developer Portal. الحد الأقصى هو 100 جهاز لكل حساب مطور سنوياً. ينطبق هذا الحد على جميع تطبيقات المطور، وليس على كل تطبيق على حدة.

يتم إعادة تعيين حد 100 جهاز في نهاية السنة التقويمية — تتم إعادة التعيين في 1 يناير. ومع ذلك، توصي Apple باستخدام TestFlight للاختبار على نطاق واسع، الذي يدعم حتى 10 000 مختبر خارجي. يظل Ad Hoc Distribution منذ 2022 مناسباً للحالات التي لم يجتاز فيها التطبيق بعد مراجعة Beta App أو عندما يتطلب الاختبار الوصول إلى ملف IPA الأصلي.

إعداد Ad Hoc Distribution

يتم إعداد Ad Hoc Distribution من خلال Apple Developer Portal وXcode. تتضمن العملية تسجيل الأجهزة وإنشاء ملف تعريف تزويد وتوقيع التطبيق وتصدير IPA للتوزيع. للتطوير الجماعي، يُوصى باستخدام Fastlane أو الأتمتة عبر CI/CD.

1. جمع UDID لأجهزة الاختبار عبر udid.io أو ملف تعريف إعدادات
2. إضافة UDID إلى Apple Developer Portal ← Certificates, Identifiers & Profiles ← Devices
3. إنشاء ملف تعريف تزويد Ad Hoc لمعرف الحزمة المطلوب، متضمناً الأجهزة المسجلة
4. توقيع التطبيق بملف تعريف Ad Hoc في Xcode: Product ← Archive ← Distribute Ad Hoc
5. تصدير ملف IPA وتوزيع الرابط عبر خادم OTA أو Firebase App Distribution
6. للمستخدم: فتح الرابط على الجهاز، تثبيت التطبيق، الوثوق بالشهادة في الإعدادات

لتبسيط العملية، تُستخدم خدمات التوزيع: Firebase App Distribution وMicrosoft App Center وBuddyBuild. تدير هذه الخدمات UDID تلقائياً، وتنشئ ملفات تعريف Ad Hoc، وترسل دعوات للمختبرين. يتكامل Firebase App Distribution أيضاً مع خطوط أنابيب CI/CD عبر Gradle أو Fastlane.

فارق مهم — تحديث UDID. إذا كنت بحاجة إلى إضافة جهاز جديد إلى الملف التعريفي، فسيتعين عليك إعادة إنشاء ملف تعريف التزويد وإعادة توقيع التطبيق. الأجهزة التي قامت بالفعل بتثبيت التطبيق ستستمر في استخدامه حتى انتهاء صلاحية الملف التعريفي (سنة واحدة). بعد ذلك، يلزم إعادة تثبيت بملف تعريفي جديد.

Ad Hoc مقابل TestFlight وEnterprise

Ad Hoc Distribution هي واحدة من ثلاث طرق لتوزيع تطبيقات iOS بدون App Store. TestFlight (مجاني، حتى 10 000 مختبر خارجي) وEnterprise Distribution (بدون حد للأجهزة، للتطبيقات المؤسسية) تحل مهاماً مشابهة مع قيود ومتطلبات مختلفة.

TestFlight هي الطريقة المفضلة من Apple للاختبار التجريبي. لا تتطلب جمع UDID، وتدعم حتى 100 مختبر داخلي و10 000 مختبر خارجي، وتدير الإصدارات تلقائياً، وتوفر تحليلات التثبيت. ومع ذلك، يتطلب TestFlight اجتياز مراجعة Beta App للمختبرين الخارجيين، مما قد يستغرق 1–2 يوم. Ad Hoc Distribution لا يتطلب أي مراجعة.

Enterprise Distribution مناسبة لـ التطبيقات المؤسسية بعدد غير محدود من الأجهزة، ولكنها تتطلب التسجيل في Apple Developer Enterprise Program (299$/سنة) مع رقم D-U-N-S. Ad Hoc متاح لجميع أعضاء البرنامج القياسي (99$/سنة) ولا يتطلب التحقق القانوني للشركة. للفرق الصغيرة والمشاريع، يظل Ad Hoc أبسط طريقة للتوزيع بدون App Store.