هذا الدليل مخصص للمطورين والـPackagers فقط. بناء Eden من المصدر يحتاج معرفة بـGit وCMake والمترجمات وحل أخطاء الاعتماديات، وليس الطريقة المناسبة للمستخدم اللي يبي يشغل المحاكي فقط.

للمستخدم العادي

Eden Emulator 2025: تثبيت وتشغيل Switch

ما تحتاج تبني المشروع من المصدر عشان تستخدم Eden. تابع شرح التثبيت والتشغيل الجاهز في قناة HAKAMIQ بدل الدخول في بيئة التطوير.

فتح الفيديو داخل قناة HAKAMIQ

تنبيه المطورين

الدعم المخصص لعملية البناء غالبًا يُقدم للمطورين والـPackagers فقط. لا تستخدم هذه الخطوات كبديل عن تنزيل Stable أو Nightly الجاهز.
تعليمات البناء والاعتماديات تتغير مع تطور المشروع. استخدم صفحة المنصة الرسمية وراجع آخر تغييرات المستودع قبل تثبيت نسخ محددة من CMake أو Qt أو المترجم.

الاعتماديات الأساسية

تختلف الحزم الدقيقة حسب النظام وطريقة البناء، لكن بيئة التطوير تحتاج عادةً العناصر التالية:

Git لاستنساخ المستودع وتحديث المصدر.
CMake حديث لتهيئة المشروع وتوليد ملفات البناء.
C++ Toolchain مثل GCC أو Clang أو MSVC/clang-cl حسب النظام.
Qt 6 وVulkan لبناء الواجهة الرسومية ومكونات العرض المطلوبة.
Ninja أو Generator مناسب حسب طريقة البناء والبيئة المستخدمة.
حزم المنصة مكتبات وأدوات إضافية موضحة في صفحة Dependencies الخاصة بنظامك.
المشروع رفع الحد الأدنى لـCMake في الإصدارات الحديثة. لا تعتمد على قوائم اعتماديات قديمة محفوظة في شروحات أو توزيعات سابقة.

استنساخ مصدر Eden

افتح Terminal أو PowerShell في المكان اللي تبي تحفظ المشروع داخله، ثم نفذ: 

git clone https://git.eden-emu.dev/eden-emu/eden.git
cd eden
تقدر تستنسخ المشروع من داخل Qt Creator عبر: Create Project → Import Project → Git Clone.

بناء Android

نسخة Android تستخدم مسار بناء مختلف عن نسخ Desktop، لذلك ما تطبق عليها خطوات Qt Creator أو CMake العامة الموجودة تحت.

افتح دليل Building for Android الرسمي والتزم بنسخ Android Studio وSDK وNDK وGradle المذكورة فيه.

اختيار طريقة التهيئة والبناء

Option A — Qt Creator الطريقة الرسومية الموصى بها على Linux وmacOS وWindows. مناسبة لتحرير الكود والتهيئة والبناء والتشغيل من نفس الواجهة.
Option B — Command Line الأفضل للـCI والسكربتات والمطور اللي يعرف CMake وGenerators. الإعداد يتغير حسب النظام والمترجم.
Option C — CLion بيئة JetBrains مع CMake Profiles وToolchains. تحتاج ضبط Build Type وGenerator ومسار build.
Option D — Visual Studio + clang-cl خيار Windows لاستخدام Visual Studio Generator مع ClangCL. موجه للمطورين اللي يحتاجون اختبار clang-cl بدل MSVC.

Option A — البناء باستخدام Qt Creator

1
افتح مجلد مصدر Eden أو استنسخه مباشرة من Qt Creator.
2
اختر Kit مناسب لنظامك ومعمارية الجهاز.
3
خل Build Type على Release للاستخدام الطبيعي، أو Debug فقط عند التشخيص.
4
راجع CMake Configuration واترك الخيارات الافتراضية أولًا.
5
اضغط Ctrl+B أو أيقونة المطرقة لبدء البناء.
6
للتشغيل اضغط Ctrl+R أو أيقونة Play.

Option B — البناء من Command Line

أمر التهيئة يختلف حسب النظام والـGenerator. المثال التالي يستخدم Ninja وRelease على بيئة تدعمه: 

cmake -S . -B build -G Ninja -DCMAKE_BUILD_TYPE=Release
cmake --build build --parallel
الأمر الأساسي المذكور في الدليل هو: cmake --build build. أضف --parallel مع Ninja أو UNIX Makefiles أو Visual Studio 2022 لتسريع البناء إذا كانت الذاكرة والمعالج تسمح.
لا تنسخ Generator من نظام مختلف. اختيار Ninja أو Visual Studio أو UNIX Makefiles يعتمد على الأدوات المثبتة عندك.

Option C — البناء باستخدام CLion

1
افتح المشروع داخل CLion وانتظر اكتمال فهرسة المصدر.
2
أنشئ CMake Profile باسم Release.
3
اختر Toolchain الصحيح واترك Generator تلقائيًا إلا إذا كانت صفحة منصتك تطلب غير ذلك.
4
خل Build Directory باسم build.
5
اختر Target الخاص بـEden ثم نفذ Build أو Run.

Option D — Visual Studio مع clang-cl

هذا الخيار مخصص لبناء Windows باستخدام Visual Studio Generator مع أداة ClangCL بدل مترجم MSVC الافتراضي. 

cmake -S . -B build -G "Visual Studio 17 2022" -A x64 -T ClangCL
cmake --build build --config Release --parallel
لازم تكون مكونات C++ وClang tools وWindows SDK مثبتة من Visual Studio Installer. لو فشلت التهيئة، ارجع لصفحة Dependencies الخاصة بـWindows.

مكان الملف التنفيذي بعد البناء

Windows build/bin/eden.exe
macOS build/bin/eden.app/Contents/MacOS/eden
Linux والأنظمة الأخرى build/bin/eden
بعض الـGenerators متعددة الإعدادات قد تضيف مجلدًا خاصًا بـRelease حسب طريقة التهيئة. راجع مخرجات CMake لو ما لقيت الملف في المسار المتوقع.

حل فشل Initial Configure

1
راجع دليل Dependencies من البداية وتأكد أن الأدوات موجودة في PATH.
2
احذف CPM Cache: .cache/cpm.
3
احذف CMake Cache: <build directory>/CMakeCache.txt.
4
اقرأ أول Error فعلي في سجل Configure، مو آخر سطر فقط.
5
راجع إعدادات CPM لمعرفة هل تحتاج إجبار المشروع على Bundled Package.
6
لو استمرت المشكلة، ارفق سجل Configure كامل عند طلب الدعم في Stoat أو Discord الخاص بالمشروع.
حذف CMakeCache.txt وحده قد ما يكفي إذا تغير Generator أو Toolchain. أحيانًا الأفضل حذف مجلد build كامل وإنشاؤه من جديد.

Caveats الخاصة بالمنصات

Windows وLinux وmacOS وبقية الأنظمة لها اختلافات في المترجمات والمكتبات ومسارات التشغيل والتوقيع وحزم الرسوميات. راجع Caveats الخاصة بمنصتك قبل اعتبار أي خطأ مشكلة في كود Eden نفسه.

استخدام سكربتات CI

مستودع Eden يحتوي سكربتات CI تقدر تراجعها لفهم طريقة إعداد بيئات البناء الرسمية. على أي POSIX Shell يمكن الاستفادة من: 

.ci/common/configure.sh
المطورون يشجعون على كتابة سكربتك الخاص اعتمادًا على CMake بدل نسخ سكربت CI كامل بدون فهم؛ سكربتات CI قد تحتوي افتراضات خاصة بخوادم البناء.

المصادر والروابط الرسمية

مستودع Eden الرسمي دليل البناء على Windows دليل البناء على Linux دليل البناء على Android جميع صفحات Eden Wiki تنزيل Builds الجاهزة سكربتات CI في المستودع شرح Eden في قناة HAKAMIQ

ابدأ بالاعتماديات الخاصة بمنصتك، ثم استنسخ المصدر وهيئ CMake ببيئة صحيحة. عند فشل البناء، اعتمد على أول خطأ فعلي ونظف Cache قبل تغيير خيارات عشوائية.