Hızlı başlangıç

Compose ile geliştirme yaparken en iyi deneyimi yaşamak için Android Studio'yu indirip yükleyin. Yeni proje şablonları ve Oluşturma kullanıcı arayüzünüzü ve animasyonlarınızı hemen önizleme 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 projesi için oluşturun veya Compose'da yazılmış örnek bir uygulamayı içe aktarın.

Oluşturma özelliğini destekleyen yeni bir uygulama oluşturma

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. Alıcı: Compose kurulumunun doğru şekilde yapıldığı yeni bir proje oluşturun. Bunun 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. Açık bir Android Studio projeniz varsa menü çubuğundan Dosya > Yeni > Yeni Proje'yi seçin.
  2. Proje Şablonu Seçin penceresinde Boş Etkinlik'i seçin ve Sonraki'yi tıklayın.
  3. Projenizi yapılandırın penceresinde aşağıdakileri yapın:
    1. Ad, Paket adı ve Kaydetme konumu'nu normalde yaptığınız gibi ayarlayın. Jetpack Compose yalnızca Kotlin ile yazılmış sınıflarla çalıştığından Dil açılır menüsünde yalnızca Kotlin'in kullanılabildiğini unutmayın.
    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. Size yardımcı olmak için başlamak ve araç setiyle neler yapabileceğinizi öğrenmek için, Jetpack'i deneyin Eğitim oluşturun.

Compose'u mevcut bir uygulama için ayarlama

İlk olarak, Compose'u kullanarak Compose derleyicisini yapılandırın. Compiler Gradle eklentisi.

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

Eski

android {
    buildFeatures {
        compose true
    }
}

Kotlin

android {
    buildFeatures {
        compose = true
    }
}

Android BuildFeatures içinde compose işaretini true olarak ayarlama blok, Android Studio'da Oluştur işlevini etkinleştirir.

Son olarak, Oluşturma BOM'sini ve Compose kitaplığı bağımlılıklarının alt kümesini ekleyin bağımlılıklarınızı aşağıdaki bloktan izlemeniz gerekir:

Eski

dependencies {

    def composeBom = platform('androidx.compose:compose-bom:2024.09.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.9.2'
    // 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:2024.09.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.9.2")
    // 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 projesini içe aktarmak için aşağıdaki adımları uygulayın:

  1. Android Studio'ya hoş geldiniz penceresindeyseniz Android kod örneği içe aktar'ı seçin. Açık bir Android Studio projeniz varsa Dosya > Yeni > Menü çubuğundan Örneği İçe Aktar'ı seçin.
  2. Sana Özel 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ğerlere sahiptir.
  5. Son'u tıklayın.

Android Studio, örnek uygulamayı belirttiğiniz yola indirir ve belirler. Ardından, örneklerin her birinde MainActivity.kt öğelerini inceleyerek Geçiş animasyonu, özel bileşenler gibi Jetpack Compose API'leri oluşturma ve IDE içi önizlemede açık ve koyu renkler görüntüleme.

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