Android KTX Android Jetpack'in bir parçasıdır.

Android KTX, Android Jetpack ve diğer Android kitaplıklarına dahil olan bir dizi Kotlin uzantısıdır. KTX uzantıları, Jetpack, Android platformu ve diğer API'ler için kısa ve doğal Kotlin sağlar. Bunu yapmak için bu uzantılar aşağıdakiler de dahil olmak üzere çeşitli Kotlin dili özelliklerinden yararlanır:

  • Uzantı işlevleri
  • Uzantı özellikleri
  • Lambdalar
  • Adlandırılmış parametreler
  • Parametre varsayılan değerleri
  • Eş yordamlar

Örneğin, SharedPreferences ile çalışırken tercihler verilerinde değişiklik yapmadan önce bir düzenleyici oluşturmanız gerekir. Ayrıca, düzenlemeyi tamamladığınızda aşağıdaki örnekte gösterildiği gibi bu değişiklikleri uygulamanız veya kaydetmeniz gerekir:

sharedPreferences
        .edit()  // create an Editor
        .putBoolean("key", value)
        .apply() // write to disk asynchronously

Kotlin lambdaları bu kullanım alanı için mükemmel bir seçimdir. Düzenleyici oluşturulduktan sonra çalıştırılacak bir kod bloğu ileterek, kodun çalıştırılmasına izin verip ardından SharedPreferences API'nin değişiklikleri atomik olarak uygulamasını sağlayarak daha kısa bir yaklaşım benimsemenize olanak tanır.

SharedPreferences öğesine düzenleme işlevi ekleyen SharedPreferences.edit Android KTX Core işlevlerinden birine ait örneği burada bulabilirsiniz. Bu işlev, değişikliklerin kaydedilmesi veya uygulanması gerektiğini belirten ilk bağımsız değişken olarak isteğe bağlı bir boolean işaretini alır. Ayrıca, SharedPreferences düzenleyicide gerçekleştirilecek bir işlem de lambda biçiminde alınır.

// SharedPreferences.edit extension function signature from Android KTX - Core
// inline fun SharedPreferences.edit(
//         commit: Boolean = false,
//         action: SharedPreferences.Editor.() -> Unit)

// Commit a new value asynchronously
sharedPreferences.edit { putBoolean("key", value) }

// Commit a new value synchronously
sharedPreferences.edit(commit = true) { putBoolean("key", value) }

Arayan kişi, değişiklikleri kaydetmeyi veya uygulamayı seçebilir. action lambda, SharedPreferences.Editor üzerinde imzasıyla belirtildiği gibi Unit döndüren anonim bir uzantı işlevidir. Bu nedenle, blok içinde doğrudan SharedPreferences.Editor üzerinde çalışabilirsiniz.

Son olarak, SharedPreferences.edit() imzası inline anahtar kelimesini içerir. Bu anahtar kelime, Kotlin derleyicisine, işlev her kullanışında işlev için derlenen bayt kodunu kopyalayıp yapıştırmasını (veya satır içine yapıştırmasını) söyler. Bu sayede, işlev her çağrıldığında her action için yeni bir sınıf oluşturma yükü ortadan kaldırılır.

Lambda kullanarak kod aktarma, geçersiz kılınabilen makul varsayılanlar uygulama ve bu davranışları inline uzantı işlevlerini kullanarak mevcut API'lere ekleme, Android KTX kitaplığı tarafından sağlanan geliştirmelere özgüdür.

Projenizde Android KTX'yi kullanma

Android KTX'yi kullanmaya başlamak için projenizin build.gradle dosyasına aşağıdaki bağımlılığı ekleyin:

GroovyKotlin
repositories {
    google()
}
 
repositories {
    google()
}

AndroidX Modülleri

Android KTX, her biri bir veya daha fazla paket içeren modüller halinde düzenlenir.

Uygulamanızın build.gradle dosyasına her modül yapısını içeren bir bağımlılık eklemeniz gerekir. Sürüm numarasını yapıya eklemeyi unutmayın. En son sürüm numaralarını bu konudaki her bir yapının ilgili bölümünde bulabilirsiniz.

Android KTX, ortak çerçeve API'leri ve alana özgü çeşitli uzantılar için Kotlin uzantıları sağlayan tek çekirdekli bir modül içerir.

Temel modül haricinde tüm KTX modülü yapıları, build.gradle dosyanızdaki temel Java bağımlılığının yerini alır. Örneğin, bir androidx.fragment:fragment bağımlılığını androidx.fragment:fragment-ktx ile değiştirebilirsiniz. Bu söz dizimi, sürüm yönetimini daha iyi yönetmenize yardımcı olur ve ek bağımlılık beyanı koşulları eklemez.

Core KTX

Core KTX modülü, Android çerçevesinin bir parçası olan yaygın kitaplıklar için uzantılar sağlar. Bu kitaplıkların Java tabanlı bağımlılıkları yok. build.gradle içine eklemeniz gereken bağımlılıklar yok.

Bu modülü dahil etmek için uygulamanızın build.gradle dosyasına aşağıdakileri ekleyin:

GroovyKotlin
dependencies {
    implementation "androidx.core:core-ktx:1.15.0"
}
 
dependencies {
    implementation("androidx.core:core-ktx:1.15.0")
}

Core KTX modülünde bulunan paketlerin listesi aşağıda verilmiştir:

Collection KTX

Koleksiyon uzantıları, Android'in ArrayMap, LongSparseArray, LruCache ve diğerleri de dahil olmak üzere bellek tasarruflu toplama kitaplıklarıyla çalışmaya yönelik yardımcı program işlevleri içerir.

Bu modülü kullanmak için uygulamanızın build.gradle dosyasına şunu ekleyin:

GroovyKotlin
dependencies {
    implementation "androidx.collection:collection-ktx:1.4.5"
}
 
dependencies {
    implementation("androidx.collection:collection-ktx:1.4.5")
}

Koleksiyon uzantıları, aşağıdaki örnekte gösterildiği gibi koleksiyon birleştirme gibi işlemleri basitleştirmek için Kotlin'in operatör aşırı yükleme özelliğinden yararlanır:

// Combine 2 ArraySets into 1.
val combinedArraySet = arraySetOf(1, 2, 3) + arraySetOf(4, 5, 6)

// Combine with numbers to create a new sets.
val newArraySet = combinedArraySet + 7 + 8

Fragment KTX

Fragment KTX modülü, fragment API'yi basitleştirmek için çeşitli uzantılar sağlar.

Bu modülü dahil etmek için aşağıdaki kodu uygulamanızın build.gradle dosyasına ekleyin:

GroovyKotlin
dependencies {
    implementation "androidx.fragment:fragment-ktx:1.6.2"
}
 
dependencies {
    implementation("androidx.fragment:fragment-ktx:1.6.2")
}

Fragment KTX modülüyle, lambdalarla parça işlemlerini basitleştirebilirsiniz. Örneğin:

fragmentManager().commit {
   addToBackStack("...")
   setCustomAnimations(
           R.anim.enter_anim,
           R.anim.exit_anim)
   add(fragment, "...")
}

viewModels ve activityViewModels mülk temsilcilerini kullanarak tek satırda bir ViewModel'e de bağlanabilirsiniz:

// Get a reference to the ViewModel scoped to this Fragment
val viewModel by viewModels<MyViewModel>()

// Get a reference to the ViewModel scoped to its Activity
val viewModel by activityViewModels<MyViewModel>()

Yaşam döngüsü KTX

Yaşam döngüsü KTX, her Lifecycle nesnesi için bir LifecycleScope tanımlar. Bu kapsamda başlatılan tüm coroutine'ler, Lifecycle yok edildiğinde iptal edilir. lifecycle.coroutineScope veya lifecycleOwner.lifecycleScope mülklerini kullanarak Lifecycle öğesinin CoroutineScope özelliğine erişebilirsiniz.

Bu modülü dahil etmek için aşağıdaki kodu uygulamanızın build.gradle dosyasına ekleyin:

GroovyKotlin
dependencies {
    implementation "androidx.lifecycle:lifecycle-runtime-ktx:2.8.7"
}
 
dependencies {
    implementation("androidx.lifecycle:lifecycle-runtime-ktx:2.8.7")
}

Aşağıdaki örnekte, önceden hesaplanmış metinleri ayarlamak için lifecycleOwner.lifecycleScope işlevinin nasıl kullanılacağı gösterilmektedir:

class MyFragment: Fragment() {
    override fun onViewCreated(view: View, savedInstanceState: Bundle?) {
        super.onViewCreated(view, savedInstanceState)
        viewLifecycleOwner.lifecycleScope.launch {
            val params = TextViewCompat.getTextMetricsParams(textView)
            val precomputedText = withContext(Dispatchers.Default) {
                PrecomputedTextCompat.create(longTextContent, params)
            }
            TextViewCompat.setPrecomputedText(textView, precomputedText)
        }
    }
}

LiveData KTX

LiveData'yı kullanırken değerleri eşzamansız olarak hesaplamanız gerekebilir. Örneğin, bir kullanıcının tercihlerini almak ve bunları kullanıcı arayüzünüze sunmak isteyebilirsiniz. Bu durumlarda LiveData KTX, suspend işlevini çağıran ve sonucu LiveData nesnesi olarak sunan bir liveData oluşturucu işlevi sağlar.

Bu modülü dahil etmek için aşağıdaki kodu uygulamanızın build.gradle dosyasına ekleyin:

GroovyKotlin
dependencies {
    implementation "androidx.lifecycle:lifecycle-livedata-ktx:2.8.7"
}
 
dependencies {
    implementation("androidx.lifecycle:lifecycle-livedata-ktx:2.8.7")
}

Aşağıdaki örnekte loadUser(), başka bir yerde tanımlanmış bir askıya alma işlevidir. loadUser() işlevini asenkron olarak çağırmak için liveData oluşturucu işlevini, ardından sonucu yayınlamak için emit() işlevini kullanabilirsiniz:

val user: LiveData<User> = liveData {
    val data = database.loadUser() // loadUser is a suspend function.
    emit(data)
}

LiveData ile eş yordamları kullanma hakkında daha fazla bilgi için Kotlin eş yordamlarını mimari bileşenleriyle kullanma başlıklı makaleyi inceleyin.

Gezinme kitaplığının her bileşeninin, API'yi daha kısa ve Kotlin diline uygun olacak şekilde uyarlayan kendi KTX sürümü vardır.

Bu modülleri dahil etmek için uygulamanızın build.gradle dosyasına aşağıdakileri ekleyin:

GroovyKotlin
dependencies {
    implementation "androidx.navigation:navigation-runtime-ktx:2.8.8"
    implementation "androidx.navigation:navigation-fragment-ktx:2.8.8"
    implementation "androidx.navigation:navigation-ui-ktx:2.8.8"
}
 
dependencies {
    implementation("androidx.navigation:navigation-runtime-ktx:2.8.8")
    implementation("androidx.navigation:navigation-fragment-ktx:2.8.8")
    implementation("androidx.navigation:navigation-ui-ktx:2.8.8")
}

Aşağıdaki örnekte gösterildiği gibi, hedef bağımsız değişkenlerine erişmek ve hedeflere gitmek için uzantı işlevlerini ve mülk yetkilendirmesini kullanın:

class MyDestination : Fragment() {

    // Type-safe arguments are accessed from the bundle.
    val args by navArgs<MyDestinationArgs>()

    ...
    override fun onViewCreated(view: View, savedInstanceState: Bundle?) {
        view.findViewById<Button>(R.id.next)
            .setOnClickListener {
                // Fragment extension added to retrieve a NavController from
                // any destination.
                findNavController().navigate(R.id.action_to_next_destination)
            }
     }
     ...

}

Palette KTX

Palette KTX modülü, renk paletleriyle çalışmak için doğal Kotlin desteği sunar.

Bu modülü kullanmak için uygulamanızın build.gradle dosyasına aşağıdakileri ekleyin:

GroovyKotlin
dependencies {
    implementation "androidx.palette:palette-ktx:1.0.0"
}
 
dependencies {
    implementation("androidx.palette:palette-ktx:1.0.0")
}

Örneğin, bir Palette örneğiyle çalışırken get operatörünü ([ ]) kullanarak belirli bir target için selected renk paletini alabilirsiniz:

val palette = Palette.from(bitmap).generate()
val swatch = palette[target]

Reactive Streams KTX

Reaktif Akışlar KTX modülü, ReactiveStreams yayıncısından gözlemlenebilir bir LiveData akışı oluşturmanıza olanak tanır.

Bu modülü dahil etmek için aşağıdaki kodu uygulamanızın build.gradle dosyasına ekleyin:

GroovyKotlin
dependencies {
    implementation "androidx.lifecycle:lifecycle-reactivestreams-ktx:2.8.7"
}
 
dependencies {
    implementation("androidx.lifecycle:lifecycle-reactivestreams-ktx:2.8.7")
}

Örneğin, az sayıda kullanıcı içeren bir veritabanını ele alalım. Uygulamanızda veritabanını belleğe yükler ve ardından kullanıcı verilerini kullanıcı arayüzünüzde gösterirsiniz. Bunun için RxJava'yı kullanabilirsiniz. Room Jetpack bileşeni, kullanıcı listesini Flowable olarak alabilir. Bu senaryoda, Rx yayıncı aboneliğini de parçanızın veya etkinliğinizin ömrü boyunca yönetmeniz gerekir.

Ancak LiveDataReactiveStreams ile, aşağıdaki örnekte gösterildiği gibi LiveData'un basitliğiyle çalışırken RxJava ve zengin operatör grubu ile iş planlama özelliklerinden yararlanabilirsiniz:

val fun getUsersLiveData() : LiveData<List<User>> {
    val users: Flowable<List<User>> = dao.findUsers()
    return LiveDataReactiveStreams.fromPublisher(users)
}

Room KTX

Room uzantıları, veritabanı işlemleri için coroutine desteği ekler.

Bu modülü kullanmak için uygulamanızın build.gradle dosyasına şunu ekleyin:

GroovyKotlin
dependencies {
    implementation "androidx.room:room-ktx:2.6.1"
}
 
dependencies {
    implementation("androidx.room:room-ktx:2.6.1")
}

Room'un artık coroutine'leri kullandığı birkaç örnek aşağıda verilmiştir. İlk örnek, User nesnelerinin bir listesini döndürmek için suspend işlevi kullanırken, ikinci örnek ise User listesini eşzamansız olarak döndürmek için Kotlin'in Flow işlevinden yararlanır. Flow kullanırken sorguladığınız tablolardaki değişikliklerden de haberdar edileceğinizi unutmayın.

@Query("SELECT * FROM Users")
suspend fun getUsers(): List<User>

@Query("SELECT * FROM Users")
fun getUsers(): Flow<List<User>>

SQLite KTX

SQLite uzantıları, SQL ile ilgili kodu işlemlere sarmalayarak çok sayıda standart koddan kurtulmanızı sağlar.

Bu modülü kullanmak için uygulamanızın build.gradle dosyasına şunu ekleyin:

GroovyKotlin
dependencies {
    implementation "androidx.sqlite:sqlite-ktx:2.4.0"
}
 
dependencies {
    implementation("androidx.sqlite:sqlite-ktx:2.4.0")
}

Veritabanı işlemi gerçekleştirmek için transaction uzantısının kullanıldığı bir örneği aşağıda bulabilirsiniz:

db.transaction {
    // insert data
}

ViewModel KTX

ViewModel KTX kitaplığı, ViewModel'inizden coroutine'leri başlatmayı kolaylaştıran bir viewModelScope() işlevi sağlar. CoroutineScope, Dispatchers.Main ağına bağlıdır ve ViewModel temizlendiğinde otomatik olarak iptal edilir. Her ViewModel için yeni bir kapsam oluşturmak yerine viewModelScope() kullanabilirsiniz.

Bu modülü dahil etmek için aşağıdaki kodu uygulamanızın build.gradle dosyasına ekleyin:

EskiKotlin
dependencies {
    implementation "androidx.lifecycle:lifecycle-viewmodel-ktx:2.8.5"
}
 
dependencies {
    implementation("androidx.lifecycle:lifecycle-viewmodel-ktx:2.8.5")
}

Örneğin, aşağıdaki viewModelScope() işlevi, arka plan iş parçacığında ağ isteği gönderen bir iş parçacığı başlatır. Kitaplık, tüm kurulum işlemlerini ve ilgili kapsam temizleme işlemlerini yönetir:

class MainViewModel : ViewModel() {
    // Make a network request without blocking the UI thread
    private fun makeNetworkRequest() {
        // launch a coroutine in viewModelScope
        viewModelScope.launch  {
            remoteApi.slowFetch()
            ...
        }
    }

    // No need to override onCleared()
}

WorkManager KTX

WorkManager KTX, iş parçacığı için birinci sınıf destek sağlar.

Bu modülü dahil etmek için uygulamanızın build.gradle dosyasına aşağıdakileri ekleyin:

GroovyKotlin
dependencies {
    implementation "androidx.work:work-runtime-ktx:2.10.0"
}
 
dependencies {
    implementation("androidx.work:work-runtime-ktx:2.10.0")
}

Artık Worker yerine, API'si biraz farklı olan CoroutineWorker'i genişletebilirsiniz. Örneğin, bazı ağ işlemlerini gerçekleştirmek için basit bir CoroutineWorker oluşturmak istiyorsanız aşağıdakileri yapabilirsiniz:

class CoroutineDownloadWorker(context: Context, params: WorkerParameters)
        : CoroutineWorker(context, params) {

    override suspend fun doWork(): Result = coroutineScope {
        val jobs = (0 until 100).map {
            async {
                downloadSynchronously("https://www.google.com")
            }
        }

        // awaitAll will throw an exception if a download fails, which
        // CoroutineWorker will treat as a failure
        jobs.awaitAll()
        Result.success()
    }
}

CoroutineWorker kullanma hakkında daha fazla bilgi için CoroutineWorker'da iş parçacığı oluşturma başlıklı makaleyi inceleyin.

WorkManager KTX, mevcut iş parçacığının askıya alınması için Operations ve ListenableFutures işlevlerine de uzantı işlevleri ekler.

enqueue() tarafından döndürülen Operation öğesini askıya alan bir örnek aşağıda verilmiştir:

// Inside of a coroutine...

// Run async operation and suspend until completed.
WorkManager.getInstance()
        .beginWith(longWorkRequest)
        .enqueue().await()

// Resume after work completes...

Diğer KTX modülleri

AndroidX dışındaki ek KTX modüllerini de ekleyebilirsiniz.

Firebase KTX

Android için Firebase SDK'larından bazıları, uygulamanızda Firebase kullanırken deyimsel Kotlin kodu yazmanıza olanak tanıyan Kotlin uzantı kitaplıklarına sahiptir. Daha fazla bilgi için aşağıdaki konuları inceleyin:

Google Haritalar Platformu KTX

Google Haritalar Platformu Android SDK'ları için uzantı işlevleri, adlandırılmış parametreler ve varsayılan bağımsız değişkenler, yapı bozma bildirimleri ve iş parçacıkları gibi çeşitli Kotlin dil özelliklerinden yararlanmanıza olanak tanıyan KTX uzantıları mevcuttur. Daha fazla bilgi için aşağıdaki konulara bakın:

Play Core KTX

Play Core KTX, Play Core kitaplığındaki SplitInstallManager ve AppUpdateManager işlevlerine uzantı işlevleri ekleyerek tek seferlik istekler için Kotlin coroutine'leri ve durum güncellemelerini izlemek için Flow'u destekler.

Bu modülü dahil etmek için uygulamanızın build.gradle dosyasına aşağıdakileri ekleyin:

GroovyKotlin
dependencies {
    implementation "com.google.android.play:core-ktx:1.8.1"
}
 
dependencies {
    implementation("com.google.android.play:core-ktx:1.8.1")
}

Durum izleme Flow örneğini aşağıda görebilirsiniz:

// Inside of a coroutine...

// Request in-app update status updates.
manager.requestUpdateFlow().collect { updateResult ->
    when (updateResult) {
        is AppUpdateResult.Available -> TODO()
        is AppUpdateResult.InProgress -> TODO()
        is AppUpdateResult.Downloaded -> TODO()
        AppUpdateResult.NotAvailable -> TODO()
    }
}

Daha fazla bilgi

Android KTX hakkında daha fazla bilgi edinmek için DevBytes videosunu izleyin.

Sorun bildirmek veya özellik önerisinde bulunmak için Android KTX sorun izleyicisini kullanın.