مشاركة عبر

Gradle@1 - مهمة Gradle v1

  • مقالة

إنشاء باستخدام برنامج تضمين Gradle النصي.

بناء الجملة

# Gradle v1
# Build using a Gradle wrapper script.
- task: Gradle@1
  inputs:
    gradleWrapperFile: 'gradlew' # string. Alias: wrapperScript. Required. Gradle Wrapper. Default: gradlew.
    #options: # string. Options. 
    tasks: 'build' # string. Required. Tasks. Default: build.
  # Advanced
    #workingDirectory: # string. Alias: cwd. Working Directory. 
    javaHomeOption: 'JDKVersion' # 'JDKVersion' | 'Path'. Alias: javaHomeSelection. Required. Set JAVA_HOME by. Default: JDKVersion.
    #jdkVersionOption: 'default' # 'default' | '1.9' | '1.8' | '1.7' | '1.6'. Alias: jdkVersion. Optional. Use when javaHomeSelection = JDKVersion. JDK Version. Default: default.
    #jdkDirectory: # string. Alias: jdkUserInputPath. Required when javaHomeSelection = Path. JDK Path. 
    #jdkArchitectureOption: 'x64' # 'x86' | 'x64'. Alias: jdkArchitecture. Optional. Use when jdkVersion != default. JDK Architecture. Default: x64.
    #gradleOptions: '-Xmx1024m' # string. Alias: gradleOpts. Set GRADLE_OPTS. Default: -Xmx1024m.
  # JUnit Test Results
    #publishJUnitResults: true # boolean. Publish to TFS/Team Services. Default: true.
    testResultsFiles: '**/build/test-results/TEST-*.xml' # string. Required when publishJUnitResults = true. Test Results Files. Default: **/build/test-results/TEST-*.xml.
    #testRunTitle: # string. Optional. Use when publishJUnitResults = true. Test Run Title. 
  # Code Coverage
    #codeCoverageToolOption: 'None' # 'None' | 'Cobertura' | 'JaCoCo'. Alias: codeCoverageTool. Code Coverage Tool. Default: None.
    #codeCoverageClassFilesDirectories: 'build/classes/main/' # string. Alias: classFilesDirectories. Required when codeCoverageTool = false. Class Files Directories. Default: build/classes/main/.
    #codeCoverageClassFilter: # string. Alias: classFilter. Optional. Use when codeCoverageTool != None. Class Inclusion/Exclusion Filters. 
    #codeCoverageFailIfEmpty: false # boolean. Alias: failIfCoverageEmpty. Optional. Use when codeCoverageTool != None. Fail When Code Coverage Results Are Missing. Default: false.
  # Code Analysis
    #sonarQubeRunAnalysis: false # boolean. Alias: sqAnalysisEnabled. Run SonarQube Analysis. Default: false.
    #sonarQubeServiceEndpoint: # string. Alias: sqConnectedServiceName. Required when sqAnalysisEnabled = true. SonarQube Endpoint. 
    #sonarQubeProjectName: # string. Alias: sqProjectName. Required when sqAnalysisEnabled = true. SonarQube Project Name. 
    #sonarQubeProjectKey: # string. Alias: sqProjectKey. Required when sqAnalysisEnabled = true. SonarQube Project Key. 
    #sonarQubeProjectVersion: # string. Alias: sqProjectVersion. Required when sqAnalysisEnabled = true. SonarQube Project Version. 
    #sonarQubeGradlePluginVersion: '2.0.1' # string. Alias: sqGradlePluginVersion. Required when sqAnalysisEnabled = true. SonarQube Gradle Plugin Version. Default: 2.0.1.
    #sonarQubeSpecifyDB: false # boolean. Alias: sqDbDetailsRequired. Optional. Use when sqAnalysisEnabled = true. The SonarQube server version is lower than 5.2. Default: false.
    #sonarQubeDBUrl: # string. Alias: sqDbUrl. Optional. Use when sqDbDetailsRequired = true. Db Connection String. 
    #sonarQubeDBUsername: # string. Alias: sqDbUsername. Optional. Use when sqDbDetailsRequired = true. Db Username. 
    #sonarQubeDBPassword: # string. Alias: sqDbPassword. Optional. Use when sqDbDetailsRequired = true. Db User Password. 
    #sonarQubeIncludeFullReport: true # boolean. Alias: sqAnalysisIncludeFullReport. Optional. Use when sqAnalysisEnabled = true. Include full analysis report in the build summary (SQ 5.3+). Default: true.
    #sonarQubeFailWhenQualityGateFails: # boolean. Alias: sqAnalysisBreakBuildIfQualityGateFailed. Optional. Use when sqAnalysisEnabled = true. Fail the build on quality gate failure (SQ 5.3+). 
    #checkStyleRunAnalysis: false # boolean. Alias: checkstyleAnalysisEnabled. Run Checkstyle. Default: false.
    #findBugsRunAnalysis: false # boolean. Alias: findbugsAnalysisEnabled. Run FindBugs. Default: false.
    #pmdRunAnalysis: false # boolean. Alias: pmdAnalysisEnabled. Run PMD. Default: false.

الإدخالات

gradleWrapperFile - برنامج تضمين Gradle
الاسم المستعار للإدخل: wrapperScript. string. مطلوب القيمة الافتراضية: gradlew.

gradlew يحدد موقع برنامج التضمين داخل المستودع الذي سيتم استخدامه للبناء. يجب على الوكلاء على Windows (بما في ذلك العوامل المستضافة من Microsoft) استخدام gradlew.bat برنامج التضمين. يمكن للوكلاء على Linux أو macOS استخدام gradlew البرنامج النصي shell. تعرف على المزيد حول Gradle Wrapper.


options - خيارات
string.

يحدد خيارات سطر الأوامر التي سيتم تمريرها إلى برنامج تضمين Gradle. راجع سطر أوامر Gradle لمزيد من المعلومات.


tasks - المهام
string. مطلوب القيمة الافتراضية: build.

المهمة (المهام) ل Gradle لتنفيذها. يجب فصل قائمة بأسماء المهام بمسافات ويمكن أخذها من gradlew tasks موجه الأوامر.

راجع أساسيات البرنامج النصي لإنشاء Gradle لمزيد من المعلومات.


workingDirectory - دليل العمل
الاسم المستعار للإدخل: cwd. string.

يحدد دليل العمل لتشغيل بنية Gradle. تستخدم المهمة الدليل الجذر للمستودع إذا لم يتم تحديد دليل العمل.


publishJUnitResults - النشر إلى TFS/Team Services
boolean. القيمة الافتراضية: true.

ينشر نتائج اختبار JUnit التي تنتجها بنية Gradle إلى Azure Pipelines. تنشر المهمة كل ملف نتائج اختبار مطابقة Test Results Files كتشغيل اختبار في Azure Pipelines.


testResultsFiles - اختبار ملفات النتائج
string. مطلوب عند publishJUnitResults = true. القيمة الافتراضية: **/build/test-results/TEST-*.xml.

مسار الملف لنتائج الاختبار. يمكن استخدام أحرف البدل. على سبيل المثال، **/TEST-*.xml لجميع ملفات XML التي يبدأ اسمها ب TEST-.


testRunTitle - اختبار عنوان التشغيل
string. ‏‏اختياري. استخدم عندما publishJUnitResults = true.

يوفر اسما لنتائج حالة اختبار JUnit لهذا الإصدار.


codeCoverageToolOption - أداة تغطية التعليمات البرمجية
الاسم المستعار للإدخل: codeCoverageTool. string. القيم المسموح بها: None، ، Cobertura. JaCoCo القيمة الافتراضية: None.

يحدد أداة تغطية التعليمات البرمجية لتحديد التعليمات البرمجية التي تغطيها حالات الاختبار للإنشاء.


codeCoverageClassFilesDirectories - دلائل ملفات الفئة
الاسم المستعار للإدخل: classFilesDirectories. string. مطلوب عند codeCoverageTool = false. القيمة الافتراضية: build/classes/main/.

قائمة الدلائل المفصولة بفواصل التي تحتوي على ملفات الفئة وملفات الأرشيف (.jar و.war والمزيد). يتم الإبلاغ عن تغطية التعليمات البرمجية لملفات الفئة في هذه الدلائل. عادة، تبحث المهمة في الفئات ضمن build/classes/java/main (ل Gradle 4+)، وهو دليل الفئة الافتراضي لبنى Gradle.


codeCoverageClassFilter - عوامل تصفية تضمين/استبعاد الفئة
الاسم المستعار للإدخل: classFilter. string. ‏‏اختياري. استخدم عندما codeCoverageTool != None.

قائمة عوامل التصفية المفصولة بفواصل لتضمين الفئات أو استبعادها من جمع تغطية التعليمات البرمجية. على سبيل المثال: +:com.*،+:org.*،-:my.app*.*.


codeCoverageFailIfEmpty - فشل عندما تكون نتائج تغطية التعليمات البرمجية مفقودة
الاسم المستعار للإدخل: failIfCoverageEmpty. boolean. ‏‏اختياري. استخدم عندما codeCoverageTool != None. القيمة الافتراضية: false.

يفشل البناء إذا لم تنتج تغطية التعليمات البرمجية أي نتائج لنشرها.


javaHomeOption - تعيين JAVA_HOME بواسطة
الاسم المستعار للإدخل: javaHomeSelection. string. مطلوب القيم المسموح بها: JDKVersion (إصدار JDK)، Path. القيمة الافتراضية: JDKVersion.

يعين JAVA_HOME عن طريق تحديد إصدار JDK الذي تكتشفه المهمة أثناء الإصدارات أو عن طريق إدخال مسار JDK يدويا.


jdkVersionOption - إصدار JDK
الاسم المستعار للإدخل: jdkVersion. string. ‏‏اختياري. استخدم عندما javaHomeSelection = JDKVersion. القيم المسموح بها: default، 1.9 (JDK 9)، 1.8 (JDK 8)، 1.7 (JDK 7)، 1.6 (JDK 6). القيمة الافتراضية: default.

يحاول اكتشاف المسار إلى إصدار JDK المحدد وتعيين JAVA_HOME وفقا لذلك.


jdkDirectory - مسار JDK
الاسم المستعار للإدخل: jdkUserInputPath. string. مطلوب عند javaHomeSelection = Path.

تعيين JAVA_HOME إلى المسار المحدد.


jdkArchitectureOption - بنية JDK
الاسم المستعار للإدخل: jdkArchitecture. string. ‏‏اختياري. استخدم عندما jdkVersion != default. القيم المسموح بها: x86، . x64 القيمة الافتراضية: x64.

يوفر بنية JDK (x86 أو x64).


gradleOptions - تعيين GRADLE_OPTS
الاسم المستعار للإدخل: gradleOpts. string. القيمة الافتراضية: -Xmx1024m.

يعين متغير البيئة GRADLE_OPTS، والذي يستخدم لإرسال وسيطات سطر الأوامر لبدء تشغيل JVM. xmx تحدد العلامة الحد الأقصى للذاكرة المتوفرة ل JVM.


sonarQubeRunAnalysis - تشغيل تحليل SonarQube
الاسم المستعار للإدخل: sqAnalysisEnabled. boolean. القيمة الافتراضية: false.

تشغيل تحليل SonarQube بعد تنفيذ الأهداف الحالية. install يجب تنفيذ الأهداف أو package أولا.


sonarQubeServiceEndpoint - نقطة نهاية SonarQube
الاسم المستعار للإدخل: sqConnectedServiceName. string. مطلوب عند sqAnalysisEnabled = true.

نقطة النهاية التي تحدد خادم SonarQube المراد استخدامه.


sonarQubeProjectName - اسم مشروع SonarQube
الاسم المستعار للإدخل: sqProjectName. string. مطلوب عند sqAnalysisEnabled = true.

اسم مشروع SonarQube، أي sonar.projectName.


sonarQubeProjectKey - مفتاح مشروع SonarQube
الاسم المستعار للإدخل: sqProjectKey. string. مطلوب عند sqAnalysisEnabled = true.

المفتاح الفريد لمشروع SonarQube، وهو sonar.projectKey.


sonarQubeProjectVersion - إصدار مشروع SonarQube
الاسم المستعار للإدخل: sqProjectVersion. string. مطلوب عند sqAnalysisEnabled = true.

إصدار مشروع SonarQube، أي sonar.projectVersion.


sonarQubeGradlePluginVersion - إصدار البرنامج المساعد SonarQube Gradle
الاسم المستعار للإدخل: sqGradlePluginVersion. string. مطلوب عند sqAnalysisEnabled = true. القيمة الافتراضية: 2.0.1.

يحتوي على رقم إصدار المكون الإضافي SpotBugs Gradle.


sonarQubeSpecifyDB - إصدار خادم SonarQube أقل من 5.2
الاسم المستعار للإدخل: sqDbDetailsRequired. boolean. ‏‏اختياري. استخدم عندما sqAnalysisEnabled = true. القيمة الافتراضية: false.

خادم SonarQube 5.1 والأدنى فقط. يحدد تفاصيل اتصال قاعدة البيانات.


sonarQubeDBUrl - سلسلة اتصال Db
الاسم المستعار للإدخل: sqDbUrl. string. ‏‏اختياري. استخدم عندما sqDbDetailsRequired = true.

إصدار خادم SonarQube 5.1 والإصدارات الأقل فقط. يدخل إعداد اتصال قاعدة البيانات، أي sonar.jdbc.url. على سبيل المثال: jdbc:jtds:sqlserver://localhost/sonar;SelectMethod=Cursor.


sonarQubeDBUsername - اسم مستخدم Db
الاسم المستعار للإدخل: sqDbUsername. string. ‏‏اختياري. استخدم عندما sqDbDetailsRequired = true.

خادم SonarQube 5.1 والأدنى فقط. إدخال اسم المستخدم لمستخدم قاعدة البيانات، أي sonar.jdbc.username.


sonarQubeDBPassword - كلمة مرور مستخدم Db
الاسم المستعار للإدخل: sqDbPassword. string. ‏‏اختياري. استخدم عندما sqDbDetailsRequired = true.

خادم SonarQube 5.1 والأدنى فقط. أدخل كلمة المرور لمستخدم قاعدة البيانات، أي sonar.jdbc.password.


sonarQubeIncludeFullReport - تضمين تقرير التحليل الكامل في ملخص البناء (SQ 5.3+)
الاسم المستعار للإدخل: sqAnalysisIncludeFullReport. boolean. ‏‏اختياري. استخدم عندما sqAnalysisEnabled = true. القيمة الافتراضية: true.

يؤخر البناء حتى يكتمل تحليل SonarQube.


sonarQubeFailWhenQualityGateFails - فشل البناء على فشل بوابة الجودة (SQ 5.3+)
الاسم المستعار للإدخل: sqAnalysisBreakBuildIfQualityGateFailed. boolean. ‏‏اختياري. استخدم عندما sqAnalysisEnabled = true.

إصدار خادم SonarQube 5.3 أو أعلى فقط. يقدم تأخيرات حيث يجب أن ينتظر البناء حتى يكمل SonarQube التحليل. تعرف على المزيد حول استخدام SonarQube للإنشاءات.


checkStyleRunAnalysis - تشغيل النوع الاختباري
الاسم المستعار للإدخل: checkstyleAnalysisEnabled. boolean. القيمة الافتراضية: false.

تشغيل أداة Checkstyle مع عمليات فحص Sun الافتراضية. يتم تحميل النتائج على أنها بيانات اصطناعية للبناء.


findBugsRunAnalysis - تشغيل FindBugs
الاسم المستعار للإدخل: findbugsAnalysisEnabled. boolean. القيمة الافتراضية: false.

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


pmdRunAnalysis - تشغيل PMD
الاسم المستعار للإدخل: pmdAnalysisEnabled. boolean. القيمة الافتراضية: false.

يستخدم أداة تحليل JAVA الثابتة PMD للبحث عن الأخطاء في التعليمات البرمجية. يتم تحميل النتائج كقطع اصطناعية للبناء.


خيارات التحكم بالمهمة

تحتوي جميع المهام على خيارات التحكم بالإضافة إلى مدخلات المهام الخاصة بها. لمزيد من المعلومات، راجع خيارات التحكم وخصائص المهمة الشائعة.

متغيرات الإخراج

لا شيء

الملاحظات

ملاحظة

يتوفر إصدار أحدث من هذه المهمة في Gradle@3.

ملاحظة

يتوفر إصدار أحدث من هذه المهمة في Gradle@2.

تم نقل تكوين تحليل SonarQube إلى ملحقات SonarQube أو SonarCloud في المهمة Prepare Analysis Configuration.

استخدم هذه المهمة للبناء باستخدام برنامج تضمين Gradle النصي.

كيف أعمل إنشاء برنامج تضمين من مشروع Gradle؟

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

  1. قم بإنشاء برنامج تضمين Gradle عن طريق إصدار الأمر التالي من دليل المشروع الجذر حيث يوجد build.gradle الخاص بك:

    jamal@fabrikam> gradle wrapper

  2. قم بتحميل برنامج تضمين Gradle إلى المستودع البعيد.

    هناك أداة ثنائية يتم إنشاؤها بواسطة برنامج تضمين gradle (الموجود في gradle/wrapper/gradle-wrapper.jar). هذا الملف الثنائي صغير ولا يتطلب التحديث. إذا كنت بحاجة إلى تغيير تكوين Gradle الذي يتم تشغيله على عامل البناء، يمكنك تحديث gradle-wrapper.properties.

    يجب أن يبدو المستودع كما يلي:

|-- gradle/
    `-- wrapper/
        `-- gradle-wrapper.jar
        `-- gradle-wrapper.properties
|-- src/
|-- .gitignore
|-- build.gradle
|-- gradlew
|-- gradlew.bat

كيف أعمل إصلاح المهلات عند تنزيل التبعيات؟

لإصلاح الأخطاء مثل Read timed out عند تنزيل التبعيات، يمكن لمستخدمي Gradle 4.3+ تغيير المهلة عن طريق إضافة -Dhttp.socketTimeout=60000 -Dhttp.connectionTimeout=60000 إلى Options. يؤدي ذلك إلى زيادة المهلة من 10 ثوان إلى دقيقة واحدة.

المتطلبات

المتطلبات الوصف
أنواع البنية الأساسية لبرنامج ربط العمليات التجارية YAML، الإصدار الكلاسيكي
يعمل على Agent, DeploymentGroup
المطالب يجب أن يكون لدى الوكلاء المستضافين ذاتيا قدرات تتطابق مع المتطلبات التالية لتشغيل المهام التي تستخدم هذه المهمة: java
القدرات لا تفي هذه المهمة بأي طلبات للمهام اللاحقة في الوظيفة.
قيود الأوامر أي
متغيرات Settable أي
إصدار الوكيل 1.91.0 أو أحدث
فئة المهمة البنية