Düzleştirici

Bağımsız Jetifier aracı, eş değer AndroidX paketlerini temel almak için destek kitaplığına bağlı kitaplıkları taşır. Araç, Android Studio ile birlikte sunulan Android Gradle eklentisini kullanmak yerine doğrudan bağımsız bir kitaplığı taşımanıza olanak tanır.

Jetifier'ı yükle

Jetifier'ı yüklemek için zip dosyasını indirin ve çıkarın. Cihazınızda Java 1.8 veya sonraki bir sürümü yüklü olmalıdır.

Kullanım

Bir kitaplığı işlemek için geçerli kitaplığın yolunu ve aracın oluşturması gereken çıkış dosyasının yolunu iletin. Jetifier, iç içe yerleştirilmiş arşivler dahil olmak üzere JAR, AAR ve ZIP dosyalarını destekler.

./jetifier-standalone -i <source-library> -o <output-library>

Seçenekler

Aşağıdaki tabloda Jetifier aracı komutları için kullanılabilen seçenekler listelenmiştir:

Option Zorunlu mu? Açıklama
<path> --input -i evet Giriş kitaplığının yolu (JAR, AAR veya ZIP).
<path> --output -o evet Çıkış dosyasının yolu. Dosya zaten mevcutsa Jetifier dosyanın üzerine yazar.
<path> --config -c hayır İsteğe bağlı özel yapılandırma dosyasının yolu.
<level> --log -l hayır Günlük kaydı düzeyi. İzin verilen değerler şunlardır:
  • hatası
  • uyarı
  • bilgi
  • ayrıntılı
Belirtilmezse varsayılan olarak "uyarı" olur.
-r hayır Ters modda ("jetification") çalışır.
-rebuildTopOfTree,
--rebuildTopOfTree 		hayır Oluşturulan POM dosyasına göre Maven dağıtımının ZIP dosyasını yeniden oluşturun.
Ayarlanırsa yeniden yazılan tüm kitaplıkların Destek Kitaplığı'nın bir parçası olduğu varsayılır. Püskürtme için gerekli değildir.
-s, --strict hayır Kurallar eksik olduğunda yedek oluşturmayın; bunun yerine hatalar bildirin.
-stripSignatures,
--stripSignatures 		hayır İmzalanmış bir kitaplığa geçiş yaparken hata vermeyin; bunun yerine imza dosyalarını çıkarın.
<arg> -timestamp -t hayır Arşivlenmiş girişler için değiştirilme zamanı olarak kullanılacak zaman damgası politikası. Değerler: keepPrevious (varsayılan) dönemi veya şimdi.

Örnek

Aşağıdaki örnek, geçerli dizindeki libraryToProcess.aar kitaplığında bulunan yardımcı programı çalıştırır ve çıkışı aynı dizinde result.aar dosyasına yazar:

./jetifier-standalone -i libraryToProcess.aar -o result.aar

Kullanım notları

Jetifier, android.support.* paketlerine işaret eden Java, XML, POM ve ProGuard referanslarını taşır ve bunları, karşılık gelen androidx.* paketlerini işaret edecek şekilde değiştirir.

android.support.* için ProGuard joker karakterleri her zaman doğrudan androidx.* paketleriyle eşlenmediğinden Jetifier uygun tüm değişiklikleri oluşturur.

android.support.* paketinde herhangi bir Destek Kitaplığı yapısından gelmeyen bir tür varsa Jetifier, eşleme olduğu sürece türü taşımaya devam eder. Ancak tüm özel türleri kapsayacak kadar genel eşleme kuralları olmayabileceğinden bu taşıma işleminin gerçekleşeceği garanti edilmez.

İleri düzey kullanım

Jetifier yardımcı programı bazı gelişmiş kullanım alanlarını destekler.

Ters mod

-r işaretini geçerseniz yardımcı program ters modda çalışır. Bu modda yardımcı program, AndroidX API'lerini Destek Kitaplığı eşdeğerlerine dönüştürür. Ters modu, AndroidX API'lerini kullanan kitaplıklar geliştiriyorsanız ancak Destek Kitaplığı'nı kullanan sürümleri dağıtmanız da gerekiyorsa kullanışlıdır.

Örnek

Aşağıdaki örnek, yardımcı programı geçerli dizindeki myAndroidXLib.aar kitaplığında ters modda çalıştırır ve çıkışı aynı dizindeki supportLibVersion.aar öğesine yazar:

./jetifier-standalone -r -i myAndroidXLib.aar -o supportLibVersion.aar

Özel yapılandırma dosyası

Jetifier aracı, Destek Kitaplığı sınıflarını AndroidX eşdeğerleriyle eşlemek için bir yapılandırma dosyası kullanır. Gerekirse bu eşlemeyi değiştiren özel bir yapılandırma dosyası oluşturabilirsiniz. Hatta eşlemeye, aslında Destek Kitaplığı'nın üyesi olmayan yeni sınıflar da ekleyebilirsiniz. Örneğin, eşlemeyi değiştirerek kendi sınıflarınızdan birini, AndroidX kullanmak için yazılmış sonraki sınıfla değiştirebilirsiniz.

Özel yapılandırma dosyası kullanmak için:

  1. default.generated.config dosyasını yardımcı programın jetifier-core-*.jar dosyasından çıkarın ve kaydedin.
  2. Yapılandırma dosyası kopyanızda gerekli düzenlemeleri yapın.
  3. Dosyanızı -c işaretiyle yardımcı programa iletin.

Örneğin:

./jetifier-standalone -i libraryToProcess.aar -o result.aar -c myCustomMapping.config