Android kitaplığı oluşturma

Android kitaplıkları, yapısal olarak Android uygulama modülleriyle aynıdır. Kaynak kod, kaynak dosyalar ve Android manifesti dahil olmak üzere uygulama oluşturmak için gereken her şeyi içerir.

Ancak Android kitaplığı, cihazda çalışan bir APK'yı derlemek yerine Android uygulama modülünde bağımlılık olarak kullanabileceğiniz bir Android Arşivi (AAR) dosyası olarak derler. JAR dosyalarının aksine, AAR dosyaları Android uygulamaları için aşağıdaki işlevleri sunar:

• AAR dosyaları Android kaynakları ve bir manifest dosyası içerebilir. Bu dosyalar, Kotlin veya Java sınıf ve yöntemlerine ek olarak düzenler ve çizilebilir öğeler gibi paylaşılan kaynakları da paketlemenize olanak tanır.
• AAR dosyaları, uygulama modülünün C/C++ kodu tarafından kullanılacak C/C++ kitaplıkları içerebilir.

Kitaplık modülü aşağıdaki durumlarda yararlıdır:

• Etkinlikler, hizmetler veya kullanıcı arayüzü düzenleri gibi bazı ortak bileşenleri kullanan birden fazla uygulama oluştururken
• Temel bileşenleri paylaşan birden fazla APK varyantında (ör. ücretsiz ve ücretli sürüm) bulunan bir uygulama oluştururken

Her iki durumda da, yeniden kullanmak istediğiniz dosyaları bir kitaplık modülüne taşıyın ve ardından kitaplığı her uygulama modülü için bağımlılık olarak ekleyin.

Bu sayfada, Android kitaplık modülünün nasıl oluşturulacağı ve kullanılacağı açıklanmaktadır. Bir kitaplığın nasıl yayınlanacağı hakkında yardım için Kitaplığınızı yayınlama bölümüne bakın

Kitaplık modülü oluşturma

Projenizde yeni bir kitaplık modülü oluşturmak için aşağıdaki adımları uygulayın:

1. Dosya > Yeni > Yeni Modül'ü tıklayın.
2. Görüntülenen Yeni Modül Oluştur iletişim kutusunda Android Kitaplığı'nı, ardından İleri'yi tıklayın.

   Geleneksel JAR dosyası oluşturan bir Kotlin veya Java kitaplığı oluşturma seçeneği de vardır. JAR dosyaları birçok proje için faydalıdır (özellikle de kodları diğer platformlarla paylaşmak istediğinizde). Ancak Android projelerinde kodları yeniden kullanmak için çok faydalı olan Android kaynaklarını veya manifest dosyalarını eklemenize izin vermez. Bu kılavuzda Android kitaplıkları oluşturma üzerinde durulur.

3. Kitaplığınıza bir ad verin ve kitaplıktaki kod için minimum SDK sürümünü seçin, ardından Son'u tıklayın.

Gradle proje senkronizasyonu tamamlandığında kitaplık modülü Proje bölmesinde görünür. Yeni modül klasörünü görmüyorsanız bölmede Android görünümünün gösterildiğinden emin olun.

Uygulama modülünü kitaplık modülüne dönüştürme

Yeniden kullanmak istediğiniz kod içeren mevcut bir uygulama modülünüz varsa bunu aşağıdaki şekilde bir kitaplık modülüne dönüştürebilirsiniz:

1. Groovy kullanıyorsanız modül düzeyindeki build.gradle dosyasını, Kotlin komut dosyası kullanıyorsanız build.gradle.kts dosyasını açın.
2. applicationId satırını silin. Bunu yalnızca bir Android uygulama modülü tanımlayabilir.
3. Dosyanın üst kısmındaki şuna benzeyen "plugins" bloğunu bulun:

   Groovy

     plugins {
         id 'com.android.application'
     }
     

   Kotlin

     plugins {
         id("com.android.application")
     }
     

   Aşağıdaki şekilde değiştirin:

   Groovy

     plugins {
         id 'com.android.library'
     }
     

   Kotlin

     plugins {
         id("com.android.library")
     }
     

4. Dosyayı kaydedip Dosya > Projeyi Gradle Dosyalarıyla Senkronize Et'i tıklayın.

Modülün yapısı aynı kalır ancak artık Android kitaplığı olarak çalışır. Derleme, APK yerine AAR dosyası oluşturur.

AAR dosyasını derlemek istediğinizde Proje penceresinde kitaplık modülünü seçin ve Derle > APK Oluştur'u tıklayın.

Proje Yapısı iletişim kutusuyla bağımlılık ekleme

Projenize bağımlılık eklemek için Proje Yapısı iletişim kutusunu kullanabilirsiniz. Aşağıdaki bölümlerde, bağımlılıkları eklemek için iletişim kutusunun nasıl kullanılacağı açıklanmaktadır.

Kitaplığınızı aynı proje içinden kullanma

Yeni Android kitaplığınızın kodunu aynı projedeki başka bir uygulama veya kitaplık modülünde kullanmak için proje düzeyinde bağımlılık ekleyin:

1. Dosya > Proje Yapısı > Bağımlılıklar'a gidin.
2. Kitaplığı eklemek istediğiniz modülü seçin.
3. Tanımlanan Bağımlılıklar sekmesinde simgesini tıklayın ve menüden Modül Bağımlılığı'nı seçin.
   
   

4. Modül Bağımlılığı Ekle iletişim kutusunda kitaplık modülünüzü seçin.

   

5. Bu bağımlılığı gerektiren yapılandırmayı seçin veya tüm yapılandırmalar için geçerliyse uygulamayı seçin, ardından Tamam'ı tıklayın.

Android Studio, bağımlılığı eklemek için modülünüzün build.gradle veya build.gradle.kts dosyasını aşağıdaki biçimde düzenler:

  implementation project(path: ":example-library")

  implementation(project(":example-library"))

Kitaplığınızı başka projelerde kullanma

Bağımlılıkları (JAR ve AAR) paylaşmanın önerilen yolu, Maven Central gibi bir hizmette barındırılan bir Maven deposu veya yerel diskinizdeki bir dizin yapısıdır. Maven depolarını kullanma hakkında daha fazla bilgi için Remote depoları'na bakın.

Bir Android kitaplığı Maven deposunda yayınlandığında, kitaplığın bağımlılarının kitaplığı kullanan derlemeye dahil edilmesi için meta veriler eklenir. Bu, kitaplığın birden fazla yerde kullanılması durumunda otomatik olarak tekilleştirilmesini sağlar.

Android kitaplığınızdaki kodu farklı bir projedeki başka bir uygulama modülünde kullanmak için aşağıdaki adımları uygulayın:

1. Dosya > Proje Yapısı > Bağımlılıklar'a gidin.
2. Tanımlanan Bağımlılıklar sekmesinde simgesini tıklayın ve menüden Kitaplık Bağımlılığı'nı seçin.
   
   

3. Kitaplık Bağımlılığı Ekle iletişim kutusunda, eklemek istediğiniz kitaplığı bulmak için arama kutusunu kullanın. Bu form, settings.gradle veya settings.gradle.kts dosyasında dependencyResolutionManagement { repositories {...}} bloğunda belirtilen depoları arar.

   

4. Bu bağımlılığı gerektiren yapılandırmayı seçin veya tüm yapılandırmalar için geçerliyse uygulamayı seçin, ardından Tamam'ı tıklayın.

Aşağıdakine benzer bir beyanın göründüğünü onaylamak için uygulamanızın build.gradle veya build.gradle.kts dosyasını kontrol edin (seçtiğiniz derleme yapılandırmasına bağlı olarak):

  implementation 'com.example:examplelibrary:1.0.0'

  implementation("com.example:examplelibrary:1.0.0")

AAR veya JAR dosyanızı bağımlılık olarak ekleme

Android kitaplığınızdaki kodu başka bir uygulama modülünde kullanmak için aşağıdaki adımları uygulayın:

1. Dosya > Proje Yapısı > Bağımlılıklar'a gidin.
2. Beyan Edilen Bağımlılıklar sekmesinde simgesini tıklayın ve menüden Jar Bağımlılığı'nı seçin.
   
   

3. Jar/Aar Bağımlılığı Ekle iletişim kutusunda AAR veya JAR dosyanızın yolunu girin, ardından bağımlılığın geçerli olduğu yapılandırmayı seçin. Kitaplığın tüm yapılandırmalarda kullanılabilmesi gerekiyorsa uygulama yapılandırmasını seçin.

   

   Aşağıdakine benzer bir beyanın göründüğünü onaylamak için uygulamanızın build.gradle veya build.gradle.kts dosyasını kontrol edin (seçtiğiniz derleme yapılandırmasına bağlı olarak):

   Groovy

     implementation files('my_path/my_lib.aar')

   Kotlin

     implementation(files("my_path/my_lib.aar"))

Android Studio dışında çalışan Gradle derlemesine bir bağımlılık içe aktarmak için uygulamanızın build.gradle veya build.gradle.kts dosyasına bağımlılık yolunu ekleyin. Örnek:

dependencies {
    implementation fileTree(dir: "libs", include: ["*.jar", "*.aar"])
}

dependencies {
    implementation(fileTree(mapOf("dir" to "libs", "include" to listOf("*.jar", "*.aar"))))
}

Gradle bağımlılıkları ekleme hakkında daha fazla bilgi için Derleme bağımlılıkları ekleme bölümüne bakın.

Herkese açık bir kaynak beyan etme

Kaynaklar, projenizin res/ dizinindeki tüm dosyaları (ör. resimler) içerir. Kitaplıktaki tüm kaynaklar varsayılan olarak herkese açıktır. Tüm kaynakları dolaylı olarak özel yapmak için en az bir özelliği herkese açık olarak tanımlamanız gerekir.

Herkese açık bir kaynağı bildirmek için kitaplığınızın public.xml dosyasına bir <public> beyanı ekleyin. Daha önce herkese açık kaynak eklemediyseniz kitaplığınızın res/values/ dizininde public.xml dosyasını oluşturmanız gerekir.

Aşağıdaki örnek kod, mylib_app_name ve mylib_public_string adlarıyla iki herkese açık dize kaynağı oluşturur:

<resources>
    <public name="mylib_app_name" type="string"/>
    <public name="mylib_public_string" type="string"/>
</resources>

Kitaplığınızdaki kullanıcıların yalnızca şirket içinde kullanılmak üzere tasarlanmış kaynaklara erişmesini önlemek için bir veya daha fazla herkese açık kaynak tanımlayarak bu otomatik gizlilik atama mekanizmasını kullanın. Alternatif olarak, boş bir <public /> etiketi ekleyerek tüm kaynakları gizli hale getirebilirsiniz. Bu işlem hiçbir şeyi herkese açık olarak işaretlemez ve tüm kaynakları özel yapar.

Kitaplığınızı kullanan geliştiricilerin görmesini istediğiniz tüm kaynaklar herkese açık olmalıdır.

Özellikleri örtülü olarak gizli hale getirmek, kitaplığınızdaki kullanıcıların dahili kitaplık kaynaklarından kod tamamlama önerileri almasını engeller ve kullanıcıların kitaplığınızdaki istemcileri bozmadan özel kaynakları yeniden adlandırmasına veya kaldırmasına olanak tanır. Gizli kaynaklar kod tamamlama işleminde filtrelenir ve gizli bir kaynağa referans vermeye çalıştığınızda lint aracı sizi uyarır.

Android Gradle eklentisi, kitaplık oluştururken herkese açık kaynak tanımlarını alır ve bunları public.txt dosyasına çıkarır. Bu dosya daha sonra AAR dosyasına paketlenir.

Kitaplık modülleri için geliştirmeyle ilgili dikkat edilmesi gereken noktalar

Kitaplık modüllerinizi ve bağımlı uygulamalarınızı geliştirirken aşağıdaki davranışlara ve sınırlamalara dikkat edin.

• Kitaplıklar öncelik sırasına göre birleştirilir.

  Android uygulama modülünüze kitaplık modüllerine referanslar ekledikten sonra, bunların göreli önceliklerini ayarlayabilirsiniz. Derleme sırasında, öncelik sırasına göre en düşükten en yükseğe doğru kütüphaneler uygulamayla tek tek birleştirilir.

• Kaynak birleştirme çakışmalarını önleyin.

  Derleme araçları, bir kitaplık modülündeki kaynakları bağımlı bir uygulama modülündeki kaynaklarla birleştirir. Belirli bir kaynak kimliği her iki modülde de tanımlanmışsa uygulamadaki kaynak kullanılır.

  Birden fazla AAR kitaplığı arasında çakışma meydana gelirse bağımlılık listesinde ilk listelenen kitaplıktaki (dependencies bloğunun en üstüne en yakın olan) kaynak kullanılır.

  Kaynak çakışmalarını önlemek için geçişli olmayan sınıflar kullanın.R Bu mümkün değilse ön ek veya modüle özgü (veya tüm proje modülleri arasında benzersiz) başka bir tutarlı adlandırma şeması kullanmayı düşünün.

• Çok modüllü derlemelerde JAR bağımlılıkları geçişli bağımlılıklar olarak kabul edilir.

  AAR çıkışı veren bir kitaplık projesine JAR bağımlılığı eklediğinizde JAR, kitaplık modülü tarafından işlenir ve AAR ile birlikte paketlenir.

  Ancak projenizde bir uygulama modülü tarafından kullanılan bir kitaplık modülü varsa uygulama modülü, kitaplığın yerel JAR bağımlılığını geçişli bağımlılık olarak değerlendirir. Bu durumda yerel JAR, kütüphane modülü tarafından değil, onu kullanan uygulama modülü tarafından işlenir. Bu, kitaplığın kodunda yapılan değişikliklerden kaynaklanan artımlı derlemeleri hızlandırır.

  Yerel JAR bağımlılıklarından kaynaklanan Java kaynak çakışmaları, kitaplığı kullanan uygulama modülünde çözülmesi gerekir.

• Kitaplık modülü, harici bir JAR kitaplığına bağlı olabilir.

  Harici bir kitaplığa bağımlı bir kitaplık modülü geliştirebilirsiniz. Bu durumda, bağımlı modülün harici kitaplığı içeren bir hedefe göre derlemesi gerekir.

  Hem kitaplık modülünün hem de bağımlı uygulamanın manifest dosyalarında harici kitaplığı bir <uses-library> öğesinde tanımlaması gerektiğini unutmayın.

• Uygulama modülünün minSdkVersion değeri, kitaplıkta tanımlanan sürümle aynı veya bu sürümden daha yüksek olmalıdır.

  Kitaplıklar, bağımlı uygulama modülünün bir parçası olarak derlenir. Bu nedenle, kitaplık modülünde kullanılan API'ler, uygulama modülünün desteklediği platform sürümüyle uyumlu olmalıdır.

• Her kitaplık modülü kendi R sınıfını oluşturur.

  Bağımlı uygulama modüllerini derlediğinizde kitaplık modülleri, bir AAR dosyası olarak derlenir ve ardından uygulama modülüne eklenir. Bu nedenle, her kitaplığın paket adına göre adlandırılmış kendi R sınıfı vardır.

  Ana modül ve kitaplık modülünden oluşturulan R sınıfı, ana modülün paketi ve kitaplıkların paketleri de dahil olmak üzere gereken tüm paketlerde oluşturulur.

• Bir kitaplık modülü kendi ProGuard yapılandırma dosyasını içerebilir.

  AAR derlemek ve yayınlamak için kullandığınız bir kitaplık projeniz varsa kitaplığınızın derleme yapılandırmasına ProGuard yapılandırma dosyası ekleyebilirsiniz. Bu durumda Android Gradle eklentisi, belirttiğiniz ProGuard kurallarını uygular. Derleme araçları bu dosyayı kitaplık modülü için oluşturulan AAR dosyasına yerleştirir. Kitaplığı bir uygulama modülüne eklediğinizde kitaplığın ProGuard dosyası, uygulama modülünün ProGuard yapılandırma dosyasına (proguard.txt) eklenir.

  Kitaplık modülünüze bir ProGuard dosyası yerleştirerek, kitaplığınıza bağımlı uygulama modüllerinin kitaplığınızı kullanmak için ProGuard dosyalarını manuel olarak güncellemesi gerekmediğinden emin olursunuz. Android Studio derleme sistemi uygulamanızı oluştururken hem uygulama modülündeki hem de kitaplıktaki yönergeleri kullanır. Bu nedenle, kitaplıkta ayrı bir adımda kod daraltıcı çalıştırmanız gerekmez.

  ProGuard kurallarını kitaplık projenize eklemek için dosyanın adını, kitaplığınızın build.gradle veya build.gradle.kts dosyasının defaultConfig bloğundaki consumerProguardFiles özelliğiyle belirtin.

  Örneğin, aşağıdaki snippet'te lib-proguard-rules.txt, kitaplığın ProGuard yapılandırma dosyası olarak ayarlanmıştır:

  Groovy

  android {
      defaultConfig {
          consumerProguardFiles 'lib-proguard-rules.txt'
      }
      ...
  }

  Kotlin

  android {
      defaultConfig {
          consumerProguardFiles("lib-proguard-rules.txt")
      }
      ...
  }

  Ancak kitaplık modülünüz, APK olarak derlenen ve AAR oluşturmayan çok modüllü bir derlemenin parçasıysa yalnızca kitaplığı kullanan uygulama modülünde kod küçültme işlemini çalıştırın. ProGuard kuralları ve kullanımları hakkında daha fazla bilgi edinmek için Uygulamanızı küçültme, karartma ve optimize etme başlıklı makaleyi okuyun.

• Kitaplık modülünün test edilmesi uygulamanın test edilmesiyle neredeyse aynıdır.

  Temel fark, kitaplığın ve bağımlılıklarının test APK'sının bağımlılıklarına otomatik olarak dahil edilmesidir. Bu, test APK'sının yalnızca kendi kodunu değil, kitaplığın AAR'ını ve tüm bağımlılıklarını da içerdiği anlamına gelir. Test altında ayrı bir uygulama olmadığından androidTest görevi yalnızca test APK'sını yükler (ve kaldırır).

  Birden fazla manifest dosyasını birleştirirken Gradle, varsayılan öncelik sırasını uygular ve kitaplığın manifestini test APK'sının ana manifestiyle birleştirir.

AAR dosyasının anatomisi

AAR dosyasının dosya uzantısı .aar, Maven yapı türü de aar'dur. Dosya bir ZIP dosyasıdır. Yalnızca /AndroidManifest.xml girişi zorunludur.

Bir AAR dosyası aşağıdaki isteğe bağlı girişlerden birini veya daha fazlasını da içerebilir:

• /classes.jar
• /res/
• /R.txt
• /public.txt
• /assets/
• /libs/name.jar
• /jni/abi_name/name.so (burada abi_name, Android tarafından desteklenen ABI'lerden biridir)
• /proguard.txt
• /lint.jar
• /api.jar
• Yerel kitaplıkları dışa aktarmak için /prefab/