Hızlı başlangıç

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

Android Studio'yu indirin

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

Compose desteğiyle yeni bir uygulama oluşturun

Varsayılan olarak Oluşturma 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 kurulumunun doğru şekilde yapıldığı yeni bir proje oluşturmak için şu adımları uygulayın:

1. Android Studio'ya hoş geldiniz penceresindeyseniz Yeni bir Android Studio projesi başlat'ı tıklayın. Açık bir Android Studio projeniz zaten varsa menü çubuğundan Dosya > Yeni > Yeni Proje'yi seçin.
2. Proje Şablonu Seçin penceresinde Boş Etkinlik'i seçin ve İleri'yi tıklayın.
3. Projenizi yapılandırın penceresinde aşağıdakileri yapın:
   1. Adı, Paket adı'nı ve Konumu kaydet'i her zamanki gibi ayarlayın. Jetpack Compose yalnızca Kotlin dilinde yazılan sınıflarla çalıştığından, Dil açılır menüsündeki tek seçenek Kotlin'dir.
   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'u kullanarak uygulama geliştirmeye hazırsınız. Başlamanıza ve araç setiyle neler yapabileceğinizi öğrenmenize yardımcı olması için Jetpack Compose eğiticisini deneyin.

Compose'u mevcut bir uygulama için ayarlama

İlk olarak, Compose Derleyici Gradle eklentisini kullanarak Compose derleyiciyi yapılandırın.

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

android {
    buildFeatures {
        compose true
    }
}

android {
    buildFeatures {
        compose = true
    }
}

compose işaretinin Android BuildFeatures bloğunda true olarak ayarlanması, Android Studio'da Oluşturma işlevini etkinleştirir.

Son olarak, Compose BOM'yi ve ihtiyacınız olan Compose kitaplığı bağımlılıklarını aşağıdaki bloktaki bağımlılıklarınıza ekleyin:

dependencies {

    def composeBom = platform('androidx.compose:compose-bom:2024.06.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:material3-window-size-class'

    // Optional - Integration with activities
    implementation 'androidx.activity:activity-compose:1.9.0'
    // Optional - Integration with ViewModels
    implementation 'androidx.lifecycle:lifecycle-viewmodel-compose:2.6.1'
    // 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:2024.06.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:material3-window-size-class")

    // Optional - Integration with activities
    implementation("androidx.activity:activity-compose:1.9.0")
    // Optional - Integration with ViewModels
    implementation("androidx.lifecycle:lifecycle-viewmodel-compose:2.6.1")
    // 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 bir örnek uygulama projesini içe aktarmak için şu adımları uygulayın:

1. Android Studio'ya Hoş Geldiniz penceresindeyseniz Android kod örneğini içe aktar'ı seçin. Açık bir Android Studio projeniz zaten varsa menü çubuğundan Dosya > Yeni > Örneği İçe Aktar'ı seçin.
2. Örneklere Göz Atma sihirbazının üst kısmındaki arama çubuğuna "oluştur" yazın.
3. Arama sonuçlarından Jetpack Compose örnek uygulamalarından birini seçin ve İleri'yi tıklayın.
4. Uygulama adı ve Proje konumu'nu 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, geçiş animasyonu, özel bileşenler, tipografi kullanma ve IDE içi önizlemede açık ve koyu renkler görüntüleme gibi Jetpack Compose API'lerini görmek için örneklerin her birinde MainActivity.kt öğesini inceleyebilirsiniz.

Wear OS için Jetpack Compose'u kullanmak istiyorsanız Wear OS'te Jetpack Compose'u kurma konusuna bakın.