تخط المحتوى

ابنها

بناء كيت من المصادر على لينكس

في الوقت الحالي، شيفرة مصدر كيت موجودة على نُسخة غيت لاب invent.kde.org. يشرح هذا الدليل كيفية بناء كيت دون لمس تثبيتك العمومي.

سيحدث كل شيء داخل دليل تطوير إضافي. يتجنّب هذا الحاجة إلى صلاحيات المدير و يسمح دائما بالعودة إلى استخدام كيت المثبت عموميا إذا كانت النسخة المبنية حاليا معطّلة.

بما أن هذا الدليل سيقدّم إعدادا يسمح بتطوير أجزاء أخرى من مكدس برامج كيدي أيضا، سنتحدث فيما يلي عن إعداد بيئة تطوير كيدي. أطر عمل كيدي المطلوبة ستبنى بالإضافة إلى أجزاء تطبيق كيت. هذا يسهّل المساهمة في جميع مستويات مكدس برامج كيدي.

اختر دليل تطوير كيت و كيدي الخاص بك

اختر بنفسك مسارا حيث يجب أن ينتهي به المطاف لجميع أشياء تطوير كيت و كيدي. بجانب ملفات إعداد المستخدم المحلية، لن يتلوّث شيء خارج هذا الدليل. يمكنك إعادة استخدام هذا للتطوير على أي جزء من مكدس برامج كيدي.

بالنسبة للأجزاء المتبقية من هذا الوصف، نستخدم

~/projects/kde

لا تتردد في تخصيص هذا.

تثبيت kdesrc-build

التثبيت هو مجرد استنساخ للنسخة الحالية تقريبا

mkdir -p ~/projects/kde/src
cd ~/projects/kde/src
git clone https://invent.kde.org/sdk/kdesrc-build.git

لسهولة الاستخدام لاحقا، من الأفضل ربط سكربت kdesrc-build رمزيّا ببعض المجلد داخل مسارك، مثل: إذا كان لديك مجلد ثنائي محلي للمستخدم:

ln -s ~/projects/kde/src/kdesrc-build/kdesrc-build ~/bin

اضبط kdesrc-build

لدى kdesrc-build مسار إعداد يمكنه اضبط الأشياء لك، انظر هذا التقديم.

هنا نعرض فقط ملف ~/.config/kdesrc-buildrc جيد بما فيه الكفاية لاحتياجات تطوير كيت.

يمكنك فقط نسخ و لصق الخيار أدناه في دليلك الرئيسي كـ ~/.config/kdesrc-buildrc و تعديل المسارات لاحتياجاتك. إذا التزمت بالمسار ~/projects/kde الذي اخترناه أعلاه، يجب أن يكون هذا قابلا للاستخدام 1:1.

global
    # استخدم أحدث برامج KF6 و المعتمدة على Qt6.
    branch-group kf6-qt6

    # استخدم ninja لإعادة بناء تزايدي أسرع، قم بإلغاء تفعيل بعض أشياء Qt 5 للحصول على تبعيات أقل
    cmake-options -G "Ninja" -DBUILD_WITH_QT6=ON -DQT_MAJOR_VERSION=6 -DPHONON_BUILD_QT5=OFF -DBUILD_QT5=OFF

    # أدوات clangd
    compile-commands-export yes
    compile-commands-linking yes

    # هيكل مسطّح
    directory-layout flat

    # دليل تثبيت برامج كيدي
    install-dir ~/projects/kde/usr

    # دليل شيفرة المصدر المنزّلة
    source-dir ~/projects/kde/src

    # الدليل لبناء كيدي فيه قبل التثبيت نسبة إلى دليل المصدر مبدئيّا
    build-dir ~/projects/kde/build
end global

include ${module-definitions-dir}/kf6-qt6.ksb

توصف السطور المهمة للحصول على تجربة جيدة لتطوير كيت (أو غيره من أشياء كيدي) مع كيت بالتفصيل أدناه.

تكامل LSP

# أدوات clangd
compile-commands-export yes
compile-commands-linking yes

تضمن هذه السطور أن CMake سيولّد ملفات compile_commands.json المطلوبة لتكامل LSP المعتمد على clangd. بجانب توليدها فقط داخل دليل البناء، سيقوم خيار الربط بربطها رمزيّا مرة أخرى إلى أدلة المصدر الخاصة بك. يسمح هذا بالاستخدام بلا ضبط لملحقة LSP داخل كيت (و غيره من المحرّرات).

تثبيت التبعيات المطلوبة (اختياري)

يوفّر kdesrc-build بعض أنماط الإعداد المبدئي لتثبيت الحزم المطلوبة للعديد من التوزيعات الشائعة لبدء التطوير. هذا مفيد إذا لم تكن متأكدا مما إذا كانت جميع حزم التطوير المطلوبة مثبتة على نظامك و لا تريد الاهتمام بهذا بنفسك يدويّا. بما أن هذا سيحاول تثبيت حزم لتوزيعك، ستتطلب هذه الخطوة صلاحيات المدير لتثبيت الحزمة. لفعل ذلك، فقط شغل:

kdesrc-build --initial-setup

أنشأنا بالفعل ملف .config/kdesrc-buildrc، الذي لن يلمس. للاستخدام الإضافي، لا تحتاج إلى تعديل إعدادات صدفتك أيضا.

بناء كيت و التبعيات

لتشغيل بناء كيت و جميع تبعيات كيدي المطلوبة الآن فقط اكتب:

kdesrc-build --include-dependencies kate

يستغرق هذا بضع دقائق على حاسوب حديث. حان الوقت لأخذ بعض القهوة أو التفكير فيما تريد تنفيذه فعلا.

طالما أن نسخة KF 6 من تبعياتنا ليست مجمعة مع توزيعك، قد يكون من المنطقي بناء بعض الأجزاء الأخرى للحصول على تصميم أفضل و تكامل طرفية:

kdesrc-build --include-dependencies breeze plasma-integration kwayland-integration konsole kate

إذا كنت تريد فقط بناء كيت دون التبعيات لأنك متأكد أن لديك أشياء حديثة بما فيه الكفاية على نظامك، يمكنك تجربة:

kdesrc-build --no-include-dependencies kate

لكن بالنظر إلى أن أوقات البناء منخفضة على الحواسيب الحديثة، من الأسهل بناء كل شيء، مما يضمن أن لديك على سبيل المثال أحدث و أفضل أطر عمل KSyntaxHighlighting و KTextEditor أيضا!

بالنظر إلى هذا الإعداد، أنت حر في بناء جميع أجزاء برامج كيدي بـ:

kdesrc-build

تذكر: هذا سيستغرق بعض الوقت (و مساحة قرص).

إذا رأيت أي إخفاقات أثناء البناء معروضة بخط أحمر، اتبع هذا الدليل - كيفية حل مشاكل البناء

كيف تستخدم أشياء البناء؟

لتشغيل نسخة كيت المحلية الخاصة بك، تحتاج إلى إعداد البيئة أولا بشكل صحيح لضمان تحميل الملحقات و الأشياء الصحيحة. لحسن الحظ هذا بسيط جدا:

source ~/projects/kde/build/kate/prefix.sh
kate

طريقة ذكية لتغليف هذا هي على سبيل المثال أن تنشئ لنفسك سكربت غلاف صغير لبدء نسخة فرع الماستر من كيت داخل دليلك الثنائي المحلي:

#!/bin/bash
source ~/projects/kde/build/kate/prefix.sh
exec kate "$@"

اجعل أشياءك محدّثة

لجعل نسختك المحلية محدّثة، يمكنك فقط استخدام الأوامر أعلاه مرة أخرى. ستهتم بسحب التغييرات الجديدة من مستودعات كيدي و بناء/تثبيتها في بادئتك المحلية.

طوّر!

الآن، السؤال المتبقي هو: كيف يمكن التطوير بأفضل شكل؟

طبيعيّا، إذا كنت تريد القرصنة على كيت، قد يكون من المنطقي استخدام كيت لذلك.

بالنظر إلى الاستعدادات أعلاه، هذا سهل، فقط ابدأ نسخة الماستر الجديدة من كيت و مرّر لها دليل البناء:

kate ~/projects/kde/build/kate

بدلا من ذلك، يمكنك التنقّل إلى هناك في طرفيتك و بدء كيت من هناك، سيفتحه آليّا:

cd ~/projects/kde/build/kate
kate

للحصول على أفضل تجربة مع هذا، تأكد من أن لديك على الأقل ملحقة المشروع و LSP مفعّلة. إذا كنت تحب الحصول على بعض تكامل بناء الواجهة الرسومية، فعّل ملحقة البناء أيضا.

سينتهي بك الأمر بنافذة كيت جديدة كما هو مبيّن أدناه.

في عرض أداة "المشروع الحالي" السفلية لديك مبدئيّا طرفيتان. الطرفية الأولى داخل دليل البناء الخاص بك، هنا يمكنك على سبيل المثال تشغيل أوامرك ninja و ninja install و ما شابه. الطرفية الثانية داخل دليل المصدر الخاص بك، مثالية على سبيل المثال لاستدعاءات سطر أوامر git.

بالنظر إلى الإعداد أعلاه، يجب أن تعمل ملحقة LSP (إذا كان لديك clangd مثبت) بشكل مبدئي.

أشياء ذكية أخرى مثل الفتح السريع على نطاق المشروع، البحث و الاستبدال و أهداف البناء الصحيحة يجب أن تضبط أيضا.

ساهم!

لا تتردّد في إنشاء طلب دمج في invent.kde.org. للمزيد من المعلومات انظر انضم إلينا.

هل تحتاج دعم؟

إذا كانت لديك أسئلة يمكنك طرحها في قسم كيت الخاص بنا على خادم نقاش كيدي و/أو الانضمام إلى قناة مصفوفة كيت (مزيد من المعلومات العامة حول مصفوفة و كيدي هنا).

للمزيد من المعلومات انظر احصل على مساعدة.

بناء كيت من المصادر على ويندوز

لبناء كيت/KWrite المعتمد على KF5، يمكنك اتباع الدليل على كيدي على ويندوز.

بناء كيت من المصادر على ماك أو إس

لبناء كيت/KWrite المعتمد على KF5، يمكنك اتباع الدليل على كيدي على ماك أو إس.