LOOT عبارة عن مُحسِّن ترتيب تحميل البرنامج الإضافي من أجل:
يمكن لـ LOOT أن يقوم تلقائيًا بحساب ترتيب التحميل الذي يلبي جميع تبعيات المكونات الإضافية ويزيد من تأثير كل مكون إضافي على لعبتك. يمكنه أيضًا اكتشاف العديد من المشكلات، ويوفر عددًا كبيرًا من ملاحظات الاستخدام الخاصة بالمكونات الإضافية والتحذيرات واقتراحات Bash Tag لـ Wrye Bash.
في حين أن LOOT يمكنها التعامل مع الغالبية العظمى من المكونات الإضافية بشكل صحيح دون مساعدة، فإن بعض المكونات الإضافية تحتاج إلى بيانات تعريف إضافية ليتم فرزها بشكل صحيح. تحتوي LOOT على قائمة رئيسية من البيانات الوصفية لكل لعبة مدعومة، ويمكنك إضافة المزيد لتخصيص سلوك LOOT.
يساعد LOOT في تسهيل استخدام التعديلات، ويجب أن تمتلك معرفة عملية بترتيب تحميل التعديلات. راجع مقدمة لتحميل الطلبات للحصول على نظرة عامة.
يتم استضافة الإصدارات على جيثب. يجب على مستخدمي Linux تثبيت LOOT من Flathub.
تتوفر إصدارات اللقطات كعناصر أثرية من إجراءات GitHub، على الرغم من الاحتفاظ بها لمدة 90 يومًا فقط ولا يمكن تنزيلها إلا عند تسجيل الدخول إلى حساب GitHub. للتخفيف من هذه القيود، تتضمن عناصر بناء اللقطة توقيع GPG الذي يمكن التحقق منه باستخدام المفتاح العام المستضاف هنا، مما يعني أنه من الممكن إعادة تحميل العناصر في مكان آخر مع الاستمرار في إثبات صحتها.
تتم تسمية عناصر بناء اللقطة على النحو التالي:
loot_<last tag>-<revisions since tag>-g<short revision ID>_<branch>-<platform>.<file extension>
يتم أيضًا توفير إصدارات Snapshot كحزم Flatpak ذات ملف واحد، والتي يمكن تثبيتها على النحو التالي:
flatpak --user install ~/Downloads/loot.flatpak
قد ترغب أيضًا في تثبيت سمة Adwaita:
flatpak install flathub org.kde.KStyle.Adwaita//6.7
ارجع إلى .github/workflows/release.yml
للتعرف على عملية الإنشاء.
يفترض سير عمل GitHub Actions أن CMake وcurl وgettext وGit وInno Setup 6 وPython وVisual Studio 2019 و7-zip مثبتة بالفعل.
من المحتمل أن تكون ثنائيات Gettext المترجمة مسبقًا من vslavik هي أسهل طريقة للحصول على إصدار محدث من Gettext على نظام التشغيل Windows.
ارجع إلى مهمة flatpak
الخاصة بـ .github/workflows/ci.yml
للتعرف على عملية الإنشاء.
يعد بناء Flatpak مستقلاً نسبيًا ويجب أن يحتاج فقط إلى تثبيت ما يلي:
git
flatpak
flatpak-builder
python
، pip
و venv
قد يقوم توزيع Linux الخاص بك بتجميع Python وpip وvenv بشكل منفصل.
لم يتم تنفيذ جميع ميزات LOOT لإصدارات Linux. تغطي المشكلات التي تحمل علامة linux
في أداة تعقب المشكلات الخاصة بـ LOOT هذه الميزات المفقودة حيث يمكن تنفيذها.
لاحظ أن بناء Flatpak لا يعمل في حاوية غير مميزة. يتضمن ذلك تشغيل البرنامج النصي generate_manifests.sh
.
يستخدم LOOT متغيرات CMake التالية لتعيين معلمات البناء:
المعلمة | قيم | تقصير | وصف |
---|---|---|---|
LIBLOOT_URL | عنوان URL | عنوان URL لأرشيف إصدار GitHub | عنوان URL للحصول على أرشيف إصدار libloot منه. افتراضيًا، هذا هو عنوان URL لأرشيف إصدار libloot المستضاف على GitHub. يعد تحديد هذا مفيدًا إذا كنت تريد الارتباط بـ libloot الذي تم إنشاؤه وتعبئته محليًا. |
LOOT_BUILD_TESTS | ON ، OFF | ON | ما إذا كان سيتم إنشاء اختبارات LOOT أم لا. |
LOOT_RUN_CLANG_TIDY | ON ، OFF | OFF | ما إذا كان سيتم تشغيل clang-tidy أثناء الإنشاء أم لا. ليس له أي تأثير عند استخدام مولد MSVC الخاص بـ CMake. |
MINIZIP_NG_URL | عنوان URL | عنوان URL لأرشيف الإصدار | عنوان URL للحصول على أرشيف المصدر منه. |
OGDF_URL | عنوان URL | عنوان URL لأرشيف الإصدار | عنوان URL للحصول على أرشيف المصدر منه. |
VALVE_FILE_VDF_URL | عنوان URL | عنوان URL لأرشيف التزام GitHub | عنوان URL للحصول على أرشيف المصدر منه. |
ZLIB_URL | عنوان URL | عنوان URL لأرشيف الإصدار | عنوان URL للحصول على أرشيف المصدر منه. |
يمكن استخدام معلمات URL لتوفير مسار محلي إذا تم تنزيل الأرشيف بالفعل (على سبيل المثال للإصدارات غير المتصلة بالإنترنت).
قد تحتاج أيضًا إلى تعيين BOOST_ROOT
إذا لم يتمكن CMake من العثور على Boost، و Qt6_ROOT
(على سبيل المثال إلى C:/Qt/6.7.2/msvc2019_64
) إذا لم يتمكن CMake من العثور على Qt.
تم بناء التوثيق باستخدام أبو الهول. قم بتثبيت Python وتأكد من إمكانية الوصول إليه من خلال PATH
، ثم قم بتشغيل:
py -m venv .venv
.venvScriptsactivate
pip install -r docs/requirements.txt
sphinx-build -b html docs build/docs/html
إذا كنت تعمل على Linux، فاستبدل .venvScriptsactivate
بـ .venv/bin/activate
.
بدلاً من ذلك، يمكنك استخدام Docker لتجنب تغيير بيئة التطوير الخاصة بك، عن طريق تشغيل docker run -it --rm -v ${PWD}/docs:/docs/docs:ro -v ${PWD}/resources:/docs/resources:ro -v ${PWD}/build:/docs/build sphinxdoc/sphinx:7.1.2 bash
للحصول على shell الذي يمكنك استخدامه لتشغيل الاثنين الأوامر أعلاه.
يتم توفير البرامج النصية للتغليف لإنشاء برنامج تثبيت على Windows وأرشيفات مضغوطة على Windows وLinux.
قم بتشغيل البرنامج scripts/installer.iss
Inno Setup لإنشاء برنامج تثبيت قابل للتنفيذ في مجلد build
. إذا تم تثبيت ملفات الترجمة غير الرسمية للكورية والسويدية والصينية المبسطة Inno Setup إلى جانب ملفات الترجمة الرسمية، فسيقدم البرنامج النصي للمثبت أيضًا خيارات اللغة هذه. إذا لم يتم العثور عليها، فسيتم إنشاء المثبت بدونها.
يتطلب البرنامج النصي لتعبئة الأرشيف وجود Git، وفي نظام Windows يتطلب أيضًا 7-Zip، بينما في نظام Linux يتطلب tar
و xz
. يمكن تشغيله باستخدام python scripts/archive.py
وإنشاء أرشيف لـ LOOT في مجلد build
. تتم تسمية الأرشيفات كما هو موضح في قسم التنزيلات أعلاه.
يقوم البرنامج النصي لتعبئة الأرشيف باستدعاء windeployqt.exe
عند تشغيله على نظام التشغيل Windows: يجب أن يكون من الممكن الوصول إليه من خلال PATH
الخاص بك.