Hızlı başlangıç

Compose ile geliştirme yaparken en iyi deneyimi elde etmek için Android Studio'yu indirip yükleyin. Yeni proje şablonları ve Compose kullanıcı arayüzünüzü ve animasyonlarınızı anında önizleme özelliği gibi birçok akıllı düzenleyici özelliği içerir.

Android Studio'yu edinme

Yeni bir Compose uygulama projesi oluşturmak, mevcut bir uygulama projesinde Compose'u ayarlamak veya Compose ile yazılmış bir örnek uygulamayı içe aktarmak için bu talimatları uygulayın.

Compose desteğiyle yeni bir uygulama oluşturma

Varsayılan olarak Compose desteği içeren yeni bir proje başlatmak istiyorsanız Android Studio, başlamanıza yardımcı olacak çeşitli proje şablonları içerir. Compose'un doğru şekilde ayarlandığı yeni bir proje oluşturmak için aşağıdaki adımları uygulayın:

  1. Android Studio'ya Hoş Geldiniz penceresindeyseniz Yeni bir Android Studio projesi başlat'ı tıklayın. Android Studio projeniz zaten açıksa menü çubuğundan Dosya > Yeni > Yeni Proje'yi seçin.
  2. Proje Şablonu Seçin penceresinde Boş Etkinlik'i seçip İleri'yi tıklayın.
  3. Projenizi yapılandırın penceresinde aşağıdakileri yapın:
    1. Ad, Paket adı ve Kaydetme konumu'nu her zamanki gibi ayarlayın. Dil açılır menüsünde Kotlin'in tek seçenek olduğunu unutmayın. Bunun nedeni, Jetpack Compose'un yalnızca Kotlin ile yazılmış sınıflarla çalışmasıdır.
    2. Minimum API düzeyi açılır menüsünde API düzeyi 21 veya üstünü seçin.
  4. Son'u tıklayın.

Artık Jetpack Compose kullanarak uygulama geliştirmeye başlayabilirsiniz. Başlamanıza ve araç setiyle neler yapabileceğinizi öğrenmenize yardımcı olması için Jetpack Compose eğitimini deneyin.

Mevcut bir uygulama için Compose'u ayarlama

Öncelikle, Compose Compiler Gradle eklentisini kullanarak Compose derleyicisini yapılandırın.

Ardından, aşağıdaki tanımı uygulamanızın build.gradle dosyasına ekleyin:

Groovy

android {
    buildFeatures {
        compose true
    }
}

Kotlin

android {
    buildFeatures {
        compose = true
    }
}

Android BuildFeatures bloğunda compose işaretini true olarak ayarlamak, Android Studio'da Compose işlevini etkinleştirir.

Son olarak, aşağıdaki bloktan Compose BOM'u ve ihtiyacınız olan Compose kitaplığı bağımlılıklarının alt kümesini bağımlılıklarınıza ekleyin:

Groovy

dependencies {

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

    // Choose one of the following:
    // Material Design 3
    implementation 'androidx.compose.material3:material3'
    // or Material Design 2
    implementation 'androidx.compose.material:material'
    // 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 - Included automatically by material, only add when you need
    // the icons but not the material library (e.g. when using Material3 or a
    // custom design system based on Foundation)
    implementation 'androidx.compose.material:material-icons-core'
    // Optional - Add full set of material icons
    implementation 'androidx.compose.material:material-icons-extended'
    // Optional - Add window size utils
    implementation 'androidx.compose.material3.adaptive:adaptive'

    // Optional - Integration with activities
    implementation 'androidx.activity:activity-compose:1.10.1'
    // 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'

}

Kotlin

dependencies {

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

    // Choose one of the following:
    // Material Design 3
    implementation("androidx.compose.material3:material3")
    // or Material Design 2
    implementation("androidx.compose.material:material")
    // 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 - Included automatically by material, only add when you need
    // the icons but not the material library (e.g. when using Material3 or a
    // custom design system based on Foundation)
    implementation("androidx.compose.material:material-icons-core")
    // Optional - Add full set of material icons
    implementation("androidx.compose.material:material-icons-extended")
    // Optional - Add window size utils
    implementation("androidx.compose.material3.adaptive:adaptive")

    // Optional - Integration with activities
    implementation("androidx.activity:activity-compose:1.10.1")
    // 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 örnek uygulamalarını deneyin

Jetpack Compose'un özelliklerini denemenin en hızlı yolu, GitHub'da barındırılan Jetpack Compose örnek uygulamalarını denemektir. Android Studio'dan örnek bir uygulama projesi içe aktarmak için aşağıdaki adımları uygulayın:

  1. Android Studio'ya Hoş Geldiniz penceresindeyseniz Android kod örneğini içe aktar'ı seçin. Android Studio projeniz zaten açıksa menü çubuğundan Dosya > Yeni > Örnek İçe Aktar'ı seçin.
  2. Örnekleri Gözat sihirbazının üst kısmına yakın arama çubuğuna "compose" (oluştur) yazın.
  3. Arama sonuçlarından bir Jetpack Compose örnek uygulamasını seçip Next'i (İleri) tıklayın.
  4. Uygulama adı ve Proje konumu değerlerini değiştirin veya varsayılan değerleri koruyun.
  5. Son'u tıklayın.

Android Studio, örnek uygulamayı belirttiğiniz yola indirir ve projeyi açar. Ardından, her örnekteki MainActivity.kt öğesini inceleyerek Jetpack Compose API'lerini (ör. çapraz geçiş animasyonu, özel bileşenler, tipografi kullanma ve IDE içi önizlemede açık ve koyu renkleri görüntüleme) görebilirsiniz.

Wear OS için Jetpack Compose'u kullanmak istiyorsanız Wear OS'te Jetpack Compose'u ayarlama başlıklı makaleyi inceleyin.