حتى الآن عمل Trailhead عبر Expo Go والـ development builds، مع حاسوبك المحمول يقدّم كود JavaScript. أما المستخدمون الحقيقيون فيحتاجون إلى شيء آخر: تطبيق يُثبَّت من متجر، ويبدأ دون خادم تطوير، وموقَّع بحيث يثق به هاتفهم. يصنع EAS Build هذه الـ builds في السحابة، فلا تحتاج إلى Mac من أجل iOS، ويرفعها EAS Submit إلى المتاجر.
\nقبل أول build، احسم بضعة حقول:
\n{\n \"expo\": {\n \"name\": \"Trailhead\",\n \"slug\": \"trailhead\",\n \"version\": \"1.0.0\",\n \"scheme\": \"trailhead\",\n \"icon\": \"./assets/images/icon.png\",\n \"ios\": { \"bundleIdentifier\": \"com.example.trailhead\" },\n \"android\": { \"package\": \"com.example.trailhead\" }\n }\n}معرّف الحزمة (bundle identifier في iOS) واسم الحزمة (package name في Android) هما الهوية الدائمة لتطبيقك في المتاجر. غيّرهما بعد النشر فيرى المتجر تطبيقًا مختلفًا: لا تحديثات للمستخدمين الحاليين، ولا انتقال للمراجعات. استخدم نطاقًا معكوسًا تملكه.
\nهناك نوعان من الإصدارات. version هو ما يراه المستخدمون (“1.0.0”)؛ وترفعه مع كل إصدار عام. وكل رفع يحتاج أيضًا إلى رقم داخلي فريد ومتزايد (رقم البناء في iOS، ورمز الإصدار في Android). دع EAS يدير هذه الأرقام نيابةً عنك، كما سترى أدناه.
ثبّت الـ CLI، وسجّل الدخول إلى حساب Expo، وولّد ملف الإعدادات:
\nnpm install -g eas-cli\neas login\neas build:configureهذا ينشئ eas.json بثلاثة profiles:
{\n \"cli\": { \"appVersionSource\": \"remote\" },\n \"build\": {\n \"development\": { \"developmentClient\": true, \"distribution\": \"internal\" },\n \"preview\": { \"distribution\": \"internal\" },\n \"production\": { \"autoIncrement\": true }\n },\n \"submit\": { \"production\": {} }\n}eas device:create، لأن هذه builds من نوع ad hoc.appVersionSource: "remote" وautoIncrement، يخزّن EAS رقم البناء ويرفعه مع كل production build.ثم ابنِ:
\neas build --platform android --profile preview\neas build --platform all --profile productionيعمل البناء على خوادم EAS؛ ويطبع الـ CLI رابطًا إلى السجلّات، وفي النهاية رابطًا إلى الـ build نفسه.
\nكل build قابل للتثبيت يكون موقَّعًا. يحتاج iOS إلى شهادة توزيع (distribution certificate) وملف تجهيز (provisioning profile)؛ ويحتاج Android إلى upload keystore. يستطيع EAS توليدها وتخزينها وإعادة استخدامها مع كل build؛ ويسألك الـ CLI في المرة الأولى. ولـ iOS تحتاج إلى عضوية مدفوعة في Apple Developer Program؛ ولـ Google Play إلى رسم تسجيل مطوّر يُدفع مرة واحدة. وتعامل مع الـ keystore الخاص بـ Android بحرص: EAS يحتفظ به لك، لكن إن أدرته بنفسك وأضعته، يصبح تحديث التطبيق مؤلمًا.
\nأنشئ أولًا سجلّ التطبيق في App Store Connect وفي Google Play Console. ثم ارفع آخر production build:
\neas submit --platform ios\neas submit --platform androidعلى iOS يذهب الـ build إلى App Store Connect، حيث يصبح متاحًا في TestFlight للمختبِرين بعد المعالجة. وعلى Android يصل إلى مسار اختبار (الداخلي افتراضيًا)؛ ويحتاج EAS إلى مفتاح حساب خدمة (service account) من Google ليرفعه نيابةً عنك. ويمكنك الجمع بين الخطوتين باستخدام eas build --auto-submit.
يراجع المتجران التطبيقات، وApple أكثر صرامة. ستملأ صفحة المتجر (الاسم، والوصف، ولقطات الشاشة لأحجام الأجهزة المطلوبة)، ورابط سياسة الخصوصية، وتفاصيل الخصوصية: قسم App Privacy لدى Apple ونموذج Data safety لدى Google Play، ويجب أن يطابقا ما يجمعه Trailhead فعلًا، مثل الموقع والصور.
\n\nتستغرق المراجعات عادةً من بضع ساعات إلى يومين. وبعد الموافقة، تختار أنت متى تطلق. ثم تتكرّر الدورة مع كل تغيير أصلي: إصدار جديد، ثم build، ثم إرسال، ثم مراجعة. أما الإصلاحات التي تقتصر على JavaScript فلها طريق أسرع، وهو موضوع الدرس الأخير.
\n","toc":[{"id":"sec-1","text":"الهوية والإصدارات في app.json","level":2},{"id":"sec-2","text":"الـ build profiles","level":2},{"id":"sec-3","text":"بيانات الاعتماد","level":2},{"id":"sec-4","text":"الإرسال إلى المتاجر","level":2},{"id":"sec-5","text":"اجتياز المراجعة","level":2}],"takeaways":["يترجم build الإصدار التطبيق الأصلي، ويجمّع كود JavaScript ويصغّره، ويوقّعه ببيانات اعتماد تثق بها المتاجر.","معرّف الحزمة (bundle identifier) في iOS واسم الحزمة (package name) في Android دائمان بعد النشر؛ فاخترهما بتأنٍّ.","تصف الـ profiles في eas.json أنواع الـ builds:development لعميل التطوير الخاص بك، وpreview للمختبِرين، وproduction للمتاجر.","يرفع eas submit الـ build الإنتاجي إلى App Store Connect أو Google Play؛ ويحصل عليه المختبِرون عبر TestFlight أو مسار اختبار (testing track) قبل المراجعة.","معظم حالات الرفض الأولى تأتي من الانهيارات، أو نصوص أذونات مبهمة، أو تفاصيل خصوصية ناقصة، أو غياب حساب تجريبي في تطبيق يتطلّب تسجيل الدخول."],"further":[{"title":"EAS Build","url":"https://docs.expo.dev/build/introduction/"},{"title":"Configure EAS Build with eas.json","url":"https://docs.expo.dev/build/eas-json/"},{"title":"EAS Submit","url":"https://docs.expo.dev/submit/introduction/"},{"title":"App Store Review Guidelines","url":"https://developer.apple.com/app-store/review/guidelines/"}],"quiz":[{"q":"بعد أن أصبح Trailhead على الـ App Store، يريد زميل تغيير معرّف الحزمة في iOS ليطابق اسم شركة جديد. ماذا يحدث إن فعلت؟
","options":[{"text":"يعامله المتجر بوصفه تطبيقًا جديدًا تمامًا، فلا يحصل المستخدمون الحاليون على التحديث، وتبقى مراجعاتك وتقييماتك مع الصفحة القديمة.","why":"صحيح. معرّف الحزمة (واسم الحزمة في Android) هو الهوية الدائمة للتطبيق في المتاجر."},{"text":"يعيد الـ App Store تسمية الصفحة تلقائيًا بعد المراجعة.","why":"أسماء العرض يمكن أن تتغيّر؛ أما المعرّفات فلا. والمعرّف الجديد يعني تطبيقًا جديدًا."},{"text":"لا شيء، ما دام رقم الإصدار يرتفع.","why":"الإصدارات ترتّب إصدارات التطبيق نفسه. والمعرّف المختلف ليس التطبيق نفسه."}],"answer":0},{"q":"تريد أن يجرّب خمسة متنزّهين من ناديك Trailhead قبل أن يصل إلى المتاجر، مثبّتين إياه من رابط. أيّ build يناسب؟
","options":[{"text":"build من نوعdevelopment، لأن فيه قائمة التطوير لإبداء الملاحظات.","why":"الـ development builds تحتاج إلى خادم Metro الخاص بك لتحميل JavaScript، فلا يستطيع المختبِرون استخدامها وحدهم."},{"text":"build من نوع production يُثبَّت من الـ App Store.","why":"الـ production builds تمرّ بمراجعة المتجر والإطلاق العام؛ وهذه هي الخطوة التي تلي الاختبار."},{"text":"Expo Go مع رمز QR الخاص بمشروعك.","why":"لا يستطيع Expo Go أن يضمّ الإعدادات الأصلية لـ Trailhead، مثل مخطّط الـ URL ونصوص الأذونات، وسيحتاج المختبِرون إلى خادم التطوير الخاص بك."},{"text":"build من نوع preview مع توزيع داخلي، يُشارَك عبر الرابط الذي يعطيك إياه EAS.","why":"صحيح. التوزيع الداخلي مصمّم لهذا؛ وعلى iOS يجب تسجيل أجهزة المختبِرين أولًا للـ builds من نوع ad hoc."}],"answer":3},{"q":"ما الذي يتولّاه autoIncrement في الـ production profile؟
autoIncrement فيتولّى رقم البناء الداخلي."},{"text":"يرفع رقم البناء في iOS ورمز الإصدار (version code) في Android مع كل build، وتشترط المتاجر أن يكونا فريدين.","why":"صحيح. كل رفع يحتاج إلى رقم بناء أعلى حتى حين يبقى الإصدار الظاهر كما هو."},{"text":"يرفع إصدار Expo SDK مع كل build.","why":"ترقيات الـ SDK تغييرات مقصودة على اعتمادياتك، ولا تكون تلقائية أبدًا."}],"answer":1}],"exercise":{"kind":"order","items":["set-identity","configure","preview","production-build","submit","store-test","review","release"],"title":"رتّب الإصدار الأول من Trailhead","prompt":"اكتملت ميزات Trailhead 1.0.0 واختُبرت. رتّب خطوات إصداره الأول على الـ App Store وGoogle Play بالترتيب الذي ستنفّذها به.
\n","hints":["لا تستطيع بناء أي شيء حتى يعرف التطبيق هويته الدائمة، ويعرف EAS الـ profiles الموجودة.","يرى المختبِرون build من نوع preview قبل أن يذهب أي شيء إلى المتاجر.","مراجعة المتجر تحدث بعد رفع الـ production build والتحقّق منه على هواتف حقيقية."],"explanation":"الهوية أولًا لأنها دائمة، ثم ينشئ eas build:configure الـ profiles التي يستخدمها كل أمر لاحق. يتيح build المعاينة لمتنزّهين حقيقيين اكتشاف المشكلات قبل إشراك المتاجر. يُرفع الـ production build باستخدام eas submit، ويُتحقَّق منه مرة أخرى بوصفه build إصدار حقيقيًا عبر TestFlight أو المسار الداخلي، وعندها فقط يُرسَل للمراجعة مع اكتمال صفحة المتجر وتفاصيل الخصوصية والحساب التجريبي. والإطلاق هو الخطوة الأخيرة المقصودة: الموافقة لا تعني بالضرورة الإطلاق في تلك الدقيقة.
ios.bundleIdentifier وandroid.package وversion في app.json","configure":"شغّل eas build:configure لإنشاء eas.json مع الـ build profiles","preview":"اصنع build من نوع preview وشاركه مع بضعة متنزّهين عبر التوزيع الداخلي","production-build":"شغّل eas build --platform all --profile production","submit":"شغّل eas submit لرفع الـ builds إلى App Store Connect وGoogle Play","store-test":"ثبّت builds من TestFlight والمسار الداخلي على هواتف حقيقية وامشِ عبر المسارات الرئيسية","review":"أكمل صفحة المتجر وتفاصيل الخصوصية والحساب التجريبي، ثم أرسل للمراجعة","release":"أطلق الإصدار الموافق عليه للمستخدمين"}},"words":599,"readMinutes":4}