نمای کلی ساخت Gradle, نمای کلی ساخت Gradle

یک سیستم ساخت، کد منبع شما را به یک برنامه اجرایی تبدیل می کند. بیلدها اغلب شامل چندین ابزار برای تجزیه و تحلیل، کامپایل، پیوند دادن و بسته بندی برنامه یا کتابخانه شما هستند. Gradle از یک رویکرد مبتنی بر وظیفه برای سازماندهی و اجرای این دستورات استفاده می کند.

وظایف دستوراتی را محصور می کنند که ورودی های آنها را به خروجی تبدیل می کند. پلاگین ها وظایف و پیکربندی آنها را تعریف می کنند. اعمال یک افزونه برای ساخت، وظایف آن را ثبت می‌کند و با استفاده از ورودی‌ها و خروجی‌های آن‌ها را به یکدیگر متصل می‌کند. به عنوان مثال، اعمال پلاگین Android Gradle (AGP) در فایل ساخت شما، تمام کارهای لازم برای ساخت APK یا Android را ثبت می‌کند. کتابخانه. افزونه java-library به شما امکان می دهد یک jar از کد منبع جاوا بسازید. افزونه‌های مشابهی برای Kotlin و سایر زبان‌ها وجود دارد، اما پلاگین‌های دیگر برای گسترش افزونه‌ها طراحی شده‌اند. به عنوان مثال، پلاگین protobuf به منظور افزودن پشتیبانی protobuf به پلاگین های موجود مانند AGP یا java-library است.

Gradle قرارداد را بر پیکربندی ترجیح می‌دهد، بنابراین افزونه‌ها با مقادیر پیش‌فرض خوب خارج از جعبه ارائه می‌شوند، اما می‌توانید ساختار را از طریق یک زبان خاص دامنه (DSL) پیکربندی کنید. DSL طوری طراحی شده است که می توانید مشخص کنید چه چیزی بسازید، نه اینکه چگونه آن را بسازید. منطق موجود در افزونه ها "چگونه" را مدیریت می کند. این پیکربندی در چندین فایل ساخت در پروژه شما (و پروژه های فرعی) مشخص شده است.

ورودی های وظیفه می توانند فایل ها و دایرکتوری ها و همچنین اطلاعات دیگری باشند که به صورت انواع جاوا (اعداد صحیح، رشته ها یا کلاس های سفارشی) کدگذاری شده اند. خروجی ها فقط می توانند دایرکتوری یا فایل باشند زیرا باید روی دیسک نوشته شوند. سیم‌کشی یک خروجی کار به ورودی وظیفه دیگر، وظایف را به یکدیگر پیوند می‌دهد تا یکی قبل از دیگری اجرا شود.

در حالی که Gradle از نوشتن کد دلخواه و اعلان‌های وظایف در فایل‌های ساخت شما پشتیبانی می‌کند، این می‌تواند درک ساخت و نگهداری از ابزار را دشوارتر کند. به عنوان مثال، شما می توانید برای کد در داخل افزونه ها تست بنویسید اما در فایل های ساخت. در عوض، شما باید منطق ساخت و اعلان وظایف را به افزونه ها (که شما یا شخص دیگری تعریف می کنید) محدود کنید و نحوه استفاده از آن منطق را در فایل های ساخت خود اعلام کنید.

android {
    namespace = "com.example.app"
    compileSdk = 34
    // ...

    defaultConfig {
        applicationId = "com.example.app"
        minSdk = 34
        // ...
    }
}

android {
    namespace 'com.example.myapplication'
    compileSdk 34
    // ...

    defaultConfig {
        applicationId "com.example.myapplication"
        minSdk 24
        // ...
    }
}

fun Project.android(configure: ApplicationExtension.() -> Unit) {
    ...
}

interface ApplicationExtension {
    var compileSdk: Int
    var namespace: String?

    val defaultConfig: DefaultConfig

    fun defaultConfig(configure: DefaultConfig.() -> Unit) {
        ...
    }
}