تنتهي من لعبتك الصغيرة على جهازك، تضغط زر التشغيل في المحرر فتعمل كما تريد، ثم يطلب صديق يستخدم Windows أن يجربها، ويسأل قريب عن رابط يفتحه من جواله، ويقترح عليك زميل أن ترفعها على Steam أو itch.io. وهنا تكتشف أن اللعبة التي تعمل في محرر Godot على جهازك ليست بعد شيئاً تستطيع أن ترسله لأحد، فاللاعب لا يملك المحرر، ولا يعرف ما هو ملف project.godot، ولن يفتح مجلداً فيه الكود والمشاهد ليشغله. والخطوة التي تحول المشروع إلى برنامج يعمل عند اللاعب اسمها التصدير Export، وهي في الغالب آخر ما يتعلمه المطور وأول ما يتعثر فيه عندما يقترب موعد النشر.
وفي مقال محركات الألعاب ذكرنا أن التصدير إلى المنصات جزء من الأجزاء الستة التي يعطيك إياها المحرك، وفي هذا المقال سوف نفتح هذا الجزء من الداخل: ماذا يحدث فعلاً عند التصدير، ولماذا تحتاج ملفاً حجمه 1.2 جيجابايت لتصدر لعبة حجمها أقل من 120 كيلوبايت، ثم نصدر لعبة صغيرة كتبناها لهذا المقال إلى خمس منصات من سطر الأوامر، ونشغلها على Linux وWindows وفي المتصفح، ونرى بأعيننا الأخطاء التي سوف تقابلك.
وسوف نناقش في هذا المقال ما يلي:
- ما الذي يحدث عند التصدير، ولماذا لا ترسل المشروع كما هو.
- قوالب التصدير Export Templates وإعدادات التصدير Export Presets.
- مختبر: لعبة واحدة تصدر إلى الويب وLinux وWindows وmacOS داخل Docker.
- تشغيل النسخ المصدرة دون Godot، والفرق الذي يظهر في الخط العربي.
- التصدير إلى الويب: WebAssembly، وحجم التحميل، والضغط على السيرفر.
- لماذا تحتاج بعض نسخ الويب Headers خاصة، وما علاقة ذلك بثغرة Spectre.
- سطح المكتب: التوقيع Code Signing على Windows والتوثيق Notarization على macOS.
- الجوال: ما تحتاجه لتصدر إلى Android وiOS.
- النشر في المتاجر: Steam وitch.io وGoogle Play وApp Store.
ماذا يحدث عند التصدير؟
أبسط طريقة لتوزيع لعبة على الكمبيوتر هي أن تضع برنامج Godot نفسه في مجلد المشروع بجانب project.godot، ثم تضغط المجلد كله وترسله، وهذه الطريقة تعمل فعلاً كما تذكر صفحة التصدير في توثيق Godot. ولكن لها مشاكل واضحة: فاللاعب يستلم المحرر كاملاً بأدواته وواجهته، ويستلم كل ملفات مشروعك مكشوفة كما كتبتها، والمحرر نفسه أكبر وأبطأ من نسخة مبنية للتشغيل فقط، ولا يوجد شيء من هذا يصلح للجوال أو للمتصفح أصلاً.
ولذلك يعمل التصدير بطريقة مختلفة: يأخذ Godot كل ملفات مشروعك، الكود والمشاهد والخطوط والصور بعد استيرادها Import، ويضعها في ملف واحد اسمه حزمة اللعبة واختصاراً PCK، ثم يضع هذه الحزمة بجانب نسخة جاهزة من المحرك مبنية دون المحرر ودون أدوات التصحيح Debugger لكل منصة، وهذه النسخة الجاهزة اسمها قالب التصدير Export Template. وأقرب تشبيه لها مشغل الفيديو والفيلم: قالب التصدير هو المشغل، وهو نفسه عند كل الناس، وحزمة PCK هي الفيلم الذي يختلف من لعبة إلى أخرى.
والصورة التالية تبين ما حدث للعبتنا في المختبر عند تصديرها إلى أربع منصات:

في الصورة أعلاه لاحظ التالي:
- حزمة اللعبة واحدة: ملف PCK حجمه 118.5 كيلوبايت في كل المنصات، لأن لعبتنا صغيرة: كود GDScript ومشهد واحد وخط عربي.
- الحجم الحقيقي هو المحرك: ملف Windows وحده 104.1 ميجابايت، وهو تقريباً حجم القالب نفسه، ولو صدرت لعبة أخرى لكان بالحجم نفسه.
- الأمر واحد لكل المنصات: لا تحتاج أن تكون على Windows لتصدر له، فكل ما في المختبر صدر من Container يعمل على Linux.
وقد يتساءل البعض: إذا كان القالب هو المحرك نفسه، فلماذا لا يكون ملف Windows صغيراً ويعتمد على Godot مثبت عند اللاعب كما تعتمد برامج Java على Java مثبتة؟ والإجابة أن اللاعب لا يجب أن يثبت شيئاً قبل أن يلعب، وأن كل لعبة تحتاج نسخة المحرك التي بنيت بها بالضبط، فلعبة بنيت بالإصدار 4.7.2 لا تضمن العمل على 4.6، ولذلك تحمل كل لعبة محركها معها.
قوالب التصدير Export Templates
قوالب التصدير ملفات تنزلها مرة واحدة لكل إصدار من Godot، ويجب أن يطابق إصدارها إصدار المحرر الذي تصدر منه حرفاً بحرف، فالمحرر 4.7.2 يبحث عنها في مجلد اسمه 4.7.2.stable ولا يقبل غيره. وتنزلها من المحرر من قائمة Editor ثم Manage Export Templates، وفي الإصدارات الحديثة يمكنك أن تختار المنصات التي تحتاجها فقط، أو تنزل ملفاً واحداً بامتداد .tpz فيه كل القوالب لكل المنصات من صفحة إصدار Godot 4.7.2 على GitHub.
وفي المختبر نزلنا الملف الكامل، وحجمه 1,281,349,702 بايت أي حوالي 1.2 جيجابايت، وتحققنا منه بقيمة SHA512 المنشورة في صفحة الإصدار، ثم أخرجنا منه القوالب التي نحتاجها فقط، والمخرج سوف يكون كما يلي:
### templates used (from the 1.2 GB file)
4.7.2.stable
70.1 MB linux_release.x86_64
117.9 MB macos.zip
0.0 MB version.txt
9.8 MB web_nothreads_release.zip
9.8 MB web_release.zip
104.2 MB windows_release_x86_64.exe
0.2 MB windows_release_x86_64_console.exeفي المخرج أعلاه لاحظ التالي:
- اسم المجلد: السطر الثاني هو محتوى
version.txt، وهو الاسم الذي يبحث عنه المحرر بالضبط. - قالبان للويب:
web_release.zipللنسخة التي تستخدم خيوط التنفيذ Threads، وweb_nothreads_release.zipللنسخة التي لا تستخدمها، وسوف نرى الفرق بينهما بالتفصيل. - قالب macOS أكبر من غيره: 117.9 ميجابايت مضغوطاً، لأنه يحمل المحرك لمعالجات Intel وApple Silicon معاً.
- قالب الكونسول Console: ملف صغير حجمه 0.2 ميجابايت يشغل اللعبة ويعرض مخرجها في نافذة الأوامر، وسوف نستعمله لقراءة مخرج اللعبة على Windows.
ولكل منصة قالبان في الحقيقة: قالب Release للنسخة التي توزعها على اللاعبين، وقالب Debug فيه أدوات التصحيح ورسائل أكثر تفصيلاً تستعمله أثناء التطوير. وفي الملف الكامل تجد أيضاً قوالب Android وiOS ومعالجات ARM، ولذلك لا تنزل الملف الكامل إلا إذا كنت تحتاج أغلب المنصات فعلاً، فالتوثيق نفسه يذكر أنه لا توجد ميزة في تنزيل كل القوالب سوى أنها تأخذ مساحة أكبر.
إعدادات التصدير Export Presets
إعداد التصدير Preset هو مجموعة خيارات محفوظة لمنصة واحدة: اسم المنصة، ومكان الملف الناتج، والخيارات الخاصة بها مثل المعمارية Architecture والتوقيع وشكل صفحة الويب. وتنشئها من نافذة Project ثم Export في المحرر، فيحفظها Godot في ملف export_presets.cfg بجانب project.godot. والميزة المهمة هنا أن الملف نص عادي تستطيع أن تحفظه في Git وتستعمله في خط بناء آلي Pipeline يصدر اللعبة دون أن يفتح أحد المحرر، وهذا ما فعلناه في المختبر. وهذا ملف إعدادات المختبر كاملاً:
[preset.0]
name="Web (threads)"
platform="Web"
runnable=false
export_filter="all_resources"
include_filter=""
exclude_filter=""
export_path="../build/web-threads/index.html"
[preset.0.options]
variant/thread_support=true
html/head_include="<script>window.__lab=[];[\"log\",\"warn\",\"error\"].forEach(function(k){var o=console[k];console[k]=function(){window.__lab.push(k+\": \"+Array.prototype.join.call(arguments,\" \"));o.apply(console,arguments);};});</script>"
[preset.1]
name="Web (no threads)"
platform="Web"
runnable=true
export_filter="all_resources"
include_filter=""
exclude_filter=""
export_path="../build/web-nothreads/index.html"
[preset.1.options]
variant/thread_support=false
html/head_include="<script>window.__lab=[];[\"log\",\"warn\",\"error\"].forEach(function(k){var o=console[k];console[k]=function(){window.__lab.push(k+\": \"+Array.prototype.join.call(arguments,\" \"));o.apply(console,arguments);};});</script>"
[preset.2]
name="Linux"
platform="Linux"
runnable=true
export_filter="all_resources"
include_filter=""
exclude_filter=""
export_path="../build/linux/date-basket.x86_64"
[preset.2.options]
binary_format/architecture="x86_64"
binary_format/embed_pck=false
[preset.3]
name="Windows"
platform="Windows Desktop"
runnable=true
export_filter="all_resources"
include_filter=""
exclude_filter=""
export_path="../build/windows/date-basket.exe"
[preset.3.options]
binary_format/architecture="x86_64"
binary_format/embed_pck=false
debug/export_console_wrapper=2
[preset.4]
name="macOS"
platform="macOS"
runnable=true
export_filter="all_resources"
include_filter=""
exclude_filter=""
export_path="../build/macos/date-basket.zip"
[preset.4.options]
application/bundle_identifier="io.arabroot.datebasket"في الإعداد أعلاه لاحظ التالي:
- إعدادان للويب: الأول بالخيار
variant/thread_support=trueوالثاني دونه، والقيمة الافتراضية في Godot 4.7 هي دون Threads. - الخيار
html/head_include: سطر JavaScript يضيفه Godot إلى صفحة الويب، وقد وضعناه لنجمع رسائل اللعبة من المتصفح ونطبعها في المختبر، ولا تحتاجه في لعبتك. - الخيار
binary_format/embed_pck=false: يجعل حزمة اللعبة ملفاً منفصلاً بجانب البرنامج، وإذا جعلتهtrueدخلت الحزمة داخل الملف التنفيذي فيصبح ملفاً واحداً. - الخيار
debug/export_console_wrapper=2: يطلب ملف الكونسول دائماً حتى في نسخة Release، والقيمة الافتراضية تصدره مع نسخة Debug فقط. - معرف الحزمة
application/bundle_identifier: إلزامي لنسخة macOS، وهو اسم فريد بصيغة النطاق المعكوس.
وهل هذا الملف آمن لتضعه في Git؟ نعم، لأن Godot يفصل الخيارات السرية مثل كلمات مرور التوقيع ومفاتيح التشفير في ملف آخر هو .godot/export_credentials.cfg، وهذا الملف لا تضعه في Git ولا ترسله لأحد، والسبب أن فيه ما يثبت هويتك كناشر أمام المتاجر وأنظمة التشغيل.
التصدير من سطر الأوامر
قد تصدر لعبتك في البداية من نافذة Export في المحرر بضغطة زر، وهذا مناسب لأول نسخة، ولكن عندما تصدر لأربع منصات بعد كل تعديل صغير سوف تحتاج أن يتم ذلك آلياً، في سكربت على جهازك أو في خط بناء Pipeline على سيرفر مثل GitHub Actions أو Gitea Actions. ويعطيك Godot لذلك ثلاثة أوامر يذكرها توثيق سطر الأوامر:
- الأمر
--export-release: يصدر اللعبة بقالب Release، وهو ما توزعه على اللاعبين، ويتبعه اسم الإعداد كما فيexport_presets.cfgثم مسار الملف الناتج. - الأمر
--export-debug: نفس السابق بقالب Debug، وتستعمله لنسخة تجريبية ترسلها لمن يختبر اللعبة معك، لأن رسائل الأخطاء فيها أوضح. - الأمر
--export-pack: يصدر حزمة اللعبة فقط دون المحرك، بصيغة PCK أو ZIP بحسب امتداد الملف، وتستعمله للتحديثات والمحتوى الإضافي DLC، فاللاعب عنده المحرك أصلاً ويحتاج الحزمة الجديدة فقط.
وكل هذه الأوامر تحتاج أن تكون القوالب مثبتة على الجهاز الذي يصدر، وأن تضيف الخيار --headless على السيرفر حتى لا يحاول Godot فتح نافذة، كما فعلنا في المختبر. وهناك تفصيل يقع فيه الكثيرون في أول سكربت: المسار النسبي بعد اسم الإعداد يحسب من مجلد المشروع الذي فيه project.godot، لا من المجلد الذي شغلت منه الأمر، والمجلد الذي يوضع فيه الملف يجب أن يكون موجوداً قبل التصدير، ولذلك ينشئ سكربت المختبر مجلدات build أولاً ثم يمرر مسارات كاملة. وإذا كان في اسم الإعداد مسافة مثل "Web (no threads)" فضعه بين علامتي تنصيص، وإلا ظن Godot أن الكلمة الثانية هي مسار الملف.
المختبر: لعبة واحدة إلى خمس منصات
لكي نرى التصدير بأعيننا كتبنا لعبة صغيرة اسمها «سلة التمر»: حبات تمر تسقط من نخلة، وسلة تتحرك وحدها لتلتقطها، ولا تحتاج اللعبة لاعباً حتى تعمل في المختبر دون شاشة. وتطبع اللعبة في البداية اسم المنصة التي تعمل عليها، ثم تطبع بعد ست ثوان عدد الإطارات Frames التي رسمتها وعدد الحبات التي التقطتها والتي سقطت على الأرض، ثم تغلق نفسها. وتكتب اللعبة على الشاشة سطرين بالعربية: الأول بالخط الافتراضي للمحرك، والثاني بخط IBM Plex Sans Arabic وضعناه داخل المشروع، وسوف نعرف سبب ذلك بعد قليل.
وهذا ملف المشروع، وفيه أن اللعبة تستخدم طريقة الرسم Compatibility لأنها الوحيدة التي تعمل في المتصفح:
; A tiny original game for the export lab: a basket catches falling dates.
config_version=5
[application]
config/name="Date Basket"
run/main_scene="res://main.tscn"
config/features=PackedStringArray("4.7", "GL Compatibility")
[display]
window/size/viewport_width=640
window/size/viewport_height=360
window/stretch/mode="canvas_items"
[rendering]
renderer/rendering_method="gl_compatibility"
renderer/rendering_method.mobile="gl_compatibility"وهذا كود اللعبة كاملاً:
extends Node2D
# Date Basket: dates fall from the palm, the basket moves by itself to catch them (no input needed, so it runs headless too).
# Every line that starts with "LAB" is what the lab reads on each platform.
const W := 640.0
const H := 360.0
const FALL := 160.0 # px per second
const BASKET_SPEED := 220.0
const RUN_FOR := 6.0 # seconds, then report
var rng := RandomNumberGenerator.new()
var dates: Array[Vector2] = []
var basket_x := W / 2.0
var spawn_in := 0.0
var t := 0.0
var frames := 0
var caught := 0
var missed := 0
var reported := false
var score_label: Label
func _ready() -> void:
rng.seed = 7
Engine.max_fps = 60
var plex: FontFile = load("res://fonts/IBMPlexSansArabic-Regular.ttf")
_label("بالخط الافتراضي: سلة التمر", Vector2(16, 10), null)
_label("بخط مضمن في اللعبة: سلة التمر", Vector2(16, 44), plex)
score_label = _label("", Vector2(16, 78), plex)
var f := ["web", "threads", "nothreads", "pc", "linux", "windows", "template", "release", "debug"]
var on := f.filter(func(x): return OS.has_feature(x))
print("LAB platform=%s features=%s" % [OS.get_name(), ",".join(on)])
print("LAB renderer=%s driver=%s cpus=%d" % [RenderingServer.get_current_rendering_method(),
RenderingServer.get_current_rendering_driver_name(), OS.get_processor_count()])
func _label(text: String, pos: Vector2, font: Font) -> Label:
var l := Label.new()
l.text = text
l.position = pos
l.add_theme_font_size_override("font_size", 22)
l.add_theme_color_override("font_color", Color("#3b2a1a"))
if font:
l.add_theme_font_override("font", font)
add_child(l)
return l
func _process(delta: float) -> void:
t += delta
frames += 1
spawn_in -= delta
if spawn_in <= 0.0:
dates.append(Vector2(rng.randf_range(40.0, W - 40.0), 110.0))
spawn_in = 0.5
# the basket walks toward the lowest date
if not dates.is_empty():
var target := dates[0].x
basket_x = move_toward(basket_x, target, BASKET_SPEED * delta)
for i in range(dates.size() - 1, -1, -1):
dates[i].y += FALL * delta
if dates[i].y >= H - 34.0:
if absf(dates[i].x - basket_x) <= 40.0:
caught += 1
else:
missed += 1
dates.remove_at(i)
score_label.text = "في السلة: %d على الأرض: %d" % [caught, missed]
queue_redraw()
if t >= RUN_FOR and not reported:
reported = true
print("LAB after %.1f s: frames=%d caught=%d missed=%d" % [t, frames, caught, missed])
if "--shot" in OS.get_cmdline_user_args(): # godot ... -- --shot : save what the window shows next to the program
await RenderingServer.frame_post_draw
get_viewport().get_texture().get_image().save_png(OS.get_executable_path().get_base_dir().path_join("shot.png"))
if not OS.has_feature("web"):
get_tree().quit()
func _draw() -> void:
draw_rect(Rect2(0, 0, W, H), Color("#f3e3c3"))
draw_rect(Rect2(0, H - 24, W, 24), Color("#c8a46e"))
draw_rect(Rect2(W - 70, 100, 14, H - 124), Color("#7a5230")) # palm trunk
draw_circle(Vector2(W - 63, 100), 34, Color("#4f7a3a")) # palm crown
for d in dates:
draw_circle(d, 7, Color("#6b3a1e"))
draw_rect(Rect2(basket_x - 40, H - 40, 80, 16), Color("#a0662f"))في الكود أعلاه لاحظ التالي:
- الدالة
OS.has_feature: تسأل عن وسوم المنصة Feature Tags مثلwebوwindowsوthreads، وهي الطريقة الصحيحة لكتابة كود يختلف بين المنصات، فلا تقم بفحص اسم النظام بنص ثابت، والسبب أن الوسوم تغطي حالات مثل «متصفح يعمل على Android» بوسم واحدweb_android. - الحركة مضروبة في delta: كل ما يتحرك يضرب في زمن الإطار، كما شرحنا في مقال حلقة اللعبة، حتى تتحرك اللعبة بالسرعة نفسها على الأجهزة المختلفة.
- الخيار
--shot: إذا شغلت اللعبة مع هذا الخيار حفظت صورة لما على الشاشة بجانب البرنامج، وسوف نستعمله على Windows.
ونشغل Godot 4.7.2 داخل Docker حتى لا تحتاج تثبيت شيء على جهازك، والـ Image تنزل النسخة الرسمية من GitHub وتتحقق منها:
# Godot 4.7.2 (official Linux build from GitHub) in a small image, checked against the release's SHA512 sums.
# The export templates are not in the image: run.sh downloads them once into cache/ and mounts them.
FROM debian:bookworm-slim
ARG GODOT=4.7.2-stable
RUN apt-get update && apt-get install -y --no-install-recommends ca-certificates curl unzip libfontconfig1 \
&& rm -rf /var/lib/apt/lists/*
WORKDIR /opt/godot
RUN curl -fsSLO https://github.com/godotengine/godot/releases/download/${GODOT}/Godot_v${GODOT}_linux.x86_64.zip \
&& curl -fsSLO https://github.com/godotengine/godot/releases/download/${GODOT}/SHA512-SUMS.txt \
&& grep " Godot_v${GODOT}_linux.x86_64.zip$" SHA512-SUMS.txt | sha512sum -c - \
&& unzip -q Godot_v${GODOT}_linux.x86_64.zip && rm Godot_v${GODOT}_linux.x86_64.zip \
&& mv Godot_v${GODOT}_linux.x86_64 /usr/local/bin/godot
WORKDIR /labوهذا السكربت يعمل داخل الـ Container، ويصدر اللعبة إلى كل إعداد بالأمر --export-release، ثم يعرض الملفات الناتجة وأحجامها:
#!/bin/bash
# Inside the container: export the same project to five platforms, one preset at a time, then list what came out.
set -e
cd /lab
rm -rf build && mkdir -p build/web-threads build/web-nothreads build/linux build/windows build/macos
export_one() { # $1 = project folder, $2 = preset name, $3 = output file
local s e ok
s=$(date +%s.%N)
godot --headless --path "$1" --export-release "$2" "$3" > /tmp/export.log 2>&1 && ok=ok || ok=FAILED
e=$(date +%s.%N)
printf '### %-17s %s in %.1f s\n' "$2" "$ok" "$(awk "BEGIN{print $e - $s}")"
# keep Godot's own messages, drop the progress lines and the C++ source locations
sed 's/\x1b\[[0-9;]*m//g' /tmp/export.log | grep -vE '^\s*at:|^\[|^Godot Engine|^\s*$|^savepack' | head -6
}
export_one game "Web (threads)" /lab/build/web-threads/index.html
export_one game "Web (no threads)" /lab/build/web-nothreads/index.html
export_one game "Linux" /lab/build/linux/date-basket.x86_64
export_one game "Windows" /lab/build/windows/date-basket.exe
export_one game "macOS" /lab/build/macos/date-basket.zip
echo "### macOS again, on a copy of the project with the setting the error asks for"
cp -r game /tmp/game && echo 'textures/vram_compression/import_etc2_astc=true' >> /tmp/game/project.godot
export_one /tmp/game "macOS" /lab/build/macos/date-basket.zip
echo "### inside the macOS zip"
unzip -l build/macos/date-basket.zip | awk 'NR>3 && $1 ~ /^[0-9]+$/ && $4 != "" && $0 !~ /\/$/ {printf "%10s %s\n", $1, substr($0, index($0, $4))}' | grep -v ' files$' | head -14
echo "### files"
cd build && find . -type f | sort | while read f; do printf '%10s %s\n' "$(numfmt --to=iec --suffix=B --format='%.1f' $(stat -c %s "$f"))" "${f#./}"; doneوهذا السكربت الذي تشغله أنت من مجلد المختبر بالأمر bash run.sh، وهو ينزل القوالب مرة واحدة، ثم يصدر، ثم يشغل النسخ الناتجة على Linux وWindows وفي المتصفح:
#!/bin/bash
# The export lab, from this folder: bash run.sh
# 1. download the official 4.7.2 export templates once (1.2 GB) and check them against the release's SHA512 sums
# 2. export the game to Web (with and without threads), Linux, Windows and macOS inside Docker
# 3. run the Linux build in a clean container and the Windows build on this machine
# 4. serve the two Web builds with and without the isolation headers and open them in headless Chrome (node web-check.mjs)
set -eo pipefail
V=4.7.2-stable; T=4.7.2.stable
mkdir -p cache
if [ ! -f cache/templates/$T/version.txt ]; then
[ -f cache/templates.tpz ] || curl -fsSL -o cache/templates.tpz https://github.com/godotengine/godot/releases/download/$V/Godot_v${V}_export_templates.tpz
curl -fsSL https://github.com/godotengine/godot/releases/download/$V/SHA512-SUMS.txt | grep " Godot_v${V}_export_templates.tpz$" | sed 's#Godot_v.*#cache/templates.tpz#' > cache/sum.txt
sha512sum -c cache/sum.txt
mkdir -p cache/templates/$T
unzip -q -j -o cache/templates.tpz -d cache/templates/$T templates/version.txt templates/web_release.zip templates/web_nothreads_release.zip \
templates/linux_release.x86_64 templates/windows_release_x86_64.exe templates/windows_release_x86_64_console.exe templates/macos.zip
fi
{ echo "### templates used (from the 1.2 GB file)"; cat cache/templates/$T/version.txt; ls -l cache/templates/$T | awk 'NR>1 {printf "%10.1f MB %s\n", $5/1048576, $9}'; } | tee out-01-templates.txt
docker build -q -t export-lab:1 . > /dev/null
MSYS_NO_PATHCONV=1 docker run --rm -v "$(pwd -W 2>/dev/null || pwd):/lab" -v "$(pwd -W 2>/dev/null || pwd)/cache/templates:/root/.local/share/godot/export_templates" \
export-lab:1 bash export.sh 2>&1 | tee out-02-export.txt
echo "### Linux build in a clean container (no Godot installed there)" | tee out-03-run.txt
MSYS_NO_PATHCONV=1 docker run --rm -v "$(pwd -W 2>/dev/null || pwd)/build/linux:/game" debian:bookworm-slim /game/date-basket.x86_64 --headless 2>&1 | grep -E "LAB|Godot Engine|ERROR" | tee -a out-03-run.txt
echo "### Windows build on this machine" | tee -a out-03-run.txt
./build/windows/date-basket.console.exe --headless 2>&1 | grep -E "LAB|Godot Engine|ERROR" | tee -a out-03-run.txt
echo "### the same Windows build with a real window (6 s), saving build/windows/shot.png" | tee -a out-03-run.txt
./build/windows/date-basket.console.exe -- --shot 2>&1 | grep -E "LAB|WARNING" | tee -a out-03-run.txt
node web-check.mjs | tee out-04-web.txtوعند تشغيل التصدير سوف تجد أن أربع منصات نجحت وواحدة فشلت:
### Web (threads) ok in 22.4 s
### Web (no threads) ok in 14.1 s
### Linux ok in 11.0 s
### Windows ok in 16.4 s
### macOS FAILED in 16.1 s
ERROR: Cannot export project with preset "macOS" due to configuration errors:
Cannot export for universal or arm64 if ETC2 ASTC texture format is disabled. Enable it in the Project Settings (Rendering > Textures > VRAM Compression > Import ETC2 ASTC).
ERROR: Project export for preset "macOS" failed.نسخة macOS لم تصدر، والرسالة واضحة: لا يمكن التصدير إلى macOS بصيغة Universal أو لمعالجات arm64 إذا كانت صيغة ضغط الخامات ETC2 ASTC معطلة، والحل كما تقول الرسالة أن تفعلها من إعدادات المشروع. والسبب أن أجهزة Mac الحديثة تعمل بمعالجات Apple Silicon، وكروت الشاشة فيها تفهم صيغة ضغط الخامات Texture Compression المستخدمة في الجوال لا صيغة أجهزة الكمبيوتر التقليدية، ولذلك يرفض Godot أن يصدر لعبة قد لا تظهر خاماتها على نصف أجهزة Mac. ولاحظ أن الخطأ ظهر وقت التصدير لا وقت التشغيل، وهذا من حسن الحظ، فأسوأ الأخطاء هي التي يكتشفها اللاعب.
وفي السكربت نسخنا المشروع وأضفنا السطر الذي تطلبه الرسالة إلى النسخة، ثم صدرنا مرة أخرى:
### macOS again, on a copy of the project with the setting the error asks for
### macOS ok in 33.8 s
### inside the macOS zip
9 Date Basket.app/Contents/PkgInfo
121324 Date Basket.app/Contents/Resources/Date Basket.pck
229 Date Basket.app/Contents/Resources/PrivacyInfo.xcprivacy
67500 Date Basket.app/Contents/Resources/icon.icns
1779 Date Basket.app/Contents/Info.plist
170963648 Date Basket.app/Contents/MacOS/Date Basket
3179 Date Basket.app/Contents/_CodeSignature/CodeResourcesنجح التصدير هذه المرة، وفي محتوى الملف المضغوط لاحظ التالي:
- التطبيق مجلد: تطبيق macOS هو مجلد ينتهي بـ
.app، وفيه البرنامج فيContents/MacOSوحزمة اللعبة فيContents/Resources. - البرنامج حجمه حوالي 163 ميجابايت: 170,963,648 بايت، لأنه برنامج واحد فيه نسختان من المحرك، واحدة لمعالجات Intel وواحدة لمعالجات Apple Silicon.
- المجلد
_CodeSignature: وقع Godot التطبيق توقيعاً محلياً Ad-hoc دون أن نطلب ذلك، وهذا التوقيع لا يثبت هويتك أمام Apple، وسوف نعود إليه في قسم macOS.
وفي نهاية المخرج قائمة بكل الملفات الناتجة وأحجامها:
### files
118.5KB linux/date-basket.pck
70.2MB linux/date-basket.x86_64
57.8MB macos/date-basket.zip
11.7KB web-nothreads/index.apple-touch-icon.png
3.0KB web-nothreads/index.audio.position.worklet.js
7.2KB web-nothreads/index.audio.worklet.js
5.6KB web-nothreads/index.html
5.6KB web-nothreads/index.icon.png
273.3KB web-nothreads/index.js
118.5KB web-nothreads/index.pck
21.0KB web-nothreads/index.png
37.7MB web-nothreads/index.wasm
11.7KB web-threads/index.apple-touch-icon.png
3.0KB web-threads/index.audio.position.worklet.js
7.2KB web-threads/index.audio.worklet.js
5.6KB web-threads/index.html
5.6KB web-threads/index.icon.png
307.3KB web-threads/index.js
118.5KB web-threads/index.pck
21.0KB web-threads/index.png
37.1MB web-threads/index.wasm
49.0KB windows/date-basket.console.exe
104.1MB windows/date-basket.exe
118.5KB windows/date-basket.pckولاحظ أن ملف PCK بالحجم نفسه 118.5 كيلوبايت في Linux وWindows والويب، وأن كل ما عداه هو المحرك: 70.2 ميجابايت في Linux، و104.1 ميجابايت في Windows، و37.7 ميجابايت في الويب، و57.8 ميجابايت لملف macOS المضغوط. وإذا كانت هذه الأحجام تزعجك فاعلم أن لعبة كاملة فيها صور وأصوات سوف تكون حزمتها أكبر من المحرك بكثير، وأن Godot يسمح ببناء قوالب مخصصة تحذف منها أجزاء المحرك التي لا تستخدمها، وهذا موضوع متقدم لا تحتاجه في أول لعبة.
هل تعمل النسخ المصدرة دون Godot؟
التصدير نجح، ولكن السؤال الحقيقي هو هل تعمل اللعبة على جهاز لا يوجد فيه Godot؟ ولذلك شغلنا نسخة Linux في Container جديد من Debian لم يثبت فيه شيء، وشغلنا نسخة Windows على جهاز Windows 11 عادي، والمخرج سوف يكون كما يلي:
### Linux build in a clean container (no Godot installed there)
Godot Engine v4.7.2.stable.official.ed1daf0bf - https://godotengine.org
LAB platform=Linux features=threads,pc,linux,template,release
LAB renderer=gl_compatibility driver=opengl3 cpus=8
LAB after 6.0 s: frames=352 caught=6 missed=3
### Windows build on this machine
Godot Engine v4.7.2.stable.official.ed1daf0bf - https://godotengine.org
LAB platform=Windows features=threads,pc,windows,template,release
LAB renderer=gl_compatibility driver=opengl3 cpus=8
LAB after 6.0 s: frames=356 caught=7 missed=3في المخرج أعلاه لاحظ التالي:
- تعمل دون أي تثبيت: البرنامج وحزمته يكفيان، ولم نحتج مكتبة إضافية في Debian.
- وسوم المنصة:
templateتعني أنها نسخة مصدرة لا المحرر، وreleaseتعني قالب Release، وpcتعني جهاز كمبيوتر، ومن هذه الوسوم تبني كودك عندما تريد سلوكاً مختلفاً لكل منصة. - النتيجة ليست متطابقة تماماً: في Linux رسمت اللعبة 352 إطاراً والتقطت 6 حبات، وفي Windows رسمت 356 إطاراً والتقطت 7. والسبب أن منطق اللعبة في
_processيعتمد على زمن كل إطار، وهذا الزمن يختلف قليلاً بين جهاز وآخر، فتصل الحبة السابعة إلى السلة قبل الثانية السادسة على جهاز وبعدها على آخر. وإذا كانت لعبتك تحتاج نتيجة متطابقة على كل الأجهزة، في لعبة جماعية مثلاً، فضع المنطق في خطوة الفيزياء الثابتة كما شرحنا في مقال حلقة اللعبة.
ثم شغلنا نسخة Windows نفسها في نافذة حقيقية لمدة ست ثوان:
### the same Windows build with a real window (6 s), saving build/windows/shot.png
WARNING: Your video card drivers are known to have low quality OpenGL 3.3 support, switching to ANGLE.
LAB platform=Windows features=threads,pc,windows,template,release
LAB renderer=gl_compatibility driver=opengl3_angle cpus=8
LAB after 6.0 s: frames=269 caught=7 missed=3ظهر تحذير لم نره في التشغيل دون شاشة: Godot وجد أن تعريف كرت الشاشة Driver في هذا الجهاز معروف بدعم ضعيف لـ OpenGL 3.3، فانتقل وحده إلى ANGLE، وهي طبقة تترجم أوامر OpenGL إلى Direct3D 11 الذي يدعمه Windows بشكل أفضل. وهذا سلوك افتراضي في Godot على Windows فقط، يتحكم فيه الإعداد rendering/gl_compatibility/fallback_to_angle كما في توثيق إعدادات المشروع، وهو أحد الأسباب التي تجعلك تجرب لعبتك على أجهزة حقيقية مختلفة قبل النشر، فعدد الإطارات هنا كان 269 في ست ثوان، أقل من التشغيل دون شاشة لأن الرسم الحقيقي يأخذ وقتاً.
والصورة التالية هي ما حفظته اللعبة من شاشتها في هذا التشغيل:

لاحظ أن السطر الأول ظهر بالعربية صحيحاً رغم أن الخط الافتراضي في Godot لا يحتوي حروفاً عربية، والسبب أن Godot يستعمل خطوط النظام بديلاً Fallback عندما لا يجد الحرف في خطك، كما يذكر توثيق الخطوط في Godot. وهذا يعني أن لعبتك قد تبدو سليمة على جهازك وعلى Windows، ثم تظهر حروفها مربعات فارغة في مكان آخر، وهذا ما حدث فعلاً في المتصفح.
التصدير إلى الويب: WebAssembly وWebGL 2
نسخة الويب هي أسهل نسخة يجربها الناس، رابط يفتحونه من أي جهاز دون تثبيت ودون متجر، ولذلك هي غالباً أول ما تنشره. وتعمل لعبة Godot في المتصفح لأن المحرك نفسه مبني بلغة WebAssembly، وهي صيغة كود يشغلها المتصفح بسرعة قريبة من البرامج العادية، والرسم يتم بـ WebGL 2.0، ولذلك يشترط توثيق التصدير إلى الويب أن يدعم المتصفح الاثنين، وأن تستخدم لعبتك طريقة الرسم Compatibility، فطرق الرسم الأخرى Forward+ وMobile لا تعمل في المتصفح. وإذا كنت تكتب لعبتك بـ C# فانتبه إلى أن مشاريع C# في Godot 4 لا تصدر إلى الويب حالياً بحسب التوثيق نفسه.
وهذا ما يحمله المتصفح لتعمل لعبتنا، مع حجم ملف المحرك بعد ضغطه بطريقتين:
### 1. What the browser downloads (no-threads build)
index.apple-touch-icon.png 0.01 MB
index.audio.position.worklet.js 0.00 MB
index.audio.worklet.js 0.01 MB
index.html 0.01 MB
index.icon.png 0.01 MB
index.js 0.27 MB
index.pck 0.12 MB
index.png 0.02 MB
index.wasm 37.68 MB gzip 9.68 MB (26%) brotli 6.77 MB (18%)
في المخرج أعلاه لاحظ التالي:
- ملف
index.wasm: هو المحرك نفسه، وحجمه 37.68 ميجابايت، وهو ما ينتظره اللاعب قبل أن يرى أي شيء. - الضغط يغير كل شيء: بالضغط gzip نزل الحجم إلى 26% من أصله، وبالضغط Brotli إلى 18%، وهذا يطابق ما يذكره توثيق Godot من أن ملف WebAssembly يضغط إلى حوالي ربع حجمه.
- ملفات أخرى صغيرة:
index.jsيحمل المحرك ويشغله، وindex.htmlهي الصفحة، وملفاتaudio.workletللصوت، والصور للأيقونة وشاشة البداية.
ولذلك فإن أول ما تفعله قبل أن تفكر في تصغير لعبتك هو أن تتأكد أن السيرفر يرسل ملف wasm مضغوطاً، فبعض الاستضافات تضغط الملفات وحدها مثل GitHub Pages، وبعضها لا يضغطها مثل itch.io وGitLab Pages كما يذكر التوثيق، وعندها تحتاج أن ترفع نسخة مضغوطة مسبقاً إذا كانت الاستضافة تدعم ذلك. وتأكد أيضاً أن السيرفر يرسل ملف wasm بنوع المحتوى application/wasm، وفي المختبر كتبنا سيرفراً صغيراً بـ Node يفعل ذلك.
وقد تسأل: لماذا لا أفتح ملف index.html بالضغط عليه مرتين وأنتهي؟ والإجابة أن ملفات التصدير صممت لتأتي من سيرفر ويب كما يذكر التوثيق، بأنواع محتوى صحيحة وبالـ Headers التي تحتاجها نسخة Threads، ولذلك جرب نسخة الويب دائماً من خلال سيرفر ولو على جهازك. ومستودع Godot نفسه فيه سكربت Python صغير اسمه serve.py يذكره التوثيق لهذا الغرض، ويرسل Headers العزل أيضاً، ولكنه للتجربة فقط، أما النشر الحقيقي فيكون على سيرفر مثل Nginx أو Apache أو على استضافة الملفات الثابتة.
وتذكر أن الويب يعمل على أجهزة ضعيفة أيضاً، فالجوال القديم الذي يفتح رابطك يشغل المحرك بـ WebAssembly لا بكود أصلي، ولذلك يقترح التوثيق أن تستعمل وسوم المنصة لتخفف إعدادات الرسم في نسخة الويب وحدها، مثل جودة الظلال وعدد الجزيئات Particles، دون أن تغير النسخ الأخرى، وهذه فائدة عملية لوسم web الذي رأيناه في المخرج.
ثم فتحنا نسخة الويب في متصفح Chrome دون شاشة Headless، وهذا ما ظهر على الشاشة:

السطر الأول صار مربعات فارغة، والسطران تحته سليمان لأنهما بالخط الذي وضعناه داخل المشروع. والسبب أن تحميل خطوط النظام في Godot مدعوم على Windows وmacOS وLinux وAndroid وiOS فقط بحسب توثيق الخطوط، والويب ليس منها، فلا يجد المحرك في المتصفح خطاً عربياً يستعيره. وهذا من أشهر الأخطاء في الألعاب العربية: تظهر اللعبة سليمة طوال التطوير على جهاز المطور، ثم يرسل أول لاعب على الويب صورة فيها مربعات بدل الكلام.
لماذا تحتاج بعض نسخ الويب Headers خاصة؟
صدرنا نسختين للويب، واحدة تستخدم Threads وواحدة لا تستخدمها، والفرق بينهما يظهر عندما تضعهما على سيرفر. وخيوط التنفيذ Threads في المتصفح تعتمد على شيء اسمه SharedArrayBuffer، وهو ذاكرة مشتركة بين أكثر من خيط تنفيذ، والمتصفحات اليوم لا تعطي هذه الذاكرة لأي صفحة، وإنما للصفحة المعزولة Cross-Origin Isolated فقط، والصفحة تكون معزولة عندما يرسل السيرفر معها Header اسمه Cross-Origin-Opener-Policy: same-origin وآخر اسمه Cross-Origin-Embedder-Policy: require-corp.
SharedArrayBuffer يسمح ببناء مؤقت دقيق جداً، فعطلته المتصفحات كلها تقريباً، كما أعلنت Mozilla في مدونتها الأمنية في 3 يناير 2018. ثم أعادته Chrome على أجهزة الكمبيوتر في الإصدار 68 بعد أن عزلت كل موقع في عملية منفصلة، وفي Chrome 92 أصبح متاحاً للصفحات المعزولة فقط، كما في إعلان Chrome، وهذا هو الشرط الذي ما زلنا نعيش معه اليوم كما يشرح توثيق MDN.ولكي نرى ماذا يعني هذا عملياً، شغل سكربت web-check.mjs سيرفرين على جهازك: الأول عادي، والثاني يرسل هذين الـ Headers، ثم فتح كل نسخة على كل سيرفر في Chrome وقرأ ما كتبته اللعبة. وهذا السكربت كاملاً:
// Serve the two Web builds from a plain server and from one that sends the cross-origin isolation headers,
// open each in headless Chrome, and report what the game printed (or why it did not start).
// node web-check.mjs (needs Chrome and scripts/lab/browser.mjs from this repository)
import { createServer } from 'node:http';
import { readFileSync, existsSync, statSync, readdirSync } from 'node:fs';
import { join, extname, resolve, dirname } from 'node:path';
import { fileURLToPath } from 'node:url';
import { gzipSync, brotliCompressSync, constants } from 'node:zlib';
import { launch } from '../../../../scripts/lab/browser.mjs';
const here = dirname(fileURLToPath(import.meta.url));
const build = resolve(here, 'build');
const TYPES = { '.html': 'text/html', '.js': 'text/javascript', '.wasm': 'application/wasm', '.pck': 'application/octet-stream', '.png': 'image/png', '.json': 'application/json' };
const ISOLATION = { 'Cross-Origin-Opener-Policy': 'same-origin', 'Cross-Origin-Embedder-Policy': 'require-corp' };
function serve(port, isolate) {
const srv = createServer((req, res) => {
const f = join(build, decodeURIComponent(req.url.split('?')[0]).replace(/\/$/, '/index.html'));
if (!f.startsWith(build) || !existsSync(f) || statSync(f).isDirectory()) { res.writeHead(404).end(); return; }
res.writeHead(200, { 'Content-Type': TYPES[extname(f)] || 'application/octet-stream', 'Cache-Control': 'no-store', ...(isolate ? ISOLATION : {}) });
res.end(readFileSync(f));
});
return new Promise(r => srv.listen(port, '127.0.0.1', () => r(srv)));
}
const mb = (n) => (n / 1048576).toFixed(2) + ' MB';
console.log('### 1. What the browser downloads (no-threads build)');
for (const f of readdirSync(join(build, 'web-nothreads')).sort()) {
const buf = readFileSync(join(build, 'web-nothreads', f));
const line = `${f.padEnd(24)} ${mb(buf.length).padStart(9)}`;
if (f.endsWith('.wasm')) {
const gz = gzipSync(buf, { level: 9 }).length, br = brotliCompressSync(buf, { params: { [constants.BROTLI_PARAM_QUALITY]: 11 } }).length;
console.log(`${line} gzip ${mb(gz)} (${Math.round(gz / buf.length * 100)}%) brotli ${mb(br)} (${Math.round(br / buf.length * 100)}%)`);
} else console.log(line);
}
const plain = await serve(8601, false), isolated = await serve(8602, true);
const b = await launch({ port: 9999, width: 640, height: 360, args: ['--enable-unsafe-swiftshader', '--use-angle=swiftshader'] });
const runs = [
['web-nothreads', 8601, 'a plain server'], ['web-nothreads', 8602, 'a server with COOP/COEP'],
['web-threads', 8601, 'a plain server'], ['web-threads', 8602, 'a server with COOP/COEP'],
];
let n = 1;
try {
for (const [dir, port, how] of runs) {
n++;
console.log(`### ${n}. ${dir} on ${how}`);
const start = Date.now();
await b.goto(`http://127.0.0.1:${port}/${dir}/index.html`, { wait: 200 });
let first = 0, done = false;
for (let i = 0; i < 120 && !done; i++) {
const s = await b.evaluate(`({ lab: (window.__lab || []).filter(l => l.includes('LAB')).length,
notice: (() => { const e = document.getElementById('status-notice'); return e && getComputedStyle(e).display !== 'none' && e.textContent.trim() ? e.textContent.trim() : ''; })() })`);
if (s.lab && !first) first = Date.now() - start;
done = s.lab >= 3 || !!s.notice;
if (!done) await b.sleep(250);
}
const r = await b.evaluate(`({ isolated: self.crossOriginIsolated, sab: typeof SharedArrayBuffer,
notice: (() => { const e = document.getElementById('status-notice'); return e && getComputedStyle(e).display !== 'none' ? e.innerText.trim() : ''; })(), lab: window.__lab || [] })`);
console.log(`crossOriginIsolated=${r.isolated} SharedArrayBuffer=${r.sab}`);
if (r.notice) console.log('the page shows instead of the game:\n' + r.notice.split('\n').map(l => ' ' + l.trim()).filter(l => l.trim()).join('\n'));
for (const l of r.lab.filter(l => l.includes('LAB'))) console.log(l.replace(/^log: /, ''));
if (first) console.log(`first LAB line after ${(first / 1000).toFixed(1)} s`);
if (dir === 'web-nothreads' && port === 8601) await b.shot(resolve(here, '../images/03-web-build.webp'));
if (dir === 'web-threads' && port === 8601) await b.shot(resolve(here, '../images/05-web-threads-error.webp'));
}
} finally { await b.close(); plain.close(); isolated.close(); }والمخرج للنسخة دون Threads سوف يكون كما يلي:
### 2. web-nothreads on a plain server
crossOriginIsolated=false SharedArrayBuffer=undefined
LAB platform=Web features=web,nothreads,template,release
LAB renderer=gl_compatibility driver=opengl3 cpus=2
LAB after 6.0 s: frames=343 caught=6 missed=3
first LAB line after 5.2 s
### 3. web-nothreads on a server with COOP/COEP
crossOriginIsolated=true SharedArrayBuffer=function
LAB platform=Web features=web,nothreads,template,release
LAB renderer=gl_compatibility driver=opengl3 cpus=2
LAB after 6.0 s: frames=339 caught=6 missed=3
first LAB line after 2.6 sالنسخة دون Threads عملت على السيرفرين، ولاحظ أن SharedArrayBuffer غير موجود أصلاً على السيرفر العادي، ومع ذلك لم تحتجه اللعبة. أما النسخة التي تستخدم Threads فهذا ما حدث لها:
### 4. web-threads on a plain server
crossOriginIsolated=false SharedArrayBuffer=undefined
the page shows instead of the game:
Error
The following features required to run Godot projects on the Web are missing:
Cross-Origin Isolation - Check that the web server configuration sends the correct headers.
SharedArrayBuffer - Check that the web server configuration sends the correct headers.
### 5. web-threads on a server with COOP/COEP
crossOriginIsolated=true SharedArrayBuffer=function
LAB platform=Web features=web,threads,template,release
LAB renderer=gl_compatibility driver=opengl3 cpus=2
LAB after 6.0 s: frames=341 caught=6 missed=3
first LAB line after 2.1 sعلى السيرفر العادي لم تبدأ اللعبة أصلاً، وظهرت مكانها هذه الرسالة:

وهذه الرسالة هي كل ما يراه اللاعب، فلا توجد لعبة تعمل ببطء ولا رسالة لطيفة، وإنما صفحة خطأ تطلب إعداد السيرفر، واللاعب لا يملك السيرفر. والصورة التالية تجمع التجارب الأربع:

فقد يتساءل البعض: لماذا لا أرسل الـ Headers دائماً وأنتهي؟ والإجابة أن العزل له ثمن، فالصفحة المعزولة لا تستطيع أن تحمل محتوى من موقع آخر إلا إذا سمح ذلك الموقع بذلك صراحة، وهذا يعني أن الإعلانات وأدوات الطرف الثالث في الغالب لن تعمل في صفحة لعبتك، وكثير من مواقع الألعاب تعرض لعبتك داخل iframe لا تتحكم في Headers صفحته. ولهذا السبب أضاف Godot في الإصدار 4.3 التصدير دون Threads وجعله الطريقة الافتراضية، كما شرح الفريق في تقرير تطوير التصدير إلى الويب في 4.3، ويذكر التوثيق أنه أكثر توافقاً مع itch.io ومواقع مثل Poki وCrazyGames ومع متصفحات macOS وiOS.
ومتى تحتاج Threads إذن؟ عندما تستخدم خيوط التنفيذ في كودك فعلاً، أو تحتاج صوتاً من نوع Stream بزمن تأخير منخفض، أو تستخدم إضافات GDExtension، فهذه الحالات الثلاث هي التي يربطها التوثيق بالعزل. وإذا احتجتها ولم تكن تتحكم في السيرفر، ففعل خيار Progressive Web App في إعدادات التصدير، فهو يضيف Service Worker يحاكي وجود هذه الـ Headers، بشرط أن تعمل الصفحة على HTTPS، والسبب أن المتصفح لا يعطي هذه الميزات إلا لسياق آمن Secure Context، ويستثنى من ذلك localhost في الغالب، ولهذا عملت تجاربنا على جهازنا دون شهادة.
ما الذي يختلف في المتصفح؟
حتى بعد أن تعمل لعبتك في المتصفح، هناك أشياء تعمل على الكمبيوتر وتختلف في الويب لأسباب أمنية، ويجمعها توثيق Godot في قسم القيود Limitations، وأهمها ما يلي:
- التبويب غير النشط: يوقف المتصفح اللعبة عندما ينتقل اللاعب إلى تبويب آخر، فتتوقف
_processو_physics_process، وقد ينقطع اتصال اللعبة الجماعية إذا طال ذلك. - ملء الشاشة وحبس مؤشر الفأرة: لا يسمح بهما المتصفح إلا استجابة لحدث من اللاعب، أي من داخل دالة مثل
_input، لا من كود يعمل وحده عند بداية اللعبة. - الصوت: المتصفحات تمنع تشغيل الصوت قبل أن يتفاعل اللاعب مع الصفحة، ولذلك ابدأ لعبتك بشاشة تطلب ضغطة زر قبل الموسيقى.
- الشبكة: لا يوجد اتصال منخفض المستوى بـ TCP أو UDP في المتصفح، والمتاح هو HTTP وWebSocket وWebRTC فقط.
- حفظ اللعبة: ملفات
user://تحفظ في IndexedDB الخاصة بالمتصفح، فإذا كان اللاعب في وضع التصفح الخفي أو منع ملفات تعريف الارتباط Cookies ضاع حفظه.
وهذه ليست أخطاء في Godot، وإنما قواعد المتصفح على كل المواقع، ولذلك صمم لعبتك من البداية على أن تعمل ضمنها إذا كان الويب منصتك الأولى.
سطح المكتب: Windows وLinux وmacOS
التصدير إلى الكمبيوتر هو الأبسط تقنياً كما رأينا، فالقالب والحزمة يكفيان، ولكن الفرق الحقيقي بين المنصات الثلاث يظهر في المعمارية وفي التوقيع.
المعمارية Architecture: يصدر Godot لـ Windows بثلاث معماريات: x86_64 وهي الافتراضية ومعالجات أغلب الأجهزة، وx86_32 للأنظمة القديمة ذات 32 بت التي لم تعد Microsoft تدعمها، وarm64 لأجهزة Windows بمعالجات ARM مثل Snapdragon X Elite، كما في توثيق التصدير إلى Windows. وفي Linux تتوفر قوالب رسمية لـ x86_64 وx86_32 وarm64 وarm32، فتستطيع أن تصدر لعبتك لـ Raspberry Pi بقالب رسمي، أما المعماريات الأخرى مثل RISC-V فتبني قوالبها بنفسك. وفي macOS يكون التطبيق Universal دائماً مع القوالب الرسمية كما رأينا في المختبر.
دمج الحزمة في البرنامج: إذا أردت ملفاً واحداً بدل البرنامج والحزمة ففعل خيار دمج الحزمة Embed PCK، ولكن انتبه إلى أن التوثيق يحدد حجم الملف المدمج بحوالي 3.89 جيجابايت، فإذا كانت لعبتك كبيرة فاتركها ملفين.
التوقيع على Windows: يستطيع Godot أن يوقع البرنامج وقت التصدير بأداة SignTool من Windows SDK، أو بأداة osslsigncode إذا كنت تصدر من نظام آخر، ويحتاج ذلك شهادة توقيع كود Code Signing Certificate. والتوقيع يثبت للاعب اسم الناشر، ولكنه لا يمنع وحده تحذير Microsoft Defender SmartScreen، فهذا التحذير يظهر كما يشرح توثيق Microsoft لكل ملف ليس في قائمة الملفات المعروفة التي ينزلها كثير من المستخدمين، ولعبتك الجديدة ليست في هذه القائمة بكل تأكيد. ولذلك نبه اللاعبين في صفحة التنزيل إلى أن هذه الرسالة متوقعة، أو انشر على متجر مثل Steam يثبت اللعبة بنفسه.
التوقيع والتوثيق على macOS: هنا القواعد أشد، فبحسب توثيق التصدير إلى macOS لا يشغل macOS افتراضياً إلا التطبيقات الموقعة والموثقة Notarized، والتطبيق غير الموثق الذي ينزل من الإنترنت يمنعه Gatekeeper. والتوثيق Notarization هو أن ترسل تطبيقك إلى Apple لتفحصه آلياً ثم تلصق نتيجة الفحص به، ويحتاج حساب Apple Developer وشهادة Developer ID. ويمكنك أن توقع وتوثق من Linux وWindows أيضاً بأداة rcodesign، فلا تحتاج جهاز Mac لهذه الخطوة. أما التوقيع المحلي Ad-hoc الذي وضعه Godot في المختبر فيجعل تشغيل التطبيق أسهل على من يعرف طريقة تجاوز التحذير، ولكنه لا يغني عن التوثيق إذا كنت تبيع لعبتك للناس.
.app مباشرة فلن تعمل على Mac، لأن نظام ملفات Windows لا يحفظ صلاحية التشغيل Executable للبرنامج داخل المجلد. صدرها بصيغة .zip كما فعلنا في المختبر، أو أضف الصلاحية بالأمر chmod +x على جهاز Mac أو Linux.الجوال: Android وiOS
التصدير إلى الجوال يحتاج أدوات المنصة نفسها، ولذلك لم نضعه في المختبر، فهو يحتاج تنزيل عدة جيجابايتات من أدوات Google أو جهاز Mac، وهذا ما تحتاجه لكل منصة بحسب توثيق Godot 4.7.
Android: بحسب توثيق التصدير إلى Android تحتاج OpenJDK 17 وAndroid SDK، والتوثيق يذكر الحزم بأرقامها، ومنها Build-Tools 35.0.1 ومنصة android-35، ثم تضع مساريهما في إعدادات المحرر. وتصدر من Windows أو Linux أو macOS، وينتج التصدير ملف APK تثبته على جوالك للتجربة. أما متجر Google Play فيشترط منذ أغسطس 2021 أن ترفع التطبيقات الجديدة بصيغة AAB، ولكي تصدر AAB تحتاج بناء Gradle الذي يذكره التوثيق. وكل تطبيق Android يجب أن يوقع بمفتاح من ملف Keystore، وتنشئه بأداة keytool، واحفظ هذا الملف وكلمة مروره في مكان آمن خارج المشروع، والسبب أنه ما يثبت أن التحديث القادم منك أنت.
iOS: هنا لا يوجد بديل عن جهاز Mac، فبحسب توثيق التصدير إلى iOS يجب أن يكون التصدير من macOS وعليه Xcode. ولا ينتج Godot تطبيقاً جاهزاً لـ iOS، وإنما مشروع Xcode تفتحه في Xcode وتبنيه وترفعه منه، ويحتاج التصدير معرف الفريق App Store Team ID ومعرف الحزمة Bundle Identifier، ولن يكمل التصدير دونهما.
ولاحظ أن نسخة الويب تعمل على الجوال أيضاً، فإذا كانت لعبتك صغيرة ولا تريد المتاجر بعد فرابط الويب طريقة سريعة لتصل إلى الجوال، مع أن التوثيق يذكر أن النسخ الأصلية Native على Android وiOS أسرع منها بفارق كبير، لأن WebAssembly أبطأ من الكود الأصلي ولأن أداء الجوال محدود أصلاً.
النشر في المتاجر
بعد التصدير يبقى أن تضع لعبتك حيث يجدها الناس، ولكل متجر شروطه ورسومه، والصورة التالية تجمع ما تطلبه كل منصة قبل أن يثبت اللاعب لعبتك:

- Steam: بعد أن تكمل التسجيل في Steamworks تدفع 100 دولار عن كل لعبة جديدة تنشرها، كما في صفحة رسوم Steam Direct.
- itch.io: أنت من يختار النسبة التي تذهب إلى الموقع من كل عملية بيع، ويسمونها مشاركة الإيراد المفتوحة Open Revenue Sharing كما في أسئلة المطورين في itch.io، وهو مكان ممتاز لأول نسخة ويب من لعبتك.
- Google Play: رسوم تسجيل 25 دولاراً مرة واحدة لحساب المطور، كما في صفحة إنشاء حساب المطور، مع التحقق من هويتك.
- App Store: برنامج Apple Developer رسومه 99 دولاراً كل سنة، كما في صفحة البرنامج، وهو الحساب نفسه الذي تحتاجه لتوثيق تطبيق macOS.
ولاحظ أن رسوم المتجر شيء ورخصة المحرك شيء آخر، فقد شرحنا في مقال محركات الألعاب أن Godot لا يأخذ شيئاً من مبيعاتك، ويكفي أن تضع نص رخصته مع لعبتك، والمتاجر تأخذ نسبتها من كل بيع بحسب شروط كل متجر.
أخطاء شائعة
- إصدار القوالب لا يطابق المحرر: إذا ترقيت إلى إصدار جديد من Godot فنزل قوالبه أيضاً، فالمحرر لا يستعمل قوالب إصدار آخر.
- الاعتماد على خطوط الجهاز: النص العربي الذي يظهر سليماً على جهازك قد يصبح مربعات في المتصفح كما رأينا، فضع خطاً عربياً داخل المشروع دائماً.
- تفعيل Threads دون سبب: النسخة دون Threads تعمل على أي سيرفر، والنسخة معها لا تبدأ أصلاً إذا غابت Headers العزل.
- نسيان ضغط ملف wasm: 37.7 ميجابايت دون ضغط مقابل أقل من 10 مع الضغط، والفرق يشعر به كل لاعب على اتصال بطيء.
- تجربة اللعبة في المحرر فقط: مشاكل مثل الخطوط وصيغ الخامات وANGLE لا تظهر إلا في النسخة المصدرة على جهاز حقيقي، فصدر وجرب مبكراً لا في ليلة النشر.
- رفع ملف
export_credentials.cfgإلى Git: فيه كلمات مرور التوقيع، وهو داخل مجلد.godotالذي يجب أن يكون في.gitignoreأصلاً. - ضياع مفتاح Android: احفظ ملف Keystore وكلمة مروره في نسخة احتياطية Backup خارج جهازك.
تطبيق عملي
- احذف الخط من السطر الثاني في
main.gdليصبح بالخط الافتراضي، ثم شغلbash run.sh، وافتح الصورةimages/03-web-build.webpلترى أن السطرين صارا مربعات في المتصفح. - غير
binary_format/embed_pckإلىtrueفي إعداد Linux، وصدر مرة أخرى، وقارن عدد الملفات وحجمها. - أضف إلى السيرفر في
web-check.mjsضغط gzip لملف wasm، وقس الفرق في زمن ظهور أول سطر من اللعبة.
حذف المختبر Cleanup
القوالب التي نزلها المختبر تأخذ 1.2 جيجابايت في مجلد cache، والنسخ المصدرة حوالي 310 ميجابايت في مجلد build، فاحذفهما مع الـ Image:
rm -rf cache build
docker image rm export-lab:1الخلاصة Summary
- التصدير يضع حزمة لعبتك PCK بجانب قالب تصدير، وهو المحرك مبنياً دون المحرر لكل منصة، والقالب متطابق في كل الألعاب.
- في المختبر كانت حزمة اللعبة 118.5 كيلوبايت، والمحرك 104.1 ميجابايت على Windows و70.2 على Linux و37.7 في الويب.
- نسخة macOS تحتاج تفعيل صيغة الخامات ETC2 ASTC، ونسخة iOS تحتاج جهاز Mac وXcode، ونسخة Android تحتاج JDK وAndroid SDK.
- Godot يستعير خطوط النظام على الكمبيوتر والجوال لا في المتصفح، ولذلك ظهر النص العربي بالخط الافتراضي مربعات في الويب، والحل خط عربي داخل المشروع.
- نسخة الويب دون Threads تعمل على أي سيرفر، والنسخة مع Threads تحتاج Headers العزل COOP وCOEP بسبب قيود ما بعد Spectre.
- ضغط ملف wasm على السيرفر يخفض التحميل من 37.7 ميجابايت إلى 9.7 بالضغط gzip و6.8 بالضغط Brotli.
- التوقيع يثبت اسمك على Windows، والتوقيع والتوثيق شرط عملي على macOS، ورسوم المتاجر منفصلة عن رخصة المحرك.
وفي المقالات القادمة بإذن الله نبني أول لعبة كاملة مع Godot خطوة خطوة، ونخصص مقالاً للواجهة والنص العربي في الألعاب:
دليلأول لعبة مع Godot: المشاهد والعقد وGDScriptنبني لعبة صغيرة كاملة في Godot 4 من ثلاثة مشاهد وأربعة سكربتات، ونفهم بها العقد والمشاهد والإشارات وحلقة اللعبة، ثم نشغلها في مختبر يلعبها فيه روبوت حتى تنتهي.
دليلمحركات الألعاب: Godot وUnity وUnreal وتراخيصهاما الذي يعطيك محرك الألعاب حتى لا تكتبه بنفسك، وكيف تعمل حلقة اللعبة في مختبر Godot حقيقي، وماذا تدفع لكل محرك ومتى.
دليلكيف تعمل اللعبة من الداخل؟ حلقة اللعبة Game Loopلماذا تتحرك الشخصية بالسرعة نفسها على شاشة 144 هرتز وحاسوب بطيء: نبني حلقة اللعبة من الصفر حتى الخطوة الثابتة والاستيفاء، ونقيس كل طريقة في مختبر.سجل التحديثات Changelog
- نوفمبر 2026: كتابة المقال، وتصدير المختبر بـ Godot 4.7.2 وقوالبه الرسمية داخل Docker Engine 29.8.0، وتشغيل النسخ على Linux وWindows 11 وChrome 157، ومراجعة رسوم المتاجر من صفحاتها الرسمية في 12 نوفمبر 2026.