لإنشاء Piccolo، يجب عليك أولاً تثبيت الأدوات التالية.
Visual Studio 2019 (أو الأحدث)
CMake 3.19 (أو أحدث)
بوابة 2.1 (أو الأحدث)
Xcode 12.3 (أو الأحدث)
CMake 3.19 (أو أحدث)
بوابة 2.1 (أو الأحدث)
apt قم بتثبيت الحزم التالية
sudo apt install libxrandr-dev sudo apt install libxrender-dev sudo apt install libxinerama-dev sudo apt install libxcursor-dev sudo apt install libxi-dev sudo apt install libglvnd-dev sudo apt install libvulkan-dev sudo apt install cmake sudo apt install clang sudo apt install libc++-dev sudo apt install libglew-dev sudo apt install libglfw3-dev sudo apt install vulkan-validationlayers sudo apt install mesa-vulkan-drivers
برنامج تشغيل NVIDIA (برنامج تشغيل AMD وIntel مفتوح المصدر، وبالتالي يتم تثبيته تلقائيًا بواسطة برامج تشغيل mesa-vulkan)
يمكنك تنفيذ الأمر build_windows.bat . سيقوم هذا الملف الدفعي بإنشاء المشاريع وإنشاء تكوين الإصدار لمحرك Piccolo تلقائيًا. بعد الإنشاء الناجح، يمكنك العثور على PiccoloEditor.exe في دليل bin .
أو يمكنك استخدام الأمر التالي لإنشاء مشروع Visual Studio أولاً، ثم فتح الحل في دليل البناء وإنشائه يدويًا.
cmake -S . -B build
تم اختبار تعليمات البناء التالية فقط على أجهزة محددة من x86_64، ولا تدعم شرائح M1. بالنسبة للتوافق مع M1، سنصدره لاحقًا.
لتجميع Piccolo، يجب أن يكون لديك أحدث إصدار من Xcode مثبتًا. ثم قم بتشغيل "cmake" من الدليل الجذر للمشروع لإنشاء مشروع Xcode.
cmake -S . -B build -G "Xcode"
ويمكنك بناء المشروع مع
cmake --build build --config Release
أو يمكنك تنفيذ build_macos.sh لإنشاء الثنائيات.
يمكنك تنفيذ build_linux.sh لبناء الثنائيات.
للحصول على التوثيق، يرجى الرجوع إلى قسم ويكي.
لقد لاحظنا أن بعض المطورين على نظام التشغيل Windows لاحظوا أن PiccoloEditor.exe يمكن أن يعمل بشكل طبيعي ولكن أبلغوا عن استثناء Vulkan Validation Layer: Validation Error عند تصحيح الأخطاء. يمكنك حل هذه المشكلة عن طريق تثبيت Vulkan SDK (الإصدار الرسمي الأحدث سيفي بالغرض).
يمكنك إنشاء compile_commands.json
بالأوامر التالية عندما تكون مولدات Unix Makefiles
متاحة. compile_commands.json
هو الملف المطلوب من قبل خادم لغة clangd
، وهو واجهة خلفية لوضع cpp lsp في Emacs.
لنظام التشغيل Windows:
cmake -DCMAKE_TRY_COMPILE_TARGET_TYPE="STATIC_LIBRARY" -DCMAKE_EXPORT_COMPILE_COMMANDS=ON -S . -B compil_db_temp -G "Unix Makefiles" انسخ compil_db_tempcompile_commands.json .
يتوفر حاليًا برنامج Physics Debug Renderer على نظام التشغيل Windows فقط. يمكنك استخدام الأمر التالي لإنشاء الحل باستخدام مشروع مصحح الأخطاء.
كميك -S . -B البناء -DENABLE_PHYSICS_DEBUG_RENDERER=ON
ملحوظة:
الرجاء تنظيف دليل البناء قبل إعادة إنشاء الحل. لقد واجهنا مشكلات في البناء أثناء عملية التجديد مباشرةً باستخدام CMakeCache السابق.
سيتم تشغيل Physics Debug Renderer عند بدء تشغيل PiccoloEditor. لقد قمنا بمزامنة موضع الكاميرا بين المشهدين. لكن وضع الكاميرا الأولي في Physics Debug Renderer خاطئ. سيؤدي التمرير لأسفل باستخدام عجلة الماوس مرة واحدة إلى تغيير كاميرا Physics Debug Renderer إلى الوضع الصحيح.
بناء لينكس | |
بناء نظام التشغيل MacOS |