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:
|
-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:
default.generated.config
dosyasını yardımcı programınjetifier-core-*.jar
dosyasından çıkarın ve kaydedin.- Yapılandırma dosyası kopyanızda gerekli düzenlemeleri yapın.
- Dosyanızı
-c
işaretiyle yardımcı programa iletin.
Örneğin:
./jetifier-standalone -i libraryToProcess.aar -o result.aar -c myCustomMapping.config