這個獨立的 Jetifier 工具會將支援資料庫依附元件的程式庫遷移至 請改用對等的 AndroidX 套件。這項工具能讓您 使用個別程式庫，而非使用 Android Gradle 外掛程式套裝組合 Android Studio 的實用工具
安裝 Jetifier
如要安裝 Jetifier，請下載 ZIP 檔案並解壓縮。您的裝置必須已安裝 Java 1.8 以上版本。
用量
如要處理程式庫，請傳遞目前的程式庫路徑和工具應建立的輸出檔案路徑。Jetifier 支援 JAR、AAR 和 ZIP 檔案，包括巢狀封存檔案。
./jetifier-standalone -i <source-library> -o <output-library>
選項
下表列出了 Jetifier 工具指令的可用選項：
| 選項 | 是否必需提供？ | 說明 |
|---|---|---|
--input-i<path> |
是 | 輸入程式庫的路徑 (JAR、AAR 或 ZIP)。 |
-o <path> (程度：--output)
|
好啊 | 輸出檔案的路徑。如果檔案 但 Jetifier 會覆寫該值。 |
--config-c<path> |
不 | 選用自訂設定檔的路徑。 |
-l <level> (程度：--log)
|
否 | 記錄層級。允許的值包括：
|
-r |
不 | 以反向模式執行 (「de-jetification」)。 |
-rebuildTopOfTree,--rebuildTopOfTree |
否 | 根據
產生的 POM 檔案。 如果已設定，所有重寫程式庫 皆假設為支援資料庫的一部分。Jetification 不需要。 |
-s、--strict
|
否 | 缺少規則時不會進行備用；擲回錯誤 。 |
-stripSignatures,--stripSignatures
|
否 | 如出現以下情況，請勿擲回錯誤： 建構已簽署的程式庫。移除簽名檔案 。 |
-t <arg> (程度：-timestamp)
|
否 | 時間戳記政策 修改已封存的項目。值：keepPrevious (預設) 也就是 Epoch 時間。 |
範例
下列範例會在 libraryToProcess.aar 的程式庫 libraryToProcess.aar 中執行公用程式。
並將輸出內容寫入同一個目錄下的 result.aar
目錄：
./jetifier-standalone -i libraryToProcess.aar -o result.aar
使用須知
Jetifier 會遷移指向該參照的 Java、XML、POM 和 ProGuard 參照
android.support.* 套件，變更這些套件，使其指向對應的
androidx.* 個套件。
由於 android.support.* 的 ProGuard 萬用字元不一定能直接對應至
androidx.* 套件，Jetifier 會產生所有符合資格的替代項目。
如果 android.support.* 套件中的類型並非來自任何來源
支援資料庫構件，只要該類型存在，Jetifier 仍會遷移該類型
對應的網路不過，系統無法保證這項遷移作業正常運作，因為對應關係可能不夠全面，無法涵蓋所有自訂類型。
進階用法
Jetifier 公用程式可支援部分進階用途。
反向模式
如果您傳遞 -r 標記，公用程式就會以「反向模式」執行。在這個模式下，
公用程式會將 AndroidX API 轉換為支援資料庫中的對等項目。反向模式
以負責任的方式
使用 AndroidX API 但也需要發布
支援資料庫
範例
下列範例會在程式庫中以反向模式執行公用程式
目前目錄中的 myAndroidXLib.aar，並將輸出內容寫入
位於相同目錄中的 supportLibVersion.aar：
./jetifier-standalone -r -i myAndroidXLib.aar -o supportLibVersion.aar
自訂設定檔
Jetifier 工具會使用設定檔，將支援資料庫類別對應至其 AndroidX 同等項目。如有需要，您可以建立自訂設定檔來調整對應作業。您甚至可以在對應中加入尚未建立的類別 但支援資料庫的成員舉例來說，您可以將 ，以撰寫使用的後繼類別取代自有類別 AndroidX。
如要使用自訂的設定檔：
- 從公用程式的
default.generated.configjetifier-core-*.jar檔案並儲存。 - 對設定檔副本進行必要的編輯。
- 將檔案傳遞到具有
-c旗標的公用程式。
例如：
./jetifier-standalone -i libraryToProcess.aar -o result.aar -c myCustomMapping.config