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.
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:
- 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.
- Proje Şablonu Seçin penceresinde Boş Etkinlik'i seçin ve İleri'yi tıklayın.
- Projenizi yapılandırın penceresinde aşağıdakileri yapın:
- 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.
- Minimum API düzeyi açılır menüsünde API düzeyi 21 veya üstünü seçin.
- 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:
Eski
android {
buildFeatures {
compose true
}
}
Kotlin
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:
Eski
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'
}
Kotlin
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:
- 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.
- Örneklere Göz Atma sihirbazının üst kısmındaki arama çubuğuna "oluştur" yazın.
- Arama sonuçlarından Jetpack Compose örnek uygulamalarından birini seçin ve İleri'yi tıklayın.
- Uygulama adı ve Proje konumu'nu değiştirin veya varsayılan değerleri koruyun.
- 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.
Sizin için önerilenler
- Not: JavaScript kapalıyken bağlantı metni gösterilir
- Oluşturma ile gezinme
- Oluşturma düzeninizi test etme
- Odaklanmaya tepki verme