الصفحة الرئيسية>المتعلقة بالبرمجة>جافا كود المصدر
تنزيل

أنشطة

الصفحة الرئيسية: http://activiti.org

Activiti عبارة عن منصة خفيفة الوزن لسير العمل وإدارة عمليات الأعمال (BPM) تستهدف رجال الأعمال والمطورين ومسؤولي النظام. جوهرها هو محرك معالجة BPMN 2 فائق السرعة ومتين لجافا. إنه مفتوح المصدر ويتم توزيعه بموجب ترخيص Apache. يتم تشغيل Activiti في أي تطبيق Java، على خادم، على مجموعة أو في السحابة. إنه يتكامل تمامًا مع Spring، فهو خفيف الوزن للغاية ويعتمد على مفاهيم بسيطة.

* *ملاحظة: لقد نقلنا إلى الفرع الرئيسي جميع محتويات فرع التطوير الذي كنا نستخدمه لتصميم وترميز الإصدار الرئيسي التالي من المشروع. إذا كنت تريد المساهمة في الإصدار 6.x، فيرجى إلقاء نظرة على فرع 6.x.**

إذا كنت تريد قراءة المزيد عن بنية المستودعات الخاصة بنا، يمكنك قراءة GitBook الخاص بنا.

تكوين IntelliJ

  • فرض مستوى اللغة 21، للفشل بسرعة عند استخدام الميزات المتوفرة فقط في إصدارات Java الأحدث (عن طريق الخطأ).

    • افتح القائمة ملف ، عنصر القائمة هيكل المشروع
    • انقر فوق عنصر القائمة الوحدات ، لكل وحدة، علامة تبويب المصادر ، يجب ضبط مستوى لغة combobox تلقائيًا على 21 ...

  • تجنب تجاهل التغييرات في بعض الموارد في التشغيل/التصحيح التالي (وستضطر إلى استخدام mvn)

    • افتح القائمة " ملف" أو عنصر القائمة " الإعدادات " أو القائمة IntelliJ IDEA أو عنصر القائمة " التفضيلات"... إذا كنت تستخدم جهاز Mac
    • انقر فوق مترجم عنصر الشجرة، وأنماط موارد حقل النص: قم بالتغيير إلى !?*.java (إزالة المحتوى الآخر)

  • تجنب StackOverflowError عند البناء

    • افتح القائمة " ملف" أو عنصر القائمة " الإعدادات " أو القائمة IntelliJ IDEA أو عنصر القائمة " التفضيلات"... إذا كنت تستخدم جهاز Mac
    • انقر فوق مترجم عنصر الشجرة، مترجم Java عنصر الشجرة، معلمات سطر الأوامر الإضافية لحقل النص
    • إضافة -J-Xss1024k

  • نمط الكود الموصى به: استخدم Google Java Style Guide مع Editorconfig

    • قم بتنزيل نمط كود IntelliJ بتنسيق xml من: [https://google.github.io/styleguide/intellij-java-google-style.xml]
    • افتح القائمة " ملف" أو عنصر القائمة " الإعدادات " أو القائمة IntelliJ IDEA أو عنصر القائمة " التفضيلات"... إذا كنت تستخدم جهاز Mac
    • انقر فوق رمز نمط عنصر الشجرة، وانقر فوق العجلة المسننة وحدد مخطط الاستيراد ، ثم نمط رمز IntelliJ xml
    • تصفح المكان الذي قمت بتنزيل ملف XML فيه وافتحه. تأكد من أن GoogleStyle هو المخطط النشط.
      • ملاحظة: لا يقوم IntelliJ IDEA بتنسيق التعليمات البرمجية الخاصة بك تلقائيًا. يجب عليك الضغط على تركيبة لوحة المفاتيح Ctrl+Alt+L لتشغيل التنسيق التلقائي عند الانتهاء من الترميز.
    • يوجد ملف .editorconfig يحتوي على تعريف للمسافات البادئة، وترميز الملفات، ونهايات الأسطر.
    • إذا قمت بتعطيله، فستحتاج إلى ضبط ترميز الملف وعدد المسافات بشكل صحيح يدويًا.
    • نمط رمز الكسوف XML: [https://google.github.io/styleguide/Eclipse-Java-google-style.xml]
    • يحتاج Eclipse إلى البرنامج المساعد Editorconfig-Eclipse لدعم ملفات EditorConfig.

  • قم بتعيين ترميز الملف الصحيح يدويًا (UTF-8 باستثناء ملفات الخصائص) وأحرف نهاية السطر (unix):

    • افتح القائمة " ملف" أو عنصر القائمة " الإعدادات " أو القائمة IntelliJ IDEA أو عنصر القائمة " التفضيلات"... إذا كنت تستخدم جهاز Mac
    • انقر فوق رمز نمط عنصر الشجرة، وعنصر الشجرة عام
      • فاصل الخط Combobox (للملفات الجديدة) : Unix
    • انقر فوق ترميزات ملف العنصر الشجري
      • ترميز Combobox العالمي : UTF-8
      • Combobox الترميز الافتراضي لملفات الخصائص : ISO-8859-1
        • ملاحظة: يجب أن تكون ملفات خصائص i18n العادية في ISO-8859-1 كما هو محدد في عقد Java ResourceBundle .

  • قم بتعيين العدد الصحيح للمسافات يدويًا عند الضغط على علامة التبويب:

    • افتح القائمة " ملف" أو عنصر القائمة " الإعدادات " أو القائمة IntelliJ IDEA أو عنصر القائمة " التفضيلات"... إذا كنت تستخدم جهاز Mac
    • انقر فوق رمز نمط عنصر الشجرة، وعنصر الشجرة عام
    • انقر فوق علامة التبويب جافا
      • خانة الاختيار استخدام حرف علامة التبويب : off
      • حجم علامة التبويب Textfield: 4
      • المسافة البادئة لحقل النص: 4
      • المسافة البادئة لاستمرار حقل النص: 8
    • افتح علامة التبويب XML
      • خانة الاختيار استخدام حرف علامة التبويب : off
      • حجم علامة التبويب حقل النص: 2
      • المسافة البادئة لحقل النص: 2
      • المسافة البادئة لاستمرار حقل النص: 4

  • قم بتعيين رؤوس الملفات الصحيحة (لا تقم بتضمين @author أو javadoc الذي لا معنى له):

    • افتح القائمة " ملف" أو عنصر القائمة " الإعدادات " أو القائمة IntelliJ IDEA أو عنصر القائمة " التفضيلات"... إذا كنت تستخدم جهاز Mac
    • انقر فوق قوالب ملف عنصر الشجرة، وعلامة التبويب تتضمن ، File Header عنصر القائمة
    • قم بإزالة السطر @author اسمك .
      • نحن لا نقبل أسطر @author في الملفات المصدر، راجع الأسئلة الشائعة أدناه.
    • قم بإزالة javadoc بالكامل لأن البيانات التي تم تشكيلها تلقائيًا لا معنى لها.

  • قم بتعيين رأس الترخيص الصحيح

    • افتح القائمة " ملف" أو عنصر القائمة " الإعدادات " أو القائمة IntelliJ IDEA أو عنصر القائمة " التفضيلات"... إذا كنت تستخدم جهاز Mac
    • انقر فوق حقوق الطبع والنشر لعنصر الشجرة، وملفات تعريف حقوق الطبع والنشر لعنصر الشجرة
      • انقر فوق زر الاستيراد لاستيراد ملف تعريف حقوق الطبع والنشر
      • حدد الملف: Alfresco_Software.xml
    • انقر فوق حقوق الطبع والنشر لعنصر الشجرة
      • Combobox حقوق الطبع والنشر الافتراضية للمشروع : Alfresco Software

التعليمات

  • لماذا لا تقبل أسطر @author في كود المصدر الخاص بك؟

    • لأن علامات المؤلف في ملفات جافا تمثل كابوسًا للصيانة

      • نسبة كبيرة خاطئة أو غير كاملة أو غير دقيقة.
      • وفي أغلب الأحيان، يحتوي فقط على المؤلف الأصلي. يتم إعادة هيكلة/توسيع العديد من الملفات بالكامل بواسطة مؤلفين آخرين.
      • Git دقيق، وهذا هو المصدر الأساسي للعثور على المؤلف الصحيح.

    • لأن علامات المؤلف تعزز ملكية الكود ، وهو أمر سيئ على المدى الطويل.

      • إذا كان الناس يعملون على قطعة يرون أنها مملوكة لشخص آخر، فإنهم يميلون إلى:
        • فقط أصلحوا ما تم تكليفهم بإصلاحه، بدلًا من كل ما تم كسره
        • تجاهل المسؤولية إذا كان هذا الرمز لا يعمل بشكل صحيح
        • تخاف من الدوس على قدمي المالك.

    • يتم منح الائتمان للمؤلفين:

      • مع Open Hub الذي يحتوي أيضًا على إحصائيات
      • في واجهة الويب GitHub.

أوامر التطوير

أضف رأس الترخيص

لتنسيق الملفات بالترخيص المطلوب: 

mvn license:format

Checkstyle

للتحقق مما إذا كان نمط التعليمات البرمجية الخاص بك يحترم جميع القواعد: 

mvn checkstyle:check -DskipCheckstyle=false

موقع

لإنشاء موقع مخضرم: 

mvn clean site site:stage

سيتم إنشاء الموقع على: target/staging/index.html

سي آي/سي دي

يعمل على إجراءات GH.

لكي يتم التحقق من صحة بيانات Dependabot PR بواسطة CI، يجب إضافة التسمية "CI" إلى PR.

يتطلب تعيين الأسرار التالية:

اسم وصف
BOT_GITHUB_TOKEN رمز مميز لإطلاق تصميمات أخرى على GH
BOT_GITHUB_USERNAME اسم المستخدم لإصدار طلبات المشاركة العامة
NEXUS_USERNAME اسم مستخدم مستودع Maven الداخلي
NEXUS_PASSWORD كلمة مرور مستودع Maven الداخلي
SLACK_NOTIFICATION_BOT_TOKEN رمز مميز لإخطار الركود عند الفشل
يوسع
معلومات إضافية
تطبيقات ذات صلة
نوصي لك
أخبار ذات صلة الكل