Jetifier

Das eigenständige Jetifier-Tool migriert von der Supportbibliothek abhängige Bibliotheken nutzen die entsprechenden AndroidX-Pakete. Mit diesem Tool können Sie und zwar direkt einzeln, anstatt das gebündelte Android-Gradle-Plug-in zu verwenden. mit Android Studio.

Jetifier installieren

Laden Sie zur Installation von Jetifier die ZIP-Datei herunter. Datei und extrahieren sie. Auf Ihrem Gerät muss die Java-Version 1.8 oder höher installiert sein.

Nutzung

Um eine Bibliothek zu verarbeiten, übergeben Sie den Pfad zur aktuellen Bibliothek und den Pfad zur Ausgabedatei, die das Tool erstellen sollte. Jetifier unterstützt JAR, AAR und ZIP einschließlich verschachtelter Archive.

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

Optionen

In der folgenden Tabelle sind die verfügbaren Optionen für die Befehle des Jetifier-Tools aufgeführt:

Option Erforderlich? Beschreibung
-i, --input <path> Ja Pfad zur Eingabebibliothek (JAR, AAR oder ZIP).
-o, --output <path> Ja Pfad zur Ausgabedatei. Wenn die Datei bereits vorhanden ist, wird sie von Jetifier überschrieben.
-c, --config <path> Nein Pfad zur optionalen benutzerdefinierten Konfigurationsdatei.
-l, --log <level> Nein Protokollierungsebene. Zulässige Werte: <ph type="x-smartling-placeholder">
    </ph>
  • Fehler
  • Warnung
  • Infos
  • ausführlich
Wenn keine Angabe erfolgt, wird standardmäßig „warning“ verwendet.
-r Nein im Rückwärtsmodus („Entstrahlung“) arbeiten.
-rebuildTopOfTree,
--rebuildTopOfTree 		Nein Erstellen Sie die ZIP-Datei der Maven-Distribution gemäß die POM-Datei generiert hat.
Wenn festgelegt, werden alle umgeschriebenen Bibliotheken Es wird davon ausgegangen, dass sie Teil der Support Library sind. Für die Jetification nicht erforderlich.
-s, --strict Nein Verwenden Sie kein Fallback, wenn Regeln fehlen. Fehler ausgeben .
-stripSignatures,
--stripSignatures 		Nein Geben Sie keinen Fehler aus, Versendung einer signierten Bibliothek Signaturdateien entfernen .
-t, -timestamp <arg> Nein Zeitstempelrichtlinie für die Archivierte Einträge mit dem geänderten Zeitpunkt. Werte: keepPrevious (Standard) oder jetzt.

Beispiel

Im folgenden Beispiel wird das Dienstprogramm für die Bibliothek libraryToProcess.aar in das aktuelle Verzeichnis und schreibt die Ausgabe in result.aar Verzeichnis:

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

Verwendungshinweise

Jetifier migriert Java-, XML-, POM- und ProGuard-Referenzen, die auf android.support.* Pakete. Ändern Sie sie so, dass sie auf das entsprechende androidx.* Paket.

Da ProGuard-Platzhalter für android.support.* nicht immer direkt androidx.*-Paketen erstellt Jetifier alle geeigneten Substitutionen.

Wenn es in einem android.support.*-Paket einen Typ gibt, der nicht aus Support Library-Artefakt migriert, dass Jetifier den Typ weiterhin migriert, solange eine eine entsprechende Zuordnung erstellen. Es ist jedoch nicht garantiert, dass diese Migration funktioniert, da sind die Zuordnungsregeln möglicherweise nicht allgemein genug, um alle benutzerdefinierten Typen abzudecken.

Erweiterte Nutzung

Das Jetifier-Dienstprogramm unterstützt einige komplexere Anwendungsfälle.

Modus umkehren

Wenn Sie das Flag -r übergeben, wird das Dienstprogramm im umgekehrten Modus ausgeführt. In diesem Modus AndroidX-APIs in die entsprechenden Support Library-Entsprechungen konvertiert. Modus umkehren ist nützlich, wenn Sie Bibliotheken, die AndroidX APIs verwenden, aber auch Versionen verteilen müssen, Supportbibliothek.

Beispiel

Im folgenden Beispiel wird das Dienstprogramm im umgekehrten Modus für die Bibliothek ausgeführt. myAndroidXLib.aar im aktuellen Verzeichnis und schreibt die Ausgabe in supportLibVersion.aar im selben Verzeichnis:

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

Benutzerdefinierte Konfigurationsdatei

Das Jetifier-Tool verwendet eine Konfigurationsdatei, um Support Library-Klassen ihren AndroidX-Entsprechungen. Bei Bedarf können Sie eine benutzerdefinierte Konfigurationsdatei erstellen, diese Zuordnung verändert. Sie können der Zuordnung sogar neue Klassen hinzufügen, tatsächlich Mitglieder der Supportbibliothek. Sie können beispielsweise die Zuordnung, um eine Ihrer eigenen Klassen durch eine zu verwendende Nachfolgeklasse zu ersetzen AndroidX

So verwenden Sie eine benutzerdefinierte Konfigurationsdatei:

  1. Extrahieren Sie die Datei default.generated.config aus dem jetifier-core-*.jar-Datei und speichern Sie sie.
  2. Nehmen Sie die erforderlichen Änderungen an Ihrer Kopie der Konfigurationsdatei vor.
  3. Übergeben Sie Ihre Datei mit dem Flag -c an das Dienstprogramm.

Beispiel:

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