يوضّح هذا المستند كيفية تصدير مشروع Godot كتطبيق Android. يمكن لـ Godot إنشاء ملفات APK لاختبار الأجهزة المحلية ومجموعات حزمات تطبيق Android لإرسالها إلى "متجر Google Play".
تثبيت نموذج إصدار Android
يستخدم محرّك Godot نموذج إصدار كنقطة بداية لإنشاء ملفات Gradle والبيانات الأخرى اللازمة لإنشاء تطبيق Android. يجب استيراد نموذج الإصدار إلى مشروع Godot قبل تصدير إصدار Android. لكل إصدار من Godot قالب خاص به. لتثبيت نموذج إصدار Android في مشروع، اتّبِع الخطوات التالية:
- افتح المشروع في محرِّر Godot.
- في شريط القوائم، اختَر Project (المشروع) -> Install Android Build Template… (تثبيت نموذج إصدار Android…)
- انقر على الزر إدارة النماذج… (Manage Templates…).
- في نافذة Export Template Manager (إدارة نماذج التصدير)، انقر على الزر Download (تنزيل) لإصدار Godot المستخدَم (الإصدار الحالي).
- اختَر موقعًا جغرافيًا لنسخة طبق الأصل لتنزيل الملف.
- بعد اكتمال عملية التنزيل، انقر على الزر إغلاق في نافذة إدارة نماذج التصدير.
- من شريط قوائم المحرِّر، اختَر Project (مشروع) -> Install Android Build Template… (تثبيت نموذج إصدار Android…).
- يظهر مربع حوار التأكيد. انقر على الزر تثبيت.
سيتم تخزين ملفات نماذج الإصدارات في دليل فرعي باسم android/build
مرتبط بالدليل الجذري للمشروع. نظرًا لحجم هذا الدليل الفرعي،
قد ترغب في حذفه من نطاق التحكم في الإصدارات لمشروعك.
إضافة إعداد مُسبَق لتصدير Android
يجب إنشاء إعدادات مسبقة للتصدير إلى Android للمشروع. لإنشاء إعداد مسبق، اتّبِع الخطوات التالية:
- من شريط قائمة المحرِّر، اختَر Project (مشروع) -> Export… (تصدير…).
- من نافذة تصدير، اختَر القائمة المنسدلة إضافة…، ثمّ اختَر Android على النحو التالي:
تخصيص خيارات التصدير إلى Android
بعد إنشاء إعدادات مسبقة لتصدير مشروعك إلى Android، يمكنك ضبط خيارات التصدير من خلال اختيار الإعدادات المسبقة الجديدة في نافذة Export (تصدير). يتم تجميع خيارات التصدير في فئات على يسار نافذة تصدير. تشمل الخيارات الشائعة التي يمكن تعديلها ما يلي:
تنسيق التصدير واستخدام إصدار مخصّص
يشير خيار تنسيق التصدير إلى ما إذا كان سيتم التصدير كملف APK أو
مجموعة حزمات تطبيق Android (.AAB). للاختبار على جهاز محلي أثناء عملية التطوير، يُعدّ ملف APK أكثر ملاءمةً، حيث يمكن تثبيته مباشرةً باستخدام adb. بالنسبة إلى الإصدارات التي تنوي تحميلها على Google Play، استخدِم مجموعة حزمات تطبيق Android.
يتحكّم خيار استخدام إصدار مخصّص (Use Custom Build) في ما إذا كان محرّك Godot يستخدم عملية الإصدار الداخلية الخاصة به أو عملية إصدار Gradle التقليدية. إذا تم وضع علامة في المربّع استخدام إصدار مخصّص، سينفّذ محرّك Godot إصدار Gradle. يجب وضع علامة في المربّع استخدام إصدار مخصّص في حال انطباق أيّ من الشروط التالية:
- تم ضبط تنسيق التصدير على "مجموعة حزمات تطبيق Android"
- يستخدم المشروع نظام المكوّنات الإضافية المتوافقة مع Android في Godot
هندسة معمارية
يحدّد قسم البُنى بُنى وحدة المعالجة المركزية التي سيتم تضمينها في الإصدار. سيؤدي تصدير إصدار يتضمّن بُنى متعددة إلى زيادة حجم ملف APK أو AAB الذي تم تصديره، ما يزيد من وقت التكرار عند التصدير والنشر على جهاز. أثناء عملية التطوير، يمكنك تقليل وقت التكرار من خلال اختيار بنية جهاز الاختبار فقط. عند إرسال التطبيق إلى Google Play، يجب تصديره مع جميع البُنى المتاحة التي يدعمها مشروعك.
ملف تخزين المفاتيح
يتم ضبط ملفات تخزين مفاتيح تصحيح الأخطاء والإصدار في قسم ملف تخزين المفاتيح. يتم استخدام هذه المفاتيح عند التوقيع الرقمي على التطبيق الذي تم تصديره. يجب أن يكون الحقلان تصحيح الأخطاء والإصدار مسارات لملفات تخزين المفاتيح المعنيّة. يجب ضبط الحقلَين مستخدم تصحيح الأخطاء ومستخدم الإصدار على الأسماء البديلة في ملف تخزين المفاتيح.
إذا تم ضبط ملف تخزين مفاتيح تصحيح الأخطاء في قسم إعدادات المحرّر -> تصدير -> Android العام، يمكن ترك حقول ملف تخزين مفاتيح تصحيح الأخطاء في خيارات تصدير المشروع فارغة، وسيتم استخدام ملف تخزين مفاتيح تصحيح الأخطاء العام كإعداد تلقائي.
لإنشاء إصدار وتحميله إلى "متجر Google Play"، يمكنك استخدام "استوديو Android" لإنشاء ملف تخزين مفاتيح الإصدار.
لإنشاء ملف تخزين مفاتيح لإصدار تطبيقك:
- افتح "استوديو Android".
- في نافذة مرحبًا بك في "استوديو Android"، اختَر إنشاء مشروع جديد.
- اختَر نموذج عدم وجود نشاط، ثم انقر على التالي.
- في شاشة Configure Your Project (ضبط مشروعك)، انقر على Finish (إنهاء) لإنشاء المشروع.
- أنشئ ملف تخزين مفاتيح باتّباع التعليمات الواردة في مقالة إنشاء مفتاح تحميل وملف تخزين مفاتيح.
- بعد إنشاء ملف تخزين المفاتيح، أغلِق "استوديو Android" وارجع إلى محرِّر Godot.
- أضِف ملف تخزين المفاتيح إلى حقل الإصدار وأدخِل قيمتَي مستخدم الإصدار وكلمة مرور الإصدار في الحقلَين المعنيَين.
الإصدار والحزمة
يحدّد قسمَا الإصدار والحزمة رمز الإصدار وسلسلة الإصدار ومعرّف الحزمة واسم الحزمة لتطبيقك. يجب ضبط حقل الاسم الفريد على معرّف الحزمة الذي يستخدمه تطبيقك في Google Play Console.
رموز مشغّل التطبيقات
يحدّد قسم رموز مشغّل التطبيقات ملفات PNG التي سيتم استخدامها كرموز لتطبيقك. وإذا لم يتم تحديد ملفات الرموز، سيستخدم محرّك Godot ملف رمز تلقائيًا. يتيح محرّك Godot تحديد رموز التطبيقات القديمة والرموز التكيُّفية المتوفّرة في الإصدار 8.0 من نظام التشغيل Android (مستوى واجهة برمجة التطبيقات 26) والإصدارات الأحدث. للحصول على نصائح حول إنشاء رموز تكيُّفية، يُرجى الاطّلاع على دليل الرموز التكيُّفية.
تصدير إصدار
لتصدير إصدار، اتّبِع الخطوات التالية:
- اختَر Project (مشروع) -> Export… (تصدير…) من شريط قوائم Godot.
- اختَر إعدادًا مسبقًا لتصدير Android من قائمة الإعدادات المسبقة.
- انقر على الزر تصدير المشروع (Export Project) في أسفل نافذة تصدير (Export).
- في مربّع الحوار حفظ ملف، اختَر اسمًا للملف الذي تم تصديره.
- أزِل العلامة من المربّع التصدير مع تصحيح الأخطاء لإنشاء بنية إصدار.
- انقر على حفظ لتصدير الإصدار.
ستبدو نافذة تقدّم عملية التصدير مختلفة إذا تم تحديد خيار استخدام إصدار مخصّص في الإعدادات المُسبقة للتصدير. تعرض عمليات الإنشاء المخصّصة ناتج عملية إنشاء Gradle.