بهینه‌سازی مدیریت وظایف Gradle با Kotlin DSL و buildSrc

// build.gradle.kts (projet racine)
plugins {
    base // Appliqué au projet racine
}

allprojects {
    group = "com.example"
    version = "1.0.0"

    repositories {
        mavenCentral()
    }

    tasks.withType<org.gradle.api.tasks.testing.Test> {
        useJUnitPlatform() // Configuration commune des tests pour tous les projets
    }
}

subprojects {
    apply(plugin = "java")
    apply(plugin = "org.jetbrains.kotlin.jvm")

    dependencies {
        implementation("org.jetbrains.kotlin:kotlin-stdlib-jdk8")
    }

}

----
----
init {
    group = "verification"
    description = "Opens a test report in Firefox."
    dependsOn("check") // Assure que les rapports sont générés
}

@get:Input
abstract var reportPath: String

@TaskAction
fun openReport() {
    val separator = File.separator
    val reportFile = project.layout.projectDirectory.asFile.toPath()
        .resolve(reportPath.replace("/", separator))
        .toAbsolutePath()
        .toFile()

    if (!reportFile.exists()) {
        logger.warn("Report file does not exist: $reportFile. Ensure 'check' ran.")
        return
    }

    project.exec {
        commandLine("firefox", "--new-tab", reportFile.absolutePath)
    }
    logger.lifecycle("Opened test report: ${reportFile.absolutePath}")
}
----

## }

\=== پیاده‌سازی‌های ملموس

این کلاس‌ها از کار انتزاعی ارث می‌برند و مسیر خاص گزارش را تعریف می‌کنند.

## [source,kotlin]

package com.yourpackage

کلاس انتزاعی ReportUnitTestsTask : OpenTestReportTask() init { گزارش تست واحد را در Firefox باز می‌کند. reportPath = "build/reports/tests/test/index.html } }

بسته com.yourpackage

abstract class ReportFunctionalTestsTask : OpenTestReportTask() { init { description = "گزارش تست کارکردی را در فایرفکس باز می‌کند." reportPath = "build/reports/tests/functionalTest/index.html" } }

\=== ثبت وظایف

در`build.gradle.kts`از شما پروژه ریشه :

[source,kotlin]

tasks.register<com.yourpackage.ReportUnitTestsTask>("reportTests") {} tasks.register<com.yourpackage.ReportFunctionalTestsTask>("reportFunctionalTests") {}

=== نمودار UML وظایف Raport (کد PlantUML)

کد زیر را کپی کنید و در ابزاری که PlantUML را پشتیبانی می‌کند، جایگذاری کنید.

## [source,plantuml]

@startuml skinparam نوشته به دست درست skinparam monochrome true

کلاس انتزاعی DefaultTask { }

کلاس انتزاعی Exec { \+ commandLine(args: String...) \+ exec() }

کلاس انتزاعی OpenTestReportTask به ارث می‌برد DefaultTask { \+ group: String = "verification \+ شرح: رشته \+ dependsOn("check") \+ چکیده reportPath: رشته \+ openReport() : void }

abstract class AbstractJbakeExecTask extends Exec { \+ group: String = "verification \+ توضیح: رشته \+ dependsOn("check") \+ abstract reportRelativePath: String + exec() : void }

class ReportUnitTestsTask extends OpenTestReportTask { \+ مسیر گزارش: String = "build/reports/tests/test/index.html }

class ReportFunctionalTestsTask extends OpenTestReportTask { \+ reportPath: String = "build/reports/tests/functionalTest/index.html }

class ReportJbakeTestsTask extends AbstractJbakeExecTask { \+ reportRelativePath: String = "build/reports/tests/test/index.html }

کلاس ReportJbakeFunctionalTestsTask AbstractJbakeExecTask را به ارث می‌برد { \+ reportRelativePath: String = "build/reports/tests/functionalTest/index.html }

OpenTestReportTask \<-- ReportUnitTestsTask OpenTestReportTask \<-- ReportFunctionalTestsTask

AbstractJbakeExecTask \<-- ReportJbakeTestsTask AbstractJbakeExecTask \<-- ReportJbakeFunctionalTestsTask

DefaultTask \<|-- OpenTestReportTask اجرا \<|-- AbstractJbakeExecTask DefaultTask \<|-- Exec

## @enduml

\== وظیفه انتزاعی`AbstractJbakeExecTask`(ارث بر`Exec`)

اگر وظیفه شما عمدتاً اجرای یک دستور خارجی با آرگومان‌های متغیر است، به‌صورت مستقیم از**اجرا**مستقیم‌تر است.

## [source,kotlin]

package com.yourpackage

وارد org.gradle.api.tasks.Exec import org.gradle.api.tasks.Input import java.io.File

abstract class AbstractJbakeExecTask : Exec() {

----

init { group = "verification" description = "Opens a Jbake project report in Firefox." dependsOn("check") }

@get:Input abstract var reportRelativePath: String

override fun exec() { val separator = File.separator val reportFile = project.layout.projectDirectory.asFile.toPath() .resolve(reportRelativePath.replace("/", separator)) .toAbsolutePath() .toFile()

if (!reportFile.exists()) { logger.warn("Report file does not exist: $reportFile. Ensure 'check' ran.") return }

commandLine("firefox", "--new-tab", reportFile.absolutePath) logger.lifecycle("Attempting to open report: ${reportFile.absolutePath}") super.exec() // Appelle la méthode exec() de la super-classe Exec }

## }

\=== پیاده‌سازی‌های عملی برای`Exec`

## [source,kotlin]

package com.yourpackage

abstract class ReportJbakeTestsTask : AbstractJbakeExecTask() { شروع { گزارش تست واحد Jbake را در فایرفاکس باز می‌کند. مسیر نسبی گزارش = "build/reports/tests/test/index.html } }

package com.yourpackage

## abstract class ReportJbakeFunctionalTestsTask : AbstractJbakeExecTask() { init { description = "گزارش تست عملکردی در فایرفکس باز می‌شود." reportRelativePath = "build/reports/tests/functionalTest/index.html" } }

نمایش وظایف`buildSrc`

وظائف و کلاس‌هایی که تعریف می‌کنید در**buildSrc**هستند :

لطفاً متنی که باید ترجمه شود را ارائه دهید. در حالی که منتظر ورودی هستم، توجه داشته باشم که فقط بخش‌های buiten backtick‌ها را ترجمه خواهم کرد و محتوای دقیق درون علامت‌های backtick (`...`) را بدون تغییر حفظ خواهم کرد. خروجی صرفاً متن ترجمه‌شده خواهد بود، بدون هیچ توضیحی یا متنی اضافی.**قابل مشاهده و قابل استفاده**در تمام پروژه‌های build اصلی شما (ریشه و زیرپروژه‌ها). به همین دلیل می‌توانید از آن استفاده کرد`com.yourpackage.ReportUnitTestsTask`در`allprojects { ... }`. ***غیر اجرایی**مستقیم به عنوان وظایف buildSrc (به عنوان مثال,`gradle :buildSrc:reportTests`کار نمی‌کند اگر وظیفه به‌خصوص در ثبت نشود در`buildSrc/build.gradle.kts`)`buildSrc`یک ماژول کامپایل است، نه یک ماژول برنامه اجرایی برای این وظایف ساخت اصلی.

اجرای یک گزارش برای آزمون‌های`buildSrc`خودش

Si `buildSrc`او تست‌های خود را دارد و گزارش‌ها را تولید می‌کند، شما می‌توانید یک وظیفهٔ گزارش را مستقیماً در`buildSrc/build.gradle.kts`:

## [source,kotlin]

پلاگین‌ها { `kotlin-jvm` }

repositories { mavenCentral() }

tasks.withType\<Test\> { useJUnitPlatform() reports.html.outputLocation.set(layout.buildDirectory.dir("reports/tests")) }

import com.yourpackage.ReportJbakeTestsTask // کلاس وظیفه خود را وارد کنید

## tasks.register\<ReportJbakeTestsTask\>("reportBuildSrcTests") { // مسیر قبلاً در کلاس تعریف شده است و به reports buildSrc اشاره خواهد کرد }

سپس می‌توانید اجرا کنید :`./gradlew :buildSrc:test`پیروی از`./gradlew :buildSrc:reportBuildSrcTests`.

با اتخاذ این روش‌ها، شما سیستم‌های ساخت Gradle با Kotlin DSL را خواهید ساخت که نه تنها قدرتمند هستند، بلکه به‌طور قابل‌توجهی ماژولار، قابل‌نگهداری و آسان برای درک هم هستند.