يوفر Sonarqube القدرة ليس فقط على إظهار صحة التطبيق ولكن أيضًا لتسليط الضوء على القضايا التي تم تقديمها حديثًا. مع وجود بوابة عالية الجودة في مكانها ، يمكنك تحقيق رمز نظيف وبالتالي تحسين جودة الكود بشكل منهجي.
للحصول على أسئلة الدعم ("كيف أفعل؟" ، "حصلت على هذا الخطأ ، لماذا؟" ، ...) ، يرجى أولاً قراءة الوثائق ثم التوجه إلى مجتمع Sonarsource. من المحتمل أن يتم الرد على إجابة سؤالك! ؟
كن على علم بأن هذا المنتدى هو مجتمع ، لذلك من المتوقع أن تكون المجاملات القياسية ("مرحبًا" ، "شكرًا" ، ...). وإذا لم تحصل على إجابة على موضوعك ، فيجب عليك الجلوس على يديك لمدة ثلاثة أيام على الأقل قبل أن تصطدم به. لا يقف المشغلون. ؟
إذا كنت ترغب في رؤية ميزة جديدة أو الإبلاغ عن خطأ ، فيرجى إنشاء موضوع جديد في منتدىنا.
يرجى العلم بأننا لا نبحث بنشاط عن مساهمات الميزات. الحقيقة هي أنه من الصعب للغاية على شخص خارج Sonarsource الامتثال لخريطة الطريق وتوقعاتنا. لذلك ، نحن عادة ما نقبل التغييرات التجميلية البسيطة وإصلاحات المطبعية المطبعية.
مع وضع ذلك في الاعتبار ، إذا كنت ترغب في إرسال مساهمة رمز ، فيرجى إنشاء طلب سحب لهذا المستودع. يرجى توضيح دوافعك للمساهمة في هذا التغيير: ما هي المشكلة التي تحاول إصلاحها ، وما هو التحسن الذي تحاول إجراءه.
تأكد من اتباع نمط الكود الخاص بنا وأن جميع الاختبارات تمر (يتم تنفيذ Travis Build لكل طلب سحب).
على استعداد للمساهمة في منتجات Sonarsource؟ نحن نبحث عن أشخاص ذكي وعاطفي ومهارة لمساعدتنا في بناء حلول ذات جودة رمز من الطراز العالمي. إلقاء نظرة على عروض العمل الحالية هنا!
لبناء مصادر متابعة هذه التعليمات محليا.
تنفيذ من دليل قاعدة المشروع:
./gradlew build
يتم إنشاء ملف التوزيع الرمز البريدي في sonar-application/build/distributions/ . قم بفك ضغطه وابدأ الخادم عن طريق التنفيذ:
# on Linux
bin/linux-x86-64/sonar.sh start
# or on MacOS
bin/macosx-universal-64/sonar.sh start
# or on Windows
binwindows-x86-64StartSonar.bat
إذا لم يتم بناء المشروع أبدًا ، فبناءه كالمعتاد (انظر القسم السابق) أو استخدم الأمر الأسرع:
./gradlew ide
ثم افتح ملف الجذر build.gradle كمشروع في Intellij أو Eclipse.
| ./gradlew الأمر | وصف |
|---|---|
dependencies | قائمة التبعيات |
licenseFormat --rerun-tasks | إصلاح رؤوس المصدر عن طريق تطبيق header.txt |
wrapper --gradle-version 5.2.1 | ترقية الغلاف |
يقع Sonarqube UI (أو WebApp كما نسميه) ، في مستودع آخر: Sonarqube-Webapp.
عند إنشاء مستودع sonarqube ، يتم تنزيل WebApp تلقائيًا من Maven Central باعتباره التبعية ، فإنه يجعل من السهل عليك المساهمة في تغييرات الواجهة الخلفية دون الاضطرار إلى الاهتمام بـ WebApp.
ولكن إذا كانت مساهمتك تحتوي أيضًا على تغييرات واجهة المستخدم ، فيجب عليك استنساخ مستودع sonarqube-webapp ، قم بإجراء التغييرات هناك ، وقم بإنشائها محليًا ثم قم ببناء مستودع sonarqube باستخدام متغير بيئة WEBAPP_BUILD_PATH لاستهداف بناء مخصص لاستخدام واجهة المستخدم.
فيما يلي مثال على كيفية القيام بذلك:
cd /path/to/sonarqube-webapp/server/sonar-web
# do your changes
# install dependencies, only needed the first time
yarn
# build the webapp
yarn build
cd /path/to/sonarqube
# build the sonarqube repository using the custom build of the webapp
WEBAPP_BUILD_PATH=/path/to/sonarqube-webapp/server/sonar-web/build/webapp ./gradlew build يمكنك أيضًا استهداف إصدار محدد من WebApp عن طريق تحديث خاصية webappVersion في ملف ./gradle.properties ثم إنشاء مستودع sonarqube بشكل طبيعي.
تاريخيا تم تخزين ترجماتنا في sonar-core/src/main/resources/org/sonar/l10n/core.properties ، ولكن هذا الملف الآن تم إهماله ولم يتم تحديثه بعد الآن. يتم الآن تعريف الترجمات الافتراضية (باللغة الإنجليزية) في مستودع WebApp ، هنا: https://github.com/sonarsource/sonarqube-webapp/blob/master/server/sonar-web/src/main/js/l10n/default.ts
لقد تغير التنسيق ولكن لا يزال بإمكانك الحصول عليه كتنسيق ملف .properties عن طريق تشغيل الأمر التالي:
cd /path/to/sonarqube-webapp/server/sonar-web
# install dependencies, only needed the first time
yarn
# generate a backward compatible .properties file with all the translation keys
yarn generate-translation-keysلاحظ أن المساهمة في الامتدادات للترجمات إلى لغات أخرى لا تزال تعمل بنفس الطريقة كما كان من قبل. إنه مجرد مصدر للحقيقة للترجمات الافتراضية التي تغيرت.
حقوق الطبع والنشر 2008-2024 Sonarsource.
مرخصة بموجب ترخيص GNU Lesser General Public ، الإصدار 3.0