Gradle@2 - مهمة Gradle v2

مقالة
06/11/2024

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

بناء الجملة

# Gradle v2
# Build using a Gradle wrapper script.
- task: Gradle@2
  inputs:
    gradleWrapperFile: 'gradlew' # string. Alias: wrapperScript. Required. Gradle wrapper. Default: gradlew.
    #workingDirectory: # string. Alias: cwd. Working directory. 
    #options: # string. Options. 
    tasks: 'build' # string. Required. Tasks. Default: build.
  # JUnit Test Results
    #publishJUnitResults: true # boolean. Publish to Azure Pipelines. Default: true.
    testResultsFiles: '**/TEST-*.xml' # string. Required when publishJUnitResults = true. Test results files. Default: **/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 != None. 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.
    #codeCoverageGradle5xOrHigher: true # boolean. Alias: gradle5xOrHigher. Optional. Use when codeCoverageTool = JaCoCo. Gradle version >= 5.x. Default: true.
  # Advanced
    javaHomeOption: 'JDKVersion' # 'JDKVersion' | 'Path'. Alias: javaHomeSelection. Required. Set JAVA_HOME by. Default: JDKVersion.
    #jdkVersionOption: 'default' # 'default' | '1.17' | '1.11' | '1.10' | '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.
  # Code Analysis
    #sonarQubeRunAnalysis: false # boolean. Alias: sqAnalysisEnabled. Run SonarQube or SonarCloud Analysis. Default: false.
    #sqGradlePluginVersionChoice: 'specify' # 'specify' | 'build'. Required when sqAnalysisEnabled = true. SonarQube scanner for Gradle version. Default: specify.
    #sonarQubeGradlePluginVersion: '2.6.1' # string. Alias: sqGradlePluginVersion. Required when sqAnalysisEnabled = true && sqGradlePluginVersionChoice = specify. SonarQube scanner for Gradle plugin version. Default: 2.6.1.
    #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.
    #spotBugsAnalysis: false # boolean. Alias: spotBugsAnalysisEnabled. Run SpotBugs. Default: false.
    #spotBugsGradlePluginVersionChoice: 'specify' # 'specify' | 'build'. Required when spotBugsAnalysisEnabled = true. Spotbugs plugin version. Default: specify.
    #spotbugsGradlePluginVersion: '4.7.0' # string. Required when spotBugsAnalysisEnabled = true && spotBugsGradlePluginVersionChoice = specify. Version number. Default: 4.7.0.

# Gradle v2
# Build using a Gradle wrapper script.
- task: Gradle@2
  inputs:
    gradleWrapperFile: 'gradlew' # string. Alias: wrapperScript. Required. Gradle wrapper. Default: gradlew.
    #workingDirectory: # string. Alias: cwd. Working directory. 
    #options: # string. Options. 
    tasks: 'build' # string. Required. Tasks. Default: build.
  # JUnit Test Results
    #publishJUnitResults: true # boolean. Publish to Azure Pipelines. Default: true.
    testResultsFiles: '**/TEST-*.xml' # string. Required when publishJUnitResults = true. Test results files. Default: **/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 != None. 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.
    #codeCoverageGradle5xOrHigher: true # boolean. Alias: gradle5xOrHigher. Optional. Use when codeCoverageTool = JaCoCo. Gradle version >= 5.x. Default: true.
  # Advanced
    javaHomeOption: 'JDKVersion' # 'JDKVersion' | 'Path'. Alias: javaHomeSelection. Required. Set JAVA_HOME by. Default: JDKVersion.
    #jdkVersionOption: 'default' # 'default' | '1.11' | '1.10' | '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.
  # Code Analysis
    #sonarQubeRunAnalysis: false # boolean. Alias: sqAnalysisEnabled. Run SonarQube or SonarCloud Analysis. Default: false.
    #sqGradlePluginVersionChoice: 'specify' # 'specify' | 'build'. Required when sqAnalysisEnabled = true. SonarQube scanner for Gradle version. Default: specify.
    #sonarQubeGradlePluginVersion: '2.6.1' # string. Alias: sqGradlePluginVersion. Required when sqAnalysisEnabled = true && sqGradlePluginVersionChoice = specify. SonarQube scanner for Gradle plugin version. Default: 2.6.1.
    #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.
    #spotBugsAnalysis: false # boolean. Alias: spotBugsAnalysisEnabled. Run SpotBugs. Default: false.
    #spotBugsGradlePluginVersionChoice: 'specify' # 'specify' | 'build'. Required when spotBugsAnalysisEnabled = true. Spotbugs plugin version. Default: specify.
    #spotbugsGradlePluginVersion: '4.7.0' # string. Required when spotBugsAnalysisEnabled = true && spotBugsGradlePluginVersionChoice = specify. Version number. Default: 4.7.0.

# Gradle v2
# Build using a Gradle wrapper script.
- task: Gradle@2
  inputs:
    gradleWrapperFile: 'gradlew' # string. Alias: wrapperScript. Required. Gradle wrapper. Default: gradlew.
    #workingDirectory: # string. Alias: cwd. Working directory. 
    #options: # string. Options. 
    tasks: 'build' # string. Required. Tasks. Default: build.
  # JUnit Test Results
    #publishJUnitResults: true # boolean. Publish to Azure Pipelines. Default: true.
    testResultsFiles: '**/TEST-*.xml' # string. Required when publishJUnitResults = true. Test results files. Default: **/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 != None. 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.
  # Advanced
    javaHomeOption: 'JDKVersion' # 'JDKVersion' | 'Path'. Alias: javaHomeSelection. Required. Set JAVA_HOME by. Default: JDKVersion.
    #jdkVersionOption: 'default' # 'default' | '1.11' | '1.10' | '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.
  # Code Analysis
    #sonarQubeRunAnalysis: false # boolean. Alias: sqAnalysisEnabled. Run SonarQube or SonarCloud Analysis. Default: false.
    #sqGradlePluginVersionChoice: 'specify' # 'specify' | 'build'. Required when sqAnalysisEnabled = true. SonarQube scanner for Gradle version. Default: specify.
    #sonarQubeGradlePluginVersion: '2.6.1' # string. Alias: sqGradlePluginVersion. Required when sqAnalysisEnabled = true && sqGradlePluginVersionChoice = specify. SonarQube scanner for Gradle plugin version. Default: 2.6.1.
    #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.

# Gradle v2
# Build using a Gradle wrapper script.
- task: Gradle@2
  inputs:
    gradleWrapperFile: 'gradlew' # string. Alias: wrapperScript. Required. Gradle wrapper. Default: gradlew.
    #workingDirectory: # string. Alias: cwd. Working directory. 
    #options: # string. Options. 
    tasks: 'build' # string. Required. Tasks. Default: build.
  # JUnit Test Results
    #publishJUnitResults: true # boolean. Publish to Azure Pipelines. Default: true.
    testResultsFiles: '**/TEST-*.xml' # string. Required when publishJUnitResults = true. Test results files. Default: **/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.
  # Advanced
    javaHomeOption: 'JDKVersion' # 'JDKVersion' | 'Path'. Alias: javaHomeSelection. Required. Set JAVA_HOME by. Default: JDKVersion.
    #jdkVersionOption: 'default' # 'default' | '1.11' | '1.10' | '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.
  # Code Analysis
    #sonarQubeRunAnalysis: false # boolean. Alias: sqAnalysisEnabled. Run SonarQube or SonarCloud Analysis. Default: false.
    #sqGradlePluginVersionChoice: 'specify' # 'specify' | 'build'. Required when sqAnalysisEnabled = true. SonarQube scanner for Gradle version. Default: specify.
    #sonarQubeGradlePluginVersion: '2.6.1' # string. Alias: sqGradlePluginVersion. Required when sqAnalysisEnabled = true && sqGradlePluginVersionChoice = specify. SonarQube scanner for Gradle plugin version. Default: 2.6.1.
    #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.

# Gradle v2
# Build using a Gradle wrapper script.
- task: Gradle@2
  inputs:
    gradleWrapperFile: 'gradlew' # string. Alias: wrapperScript. Required. Gradle wrapper. Default: gradlew.
    #workingDirectory: # string. Alias: cwd. Working directory. 
    #options: # string. Options. 
    tasks: 'build' # string. Required. Tasks. Default: build.
  # JUnit Test Results
    #publishJUnitResults: true # boolean. Publish to Azure Pipelines/TFS. Default: true.
    testResultsFiles: '**/TEST-*.xml' # string. Required when publishJUnitResults = true. Test results files. Default: **/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.
  # Advanced
    javaHomeOption: 'JDKVersion' # 'JDKVersion' | 'Path'. Alias: javaHomeSelection. Required. Set JAVA_HOME by. Default: JDKVersion.
    #jdkVersionOption: 'default' # 'default' | '1.11' | '1.10' | '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.
  # Code Analysis
    #sonarQubeRunAnalysis: false # boolean. Alias: sqAnalysisEnabled. Run SonarQube or SonarCloud Analysis. Default: false.
    #sqGradlePluginVersionChoice: 'specify' # 'specify' | 'build'. Required when sqAnalysisEnabled = true. SonarQube scanner for Gradle version. Default: specify.
    #sonarQubeGradlePluginVersion: '2.6.1' # string. Alias: sqGradlePluginVersion. Required when sqAnalysisEnabled = true && sqGradlePluginVersionChoice = specify. SonarQube scanner for Gradle plugin version. Default: 2.6.1.
    #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 استخدام البرنامج النصي shell gradlew . تعرف على المزيد حول Gradle Wrapper.

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

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

options - خيارات
string.

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

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

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

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

publishJUnitResults - النشر إلى Azure Pipelines
boolean. القيمة الافتراضية: true.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

codeCoverageGradle5xOrHigher - إصدار >Gradle = 5.x
الاسم المستعار للإدخل: gradle5xOrHigher. boolean. ‏‏اختياري. استخدم عندما codeCoverageTool = JaCoCo. القيمة الافتراضية: true.

قم بتعيين هذا إلى "صحيح" إذا كان إصدار gradle = >5.x.

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

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

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

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

jdkVersionOption - إصدار JDK
الاسم المستعار للإدخل: jdkVersion. string. ‏‏اختياري. استخدم عندما javaHomeSelection = JDKVersion. القيم المسموح بها: default، 1.11 (JDK 11)، 1.10 (JDK 10 (خارج الدعم))، 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 أو SonarCloud Analysis
الاسم المستعار للإدخل: sqAnalysisEnabled. boolean. القيمة الافتراضية: false.

تم تغيير هذا الخيار من الإصدار 1 من مهمة Gradle لاستخدام ملحقات سوق SonarQube و SonarCloud . قم بتمكين هذا الخيار لتشغيل تحليل SonarQube أو SonarCloud بعد تنفيذ المهام في حقل المهام . يجب أيضا إضافة مهمة Prepare Analysis Configuration من أحد الملحقات إلى البنية الأساسية لبرنامج ربط العمليات التجارية للبناء قبل مهمة Gradle هذه.

sqGradlePluginVersionChoice - الماسح الضوئي SonarQube لإصدار Gradle
string. مطلوب عند sqAnalysisEnabled = true. القيم المسموح بها: specify (تحديد رقم الإصدار)، build (استخدم المكون الإضافي المطبق في build.gradle). القيمة الافتراضية: specify.

يحدد إصدار المكون الإضافي SonarQube Gradle لاستخدامه. قم بتعريف الإصدار في ملف تكوين Gradle، أو حدد إصدارا بهذه السلسلة.

sonarQubeGradlePluginVersion - الماسح الضوئي SonarQube لإصدار المكون الإضافي Gradle
الاسم المستعار للإدخل: sqGradlePluginVersion. string. مطلوب عند sqAnalysisEnabled = true && sqGradlePluginVersionChoice = specify. القيمة الافتراضية: 2.6.1.

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

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

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

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

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

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

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

spotBugsAnalysis - تشغيل SpotBugs
الاسم المستعار للإدخل: spotBugsAnalysisEnabled. boolean. القيمة الافتراضية: false.

يتم تشغيله spotBugs عند true. يعمل هذا المكون الإضافي مع Gradle v5.6 أو أحدث. تعرف على المزيد حول استخدام المكون الإضافي SpotBugs Gradle. قد يعمل المكون الإضافي بطريقة غير متوقعة أو قد لا يعمل على الإطلاق مع إصدار Gradle سابق.

spotBugsGradlePluginVersionChoice - إصدار المكون الإضافي Spotbugs
string. مطلوب عند spotBugsAnalysisEnabled = true. القيم المسموح بها: specify (تحديد رقم الإصدار)، build (استخدم المكون الإضافي المطبق في build.gradle). القيمة الافتراضية: specify.

يحدد إصدار المكون الإضافي SpotBugs Gradle لاستخدامه. يمكن الإعلان عن الإصدار في ملف تكوين Gradle، أو يمكن تحديد الإصدار في هذه السلسلة.

spotbugsGradlePluginVersion - رقم الإصدار
string. مطلوب عند spotBugsAnalysisEnabled = true && spotBugsGradlePluginVersionChoice = specify. القيمة الافتراضية: 4.7.0.

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

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

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

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

لا شيء

الملاحظات

ملاحظة

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

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

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

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

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

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

jamal@fabrikam> gradle wrapper
قم بتحميل برنامج تضمين 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 ثوان إلى دقيقة واحدة.

أمثلة

إنشاء تطبيق Java باستخدام Gradle

المتطلبات

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

مشاركة عبر

Gradle@2 - مهمة Gradle v2

بناء الجملة

الإدخالات

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

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

الملاحظات

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

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

أمثلة

المتطلبات

الملاحظات

الملاحظات

الموارد الإضافية