شروع سریع

برای بهترین تجربه توسعه با Compose، اندروید استودیو را دانلود و نصب کنید. این برنامه شامل بسیاری از ویژگی‌های ویرایشگر هوشمند ، مانند قالب‌های پروژه جدید و امکان پیش‌نمایش فوری رابط کاربری و انیمیشن‌های Compose شما است.

دریافت اندروید استودیو

برای ایجاد یک پروژه برنامه جدید Compose، تنظیم Compose برای یک پروژه برنامه موجود یا وارد کردن یک برنامه نمونه نوشته شده در Compose، این دستورالعمل‌ها را دنبال کنید.

یک برنامه جدید با پشتیبانی از Compose ایجاد کنید

اگر می‌خواهید یک پروژه جدید شروع کنید که به طور پیش‌فرض از Compose پشتیبانی می‌کند، اندروید استودیو قالب‌های پروژه مختلفی را برای کمک به شما در شروع کار ارائه می‌دهد. برای ایجاد یک پروژه جدید که تنظیمات Compose به درستی روی آن انجام شده است، به شرح زیر عمل کنید:

  1. اگر در پنجره «به اندروید استودیو خوش آمدید» هستید، روی «شروع یک پروژه جدید اندروید استودیو» کلیک کنید. اگر از قبل یک پروژه اندروید استودیو باز دارید، از نوار منو، «فایل» > «جدید» > «پروژه جدید» را انتخاب کنید.
  2. در پنجره «انتخاب الگوی پروژه» ، گزینه «فعالیت خالی» را انتخاب کرده و روی «بعدی» کلیک کنید.
  3. در پنجره پیکربندی پروژه ، موارد زیر را انجام دهید:
    1. نام (Name)، نام بسته (Package name ) و مکان ذخیره (Save location) را طبق معمول تنظیم کنید. توجه داشته باشید که در منوی کشویی زبان (Languageکاتلین (Kotlin) تنها گزینه موجود است زیرا Jetpack Compose فقط با کلاس‌هایی که به زبان کاتلین نوشته شده‌اند، کار می‌کند.
    2. در منوی کشویی «حداقل سطح API» ، سطح API 21 یا بالاتر را انتخاب کنید.
  4. روی پایان کلیک کنید.

اکنون آماده‌اید تا با استفاده از Jetpack Compose توسعه یک برنامه را آغاز کنید. برای کمک به شروع کار و یادگیری کارهایی که می‌توانید با این ابزار انجام دهید، آموزش Jetpack Compose را امتحان کنید.

تنظیم Compose برای یک برنامه موجود

ابتدا، کامپایلر Compose را با استفاده از افزونه Compose Compiler Gradle پیکربندی کنید.

سپس، تعریف زیر را به فایل build.gradle برنامه خود اضافه کنید:

گرووی

android {
    buildFeatures {
        compose true
    }
}

کاتلین

android {
    buildFeatures {
        compose = true
    }
}

تنظیم پرچم compose روی true در داخل بلوک Android BuildFeatures ، قابلیت Compose را در اندروید استودیو فعال می‌کند.

در نهایت، Compose BOM و زیرمجموعه‌ای از وابستگی‌های کتابخانه Compose مورد نیاز خود را از بلوک زیر به وابستگی‌های خود اضافه کنید:

گرووی

dependencies {

    def composeBom = platform('androidx.compose:compose-bom:2025.10.01')
    implementation composeBom
    androidTestImplementation composeBom

    // Choose one of the following:
    // Material Design 3
    implementation 'androidx.compose.material3:material3'
    // or skip Material Design and build directly on top of foundational components
    implementation 'androidx.compose.foundation:foundation'
    // or only import the main APIs for the underlying toolkit systems,
    // such as input and measurement/layout
    implementation 'androidx.compose.ui:ui'

    // Android Studio Preview support
    implementation 'androidx.compose.ui:ui-tooling-preview'
    debugImplementation 'androidx.compose.ui:ui-tooling'

    // UI Tests
    androidTestImplementation 'androidx.compose.ui:ui-test-junit4'
    debugImplementation 'androidx.compose.ui:ui-test-manifest'

    // Optional - Add window size utils
    implementation 'androidx.compose.material3.adaptive:adaptive'

    // Optional - Integration with activities
    implementation 'androidx.activity:activity-compose:1.11.0'
    // Optional - Integration with ViewModels
    implementation 'androidx.lifecycle:lifecycle-viewmodel-compose:2.8.5'
    // Optional - Integration with LiveData
    implementation 'androidx.compose.runtime:runtime-livedata'
    // Optional - Integration with RxJava
    implementation 'androidx.compose.runtime:runtime-rxjava2'

}

کاتلین

dependencies {

    val composeBom = platform("androidx.compose:compose-bom:2025.10.01")
    implementation(composeBom)
    androidTestImplementation(composeBom)

    // Choose one of the following:
    // Material Design 3
    implementation("androidx.compose.material3:material3")
    // or skip Material Design and build directly on top of foundational components
    implementation("androidx.compose.foundation:foundation")
    // or only import the main APIs for the underlying toolkit systems,
    // such as input and measurement/layout
    implementation("androidx.compose.ui:ui")

    // Android Studio Preview support
    implementation("androidx.compose.ui:ui-tooling-preview")
    debugImplementation("androidx.compose.ui:ui-tooling")

    // UI Tests
    androidTestImplementation("androidx.compose.ui:ui-test-junit4")
    debugImplementation("androidx.compose.ui:ui-test-manifest")

    // Optional - Add window size utils
    implementation("androidx.compose.material3.adaptive:adaptive")

    // Optional - Integration with activities
    implementation("androidx.activity:activity-compose:1.11.0")
    // Optional - Integration with ViewModels
    implementation("androidx.lifecycle:lifecycle-viewmodel-compose:2.8.5")
    // Optional - Integration with LiveData
    implementation("androidx.compose.runtime:runtime-livedata")
    // Optional - Integration with RxJava
    implementation("androidx.compose.runtime:runtime-rxjava2")

}

برنامه‌های نمونه Jetpack Compose را امتحان کنید

سریع‌ترین راه برای آزمایش قابلیت‌های Jetpack Compose، امتحان کردن برنامه‌های نمونه Jetpack Compose است که در GitHub میزبانی می‌شوند. برای وارد کردن یک پروژه برنامه نمونه از اندروید استودیو، به شرح زیر عمل کنید:

  1. اگر در پنجره‌ی «به اندروید استودیو خوش آمدید» هستید، گزینه‌ی «وارد کردن یک نمونه کد اندروید» را انتخاب کنید. اگر از قبل یک پروژه‌ی اندروید استودیو باز دارید، از نوار منو، مسیر File > New > Import Sample را انتخاب کنید.
  2. در نوار جستجو نزدیک بالای ویزارد مرور نمونه‌ها ، عبارت «compose» را تایپ کنید.
  3. یکی از برنامه‌های نمونه Jetpack Compose را از نتایج جستجو انتخاب کنید و روی Next کلیک کنید.
  4. یا نام برنامه و محل پروژه را تغییر دهید یا مقادیر پیش‌فرض را حفظ کنید.
  5. روی پایان کلیک کنید.

اندروید استودیو برنامه نمونه را در مسیری که مشخص کرده‌اید دانلود کرده و پروژه را باز می‌کند. سپس می‌توانید MainActivity.kt در هر یک از مثال‌ها بررسی کنید تا APIهای Jetpack Compose مانند انیمیشن crossfade، کامپوننت‌های سفارشی، استفاده از تایپوگرافی و نمایش رنگ‌های روشن و تیره را در پیش‌نمایش درون IDE مشاهده کنید.

برای استفاده از Jetpack Compose برای Wear OS، به «راه‌اندازی Jetpack Compose در Wear OS» مراجعه کنید.

{% کلمه به کلمه %} {% فعل کمکی %} {% کلمه به کلمه %} {% فعل کمکی %}