KomodoEdit
12.0.1
يشرح هذا الملف التمهيدي كيفية البدء في إنشاء قاعدة مصدر Komodo Edit واستخدامها وتطويرها.
بينما يتم استضافة مصدر تحرير كومودو الرئيسي ضمن هذا المستودع، فقد ترغب أيضًا في التحقق من مستودعات المكونات الفردية/الإضافات ضمن https://github.com/Komodo في حالة رغبتك فقط في المساهمة في مكون معين. سيوفر لك هذا بعض الوقت والمتاعب حيث لن تضطر إلى بناء المشروع بأكمله.
يمكنك تنزيل تحرير كومودو هنا.
هناك عدة طرق للتواصل مع مطوري Komodo:
جيثب: https://github.com/Komodo/KomodoEdit
المنتديات: http://forum.komodoide.com/
متعقب الأخطاء: https://github.com/Komodo/KomodoEdit/issues
آي آر سي: irc://irc.mozilla.org/#komodo
القوائم البريدية: مناقشة كومودو وكومودو بيتا وإعلان كومودو
لاحظ أن هذه خطوات مبسطة لعملية البناء، لإجراء فحص دليل أكثر تفصيلاً (قديم) BUILD.txt.
Python>=2.7 (لكن ليس Python 3.x بعد). يمكنك تثبيت ActivePython من هنا.
Visual C++ 11.0 (المعروف أيضًا باسم Visual Studio 2012) وجميع حزم SDK للنظام الأساسي لإنشاء Mozilla باستخدام vc11 كما هو موضح هنا.
قم بتثبيت الإصدار 1.9.0 من حزمة "MozillaBuild-$ver.exe" في الدليل الافتراضي (أي "C:mozilla-build").
قم بتثبيت بيرل <= 5.22
قم بتثبيت ميركوريال
راجع http://developer.mozilla.org/en/docs/Windows_Build_Prequirements لمزيد من التفاصيل حول المتطلبات الأساسية لبناء Windows. ومع ذلك، فإن اتباع الخطوات المذكورة أعلاه من المفترض أن يكون كافيًا للحصول على مبنى كومودو.
الخروج من تحرير كومودو: git clone https://github.com/Komodo/KomodoEdit.git
باستخدام سطر الأوامر، أدخل دليل الخروج الخاص بك وقم بتشغيل:
cd mozilla
setenv-moz-msvc11.bat
python build.py configure -k 11.10
python build.py distclean all
سيؤدي هذا إلى تكوين وبناء موزيلا ويمكن أن يستغرق من 30 دقيقة إلى عدة ساعات حتى يكتمل (حسب المواصفات الخاصة بك). بالنسبة لمعظم الأجهزة الحديثة، ينبغي أن يكون حوالي ساعة.
بعد إنشاء موزيلا بنجاح، ارجع إلى دليل الريبو الرئيسي وقم ببناء كومودو:
cd ..
set PATH=utilblack;%PATH%
bk configure -V 11.10.0-devel # --without-binary-dbgp-clients
bk build
يجب أن يستغرق هذا وقتًا أقل بكثير من بناء موزيلا.
بمجرد اكتمال البناء، يمكنك ببساطة تشغيل Komodo عن طريق تنفيذ bk run
عند إجراء أي تعديلات على المصدر، سيتعين عليك تشغيل bk build مرة أخرى، أو ببساطة bk build && bk run للعودة سريعًا إلى Komodo. يجب أن تكون عمليات البناء اللاحقة أسرع كثيرًا حيث يتم تخزين قدر كبير من البيانات المجمعة مؤقتًا.
Python>=2.7 (لكن ليس Python 3.x بعد). يمكنك تثبيت ActivePython من هنا.
إذا كنت تفضل إنشاءات Python من python.org فيجب أن تكون كافية أيضًا.
إكس كود 6.4 (SDK 10.9 و10.10). للحصول على 8.0 انظر أدناه. يمكنك الحصول على الإصدار 6.4 من موقع تنزيلات المطورين.
MacOSX10.10.sdk أو أقدم
IDE فقط SDK 10.8 لـ Code Intel. يمكن العثور عليها في Xcode 5.1.1
إذا كان لديك/تحتاج إلى تثبيت إصدارات أخرى من Xcode، فيمكنك استخدام xcode-select لتغيير Xcode النشط:
$ xcode-select -s /Path/To/Xcode 6.4.app/
أدوات سطر أوامر Xcode.
افتح تفضيلات Xcode، ثم في علامة التبويب "التنزيلات"، حدد أدوات سطر الأوامر وقم بتثبيتها.
ماكبورتس. (ملاحظة: قد يعمل Fink أيضًا ولكن معظم اختبارات البناء والتعليمات تتم باستخدام MacPorts.)
التنسيق التلقائي v2.13. بمجرد تثبيت MacPorts، ستحتاج فقط إلى تشغيل sudo port install autoconf213
تأكد من أنك تستخدم clang أو gcc 4.2 (أو أعلى)
راجع http://developer.mozilla.org/en/docs/Mac_OS_X_Build_Prequirements لمزيد من التفاصيل حول متطلبات إنشاء نظام التشغيل Mac OS X. ومع ذلك، فإن اتباع الخطوات المذكورة أعلاه من المفترض أن يكون كافيًا للحصول على مبنى كومودو.
رسميًا، نحن لا ندعم Xcode 8، ولكن من الممكن إنشاء Komodo ضمن Xcode 8 باستخدام خطوات إضافية جديدة.
--options=disable-webrtc الخروج من تحرير كومودو: git clone https://github.com/Komodo/KomodoEdit.git
باستخدام المحطة، أدخل دليل الخروج الخاص بك وقم بتشغيل:
1) cd komodo/mozilla
2) python build.py configure -k 10.10
3) python build.py all
or
python build.py distclean all
(to delete and re-download Mozilla again)
سيؤدي هذا إلى تكوين وبناء موزيلا ويمكن أن يستغرق من 30 دقيقة إلى عدة ساعات حتى يكتمل (حسب المواصفات الخاصة بك). بالنسبة لمعظم الأجهزة الحديثة، ينبغي أن يكون حوالي ساعة.
إذا كنت تستخدم الإصدار 5.0 من مجلس التعاون الخليجي، فقد يفشل البناء. إذا حدث ذلك، فهناك تغييرات يجب إجراؤها على ملفين. ومع ذلك، إذا كنت تقوم بتشغيل إصدار نظيف للمرة الأولى، فيجب عليك السماح لهذا الجزء من الإصدار بالفشل أولاً. وذلك لأن الملفات موجودة في جزء Mozilla من الإصدار الذي يجب تنزيله أولاً.
@@ -7509,8 +7509,6 @@
eval $(CXX="$CXX" HOST_CXX="$HOST_CXX" $PYTHON -m mozbuild.configure.libstdcxx)
AC_SUBST(MOZ_LIBSTDCXX_TARGET_VERSION)
AC_SUBST(MOZ_LIBSTDCXX_HOST_VERSION)
+ CXXFLAGS="$CXXFLAGS -D_GLIBCXX_USE_CXX11_ABI=0"
+ HOST_CXXFLAGS="$HOST_CXXFLAGS -D_GLIBCXX_USE_CXX11_ABI=0"
fi
راجع الخطأ رقم 1153109 في قاعدة بيانات الأخطاء في Mozilla لمزيد من المعلومات.
@@ -3874,7 +3874,7 @@
// Make sure we can't overflow.
if (NS_WARN_IF(UINT64_MAX - aLength < aStart)) {
ASSERT_UNLESS_FUZZING();
- return nullptr;
+ return false;
}
ErrorResult errorResult;
@@ -3883,7 +3883,7 @@
if (NS_WARN_IF(aStart + aLength > blobLength)) {
ASSERT_UNLESS_FUZZING();
- return nullptr;
+ return false;
}
راجع النقل إلى مجلس التعاون الخليجي 5 لمزيد من المعلومات.
بعد بناء موزيلا بنجاح، ارجع إلى دليل الريبو الرئيسي وقم ببناء كومودو:
cd ..
export PATH=`pwd`/util/black:$PATH # Komodo's "bk" build tool
git submodule update --init
git submodule update --remote
bk configure -V 10.10.0-devel
bk build
يجب أن يستغرق هذا وقتًا أقل بكثير من بناء موزيلا.
بمجرد اكتمال البناء، يمكنك ببساطة تشغيل Komodo عن طريق تنفيذ bk run
عند إجراء أي تعديلات على المصدر، سيتعين عليك تشغيل bk build مرة أخرى، أو ببساطة bk build && bk run للعودة سريعًا إلى Komodo. يجب أن تكون عمليات البناء اللاحقة أسرع كثيرًا حيث يتم تخزين قدر كبير من البيانات المجمعة مؤقتًا.
تعليمات لينكس
أسهل طريقة للبدء هي استخدام صورة Docker الخاصة بنا، وهذا سيوفر لك بشكل أساسي إصدار Komodo المستند إلى Ubuntu 12.04.
بعد استنساخ المستودع، انتقل ببساطة إلى {repo}/util/docker وراجع ./docklet --help
لاستخدام صورة عامل الإرساء، تحتاج بالطبع إلى تثبيت Docker بالإضافة إلى تمكين إعادة توجيه X11 في عميل SSH الخاص بك (يجب أن يعمل بشكل افتراضي على معظم توزيعات Linux).
./util/docker/docklet image./util/docker/docklet start./util/docker/docklet ssh سيتم تثبيت ملفات مشروعك على /komodo/dev
ملاحظة - إذا كنت تقوم بالتحديث من إصدار سابق حيث كانت ملفات مشروعك موجودة على /root/komodo فستحتاج إلى إصلاح الأذونات على مشروع Komodo ومجلدات ملف التعريف. أي:
chown -R <my-username>:<my-group> <my-project-location>
chown -R <my-username>:<my-group> ~/.komodoide
ستحتاج أيضًا إلى إعادة البناء الخاص بك (قم بتنظيف mozilla وkomodo).
بمجرد إعداد صورتك، يمكنك اتباع خطوات إنشاء نظام التشغيل Linux كما هو موضح أعلاه. ستقوم بتشغيل هذه العناصر من حاوية عامل الإرساء، لذا أدخل إليها باستخدام الأمر أعلاه ثم قم بتشغيل الأوامر من /komodo/dev
بمجرد اكتمال البناء الخاص بك، يمكنك الخروج من الحاوية ( exit ) ويمكنك بعد ذلك تشغيل Komodo باستخدام
./util/docker/docklet run
لإعادة بناء كومودو (بعد إجراء التغييرات) وتشغيله مرة أخرى يمكنك استخدامه
./util/docker/docklet build run
إذا لم تنعكس تغييراتك، فقد تحتاج إلى تنظيف الإصدار الخاص بك للقيام بهذا الاستخدام
./util/docker/docklet clean
أو القيام بكل ذلك مرة واحدة (التنظيف والبناء والتشغيل)
./util/docker/docklet clean build run
إذا حدثت أية أخطاء أثناء وقت الإنشاء الأول ولم يكن من الواضح كيفية حل المشكلة بنفسك، فيرجى الرجوع إلى قسم التعليقات حول كيفية الاتصال بنا.
لاحظ أنه في حالة ظهور تعقيدات في البناء بعد تحديث الريبو الخاص بك بأحدث التغييرات، فقد تحتاج إلى مسح ذاكرة التخزين المؤقت المحلية الخاصة بك لأنها قد تتعارض مع التغييرات الجديدة، للقيام بذلك، قم بتشغيل bk distclean قبل تشغيل خطوات البناء الخاصة بك.
بناء قطعة واحدة
في بعض الأحيان يكون bk build أكثر من اللازم ولا يكون bk build quick كافيًا. إذا بدا bk build quick لا يلتقط تغييراتك، فحاول توجيه bk build إلى القطعة المعنية.
مثال
bk build build/release/modules/places #this will build the places module only
ملاحظة : لا تعتمد على هذه الطريقة لأن bk build quick أسرع وفي بعض الحالات يقوم ببعض الخطوات التي لن يؤديها المثال أعلاه. استخدمه كمحاولة أخيرة قبل تجربة bk distclean && bk build .
