ProfileInstaller
Letzte Aktualisierung | Stabile Version | Releasekandidat | Beta-Ausgabe | Alpha-Release |
---|---|---|---|---|
7. August 2024 | 1.3.1 | - | - | 1.4.0-alpha02 |
Abhängigkeiten deklarieren
Um eine Abhängigkeit von ProfileInstaller hinzuzufügen, müssen Sie das Maven-Repository von Google zu Ihrem Projekt arbeiten. Maven-Repository von Google lesen .
Fügen Sie der Datei build.gradle
die Abhängigkeiten für die Artefakte hinzu, die Sie benötigen
Ihre App oder Ihr Modul:
Cool
dependencies { implementation "androidx.profileinstaller:profileinstaller:1.3.1" }
Kotlin
dependencies { implementation("androidx.profileinstaller:profileinstaller:1.3.1") }
Weitere Informationen zu Abhängigkeiten finden Sie unter Build-Abhängigkeiten hinzufügen.
Feedback
Dein Feedback hilft uns, Jetpack zu verbessern. Teilen Sie uns mit, wenn Sie neue Ausgaben entdecken oder zur Verbesserung dieser Bibliothek. In der bestehende Probleme in dieser Bibliothek, bevor Sie eine neue erstellen. So können Sie für ein vorhandenes Problem abstimmen: indem Sie auf die Sternschaltfläche klicken.
Weitere Informationen finden Sie in der Dokumentation zur Problemverfolgung. .
Version 1.4
Version 1.4.0-alpha02
7. August 2024
androidx.profileinstaller:profileinstaller:1.4.0-alpha02
wurde veröffentlicht. Version 1.4.0-alpha02 enthält diese Commits.
Neue Funktionen
- API 35-Unterstützung zum Profile Installer hinzugefügt. (6f9f6fa)
Fehlerkorrekturen
- Die manuelle Beschreibung des Zugriffs auf neue Plattform-APIs wurde entfernt, da dies bei Verwendung von R8 mit AGP 7.3 oder höher (z.B. R8-Version 3.3) und bei allen Builds bei Verwendung von AGP 8.1 oder höher (z.B. D8 Version 8.1) automatisch über die API-Modellierung erfolgt. Kunden, die AGP nicht verwenden, wird empfohlen, auf D8-Version 8.1 oder höher zu aktualisieren. Weitere Details findest du in diesem Artikel. (If6b4c, b/345472586)
Version 1.4.0-alpha01
7. Februar 2024
androidx.profileinstaller:profileinstaller:1.4.0-alpha01
wurde veröffentlicht. Version 1.4.0-alpha01 enthält diese Commits.
Fehlerkorrekturen
- Fehlercode für kein eingebettetes Profil in Profilprüfung hinzugefügt. (Ifb109, b/313928520)
- Absturzfehler beim Verwerfen von Shadern unter Android U (API 34) sowie in Emulatoren wurden behoben. (I031ca, b/274314544)
- Die Unterstützung für Android U im Profilinstallationsprogramm wurde aktiviert. (Iaf177)
- Das Profilinstallationsprogramm unter Android U schlug fehl, weil das aktuelle Profil beim Start des Prozesses nicht leer erstellt wurde. (Ie3899)
- Die Bitmap-Transcodierung der Methode im Profilformat
V_015S
wurde korrigiert. (aosp/2906631) und (aosp/2847740)
Version 1.3
Version 1.3.1
3. Mai 2023
androidx.profileinstaller:profileinstaller:1.3.1
wurde veröffentlicht. Version 1.3.1 enthält diese Commits.
Fehlerkorrekturen
- Unterstützung für Android U im Profilinstallationsprogramm aktiviert (Iaf177)
- Das Profilinstallationsprogramm unter Android U schlug fehl, weil das aktuelle Profil beim Start des Prozesses nicht leer erstellt wurde. (Ie3899)
Version 1.3.0
22. März 2023
androidx.profileinstaller:profileinstaller:1.3.0
wurde veröffentlicht. Version 1.3.0 enthält diese Commits.
Wichtige Änderungen seit Version 1.2.0
NullPointerException
inProfileInstallReceiver
korrigiert. (b/243851384)ProfileVerifier
API wurde hinzugefügt, um innerhalb der App zu prüfen, ob ein Basisprofil kompiliert wurde, geplant wurde oder fehlt (I263a4, b/246653809).- Fügt einen neuen Shell-Broadcast hinzu, der es MacroBenchmark ermöglicht, speicherinterne Profildaten vollständig auf das Laufwerk zu leeren, damit sie bei der Erstellung von Referenzprofilen berücksichtigt werden. Dies ist erforderlich, um mit der Makro-Benchmark-Bibliothek Referenzprofile mit
BaselineProfileRule
zu erfassen und die Profilleistung mitCompilationMode.Partial(warmupIterations)
zu bewerten. - Es wurde ein Diagnosecode hinzugefügt, um komprimierte Referenzprofile zu erkennen. Komprimierte Referenzprofile können vom Profileinstaller aufgrund des CPU-Aufwands nicht in Makro-Benchmarks oder in der Produktion installiert werden. Sie sollten sie beim Erstellen Ihrer App vermeiden, indem Sie sie auf Studio/AGP Electric Eel oder die
bundletool
-Version1.13.1
(I86413, b/261998144) aktualisieren. - Es wurden Hooks für Makro-Benchmarks zum Erfassen von Profilen und Löschen des Shader-Cache hinzugefügt, die zum Generieren von Referenzprofilen oder Makro-Benchmarking auf nicht gerooteten Geräten erforderlich sind (Ie0a7d, b/250083467, b/253094958) (Ia5171, b/231455742).
Version 1.3.0-rc01
8. März 2023
androidx.profileinstaller:profileinstaller:1.3.0-rc01
wurde ohne Änderungen seit der letzten Betaversion veröffentlicht. Version 1.3.0-rc01 enthält diese Commits.
Version 1.3.0-beta01
8. Februar 2023
androidx.profileinstaller:profileinstaller:1.3.0-beta01
wurde veröffentlicht. Version 1.3.0-beta01 enthält diese Commits.
API-Änderungen
- Komprimierte Profile werden nicht mehr unterstützt. Das Öffnen und Dekomprimieren führt beim Start zu einer Verringerung der CPU-Auslastung von 10 ms. Daher wurde stattdessen eine Diagnose hinzugefügt, um falsch komprimierte Referenzprofile zu erkennen. (I86413, b/261998144)
Version 1.3.0-alpha03
11. Januar 2023
androidx.profileinstaller:profileinstaller:1.3.0-alpha03
wurde veröffentlicht. Version 1.3.0-alpha03 enthält diese Commits.
Fehlerkorrekturen
- Ermöglicht die Verarbeitung komprimierter und unkomprimierter Referenzprofile (Ic61a0)
- Beheben Sie das Problem mit
MacrobenchmarkScope.dropShaderCache()
, damit es nicht mehr abstürzt, indem Sie das Problem mit der Broadcast-Registry im Profiler-Manifest beheben (I5c728, b/258619948).
Version 1.3.0-alpha02
9. November 2022
androidx.profileinstaller:profileinstaller:1.3.0-alpha02
wurde veröffentlicht. Version 1.3.0-alpha02 enthält diese Commits.
API-Änderungen
- Es wurde ein Hook für Benchmarks hinzugefügt, um den Shader-Cache zu löschen, um eine konsistente Leistung bei Kaltstarts zu gewährleisten, insbesondere bei der Kompilierung mit Profilen aus Aufwärmiterationen. Dieses Update ist erforderlich, um Kaltstarts mit
benchmark-macro-junit4:1.2.0-alpha05
oder höher zu messen. Informationen zu den API-Änderungen der Benchmarkbibliothek finden Sie auf der Seite Benchmark 1.2.0-alpha07. (Ia5171, b/231455742)
Version 1.3.0-alpha01
24. Oktober 2022
androidx.profileinstaller:profileinstaller:1.3.0-alpha01
wurde veröffentlicht. Version 1.3.0-alpha01 enthält diese Commits.
API-Änderungen
ProfileVerifier
API wurde hinzugefügt, um innerhalb der App zu prüfen, ob ein Basisprofil kompiliert wurde, geplant wurde oder fehlt (I263a4, b/246653809).- Fügt einen neuen Shell-Broadcast hinzu, der es MacroBenchmark ermöglicht, speicherinterne Profildaten vollständig auf das Laufwerk zu leeren, damit sie bei der Generierung von Referenzprofilen berücksichtigt werden. Dies ist erforderlich, um die MakroBenchmark-Bibliothek zu verwenden, um Referenzprofile mit
BaselineProfileRule
zu erfassen und die Profilleistung mitCompilationMode.Partial(warmupIterations)
zu bewerten. (Ie0a7d, b/250083467, b/253094958)
Version 1.2.2
Version 1.2.2
11. Januar 2023
androidx.profileinstaller:profileinstaller:1.2.2
wurde veröffentlicht. Version 1.2.2 enthält diese Commits.
Fehlerkorrekturen
- Ermöglicht die Verarbeitung komprimierter und unkomprimierter Referenzprofile (Ic61a0)
Version 1.2.1
Version 1.2.1
7. Dezember 2022
androidx.profileinstaller:profileinstaller:1.2.1
wurde veröffentlicht. Version 1.2.1 enthält diese Commits.
Neue Funktionen
- Aktivieren Sie Profileinstaller für S_V2 (API 32) und TIRAMISU (API 33) (b/254900303).
Version 1.2.0
Version 1.2.0
27. Juli 2022
androidx.profileinstaller:profileinstaller:1.2.0
wurde veröffentlicht. Version 1.2.0 enthält diese Commits.
Wichtige Änderungen seit Version 1.1.0
- Das ab Android 12 verwendete ART-Profilformat wird jetzt unterstützt.
- Fügen Sie in
ProfileInstallReceiver
neue APIs hinzu, um bei der Verwendung von Referenzprofilen konsistentere Ergebnisse mitMacrobenchmarks
zu erhalten.
Version 1.2.0-rc01
15. Juni 2022
androidx.profileinstaller:profileinstaller:1.2.0-rc01
wurde veröffentlicht. Version 1.2.0-rc01 enthält diese Commits.
- Diese Version ist mit
androidx.profileinstaller:profileinstaller:1.2.0-beta03
identisch.
Version 1.2.0-beta03
1. Juni 2022
androidx.profileinstaller:profileinstaller:1.2.0-beta03
wurde veröffentlicht. Version 1.2.0-beta03 enthält diese Commits.
Version 1.2.0-beta02
18. Mai 2022
androidx.profileinstaller:profileinstaller:1.2.0-beta02
wurde veröffentlicht. Version 1.2.0-beta02 enthält diese Commits.
- Keine Änderungen, zur Unterstützung der Compose-Versionen 1.2.0-beta02 erforderlich.
Version 1.2.0-beta01
11. Mai 2022
androidx.profileinstaller:profileinstaller:1.2.0-beta01
wurde veröffentlicht. Version 1.2.0-beta01 enthält diese Commits.
API-Änderungen
- Fügen Sie in
ProfileInstallReceiver
neue APIs hinzu, um bei der Verwendung von Basisprofilen konsistentere Ergebnisse mitMacrobenchmarks
zu erhalten. (If2ae5, b/215740637)
Fehlerkorrekturen
- Das Profil-Installationsprogramm gibt eine hilfreiche Meldung aus, wenn du versuchst, das Metadatenformat
V_001
unter Android 12 und höher zu verwenden. (aosp/1978526, b/217502387) - Das Profilinstallationsprogramm verwendet jetzt
androidx.startup
-Version1.1.1
. (aosp/2077099, b/229828376)
Version 1.2.0-alpha02
26. Januar 2022
androidx.profileinstaller:profileinstaller:1.2.0-alpha02
wurde veröffentlicht. Version 1.2.0-alpha02 enthält diese Commits.
Diese Version ist mit 1.2.0-alpha01
identisch.
Version 1.2.0-alpha01
12. Januar 2022
androidx.profileinstaller:profileinstaller:1.2.0-alpha01
wurde veröffentlicht. Version 1.2.0-alpha01 enthält diese Commits.
Neue Funktionen
- Das ART-Profilformat wird ab Android 12 unterstützt.
Version 1.1.0
Version 1.1.0
9. Februar 2022
androidx.profileinstaller:profileinstaller:1.1.0
wurde veröffentlicht. Version 1.1.0 enthält diese Commits.
Version 1.1.0-rc01
15. Dezember 2021
androidx.profileinstaller:profileinstaller:1.1.0-rc01
wird ohne Updates seit 1.1.0-beta04 veröffentlicht. Version 1.1.0-rc01 enthält diese Commits.
Version 1.1.0-beta04
1. Dezember 2021
androidx.profileinstaller:profileinstaller:1.1.0-beta04
wurde veröffentlicht. Version 1.1.0-beta04 enthält diese Commits.
Version 1.1.0-beta03
17. November 2021
androidx.profileinstaller:profileinstaller:1.1.0-beta03
wurde veröffentlicht. Version 1.1.0-beta03 enthält diese Commits.
Fehlerkorrekturen
- Aktualisiert, um Compose 1.1.0-beta03 zu unterstützen
Version 1.1.0-beta02
3. November 2021
androidx.profileinstaller:profileinstaller:1.1.0-beta02
wurde veröffentlicht. Version 1.1.0-beta02 enthält diese Commits.
Fehlerkorrekturen
- Aktualisiert, um Compose 1.1.0-beta02 zu unterstützen
Version 1.1.0-beta01
27. Oktober 2021
androidx.profileinstaller:profileinstaller:1.1.0-beta01
wurde veröffentlicht. Version 1.1.0-beta01 enthält diese Commits.
- Keine Änderungen seit 1.1.0-alpha07.
Version 1.1.0-alpha07
13. Oktober 2021
androidx.profileinstaller:profileinstaller:1.1.0-alpha07
wurde veröffentlicht. Version 1.1.0-alpha07 enthält diese Commits.
Neue Funktionen
- Unterstützung für Profm unter Android N hinzugefügt
Version 1.1.0-alpha06
29. September 2021
androidx.profileinstaller:profileinstaller:1.1.0-alpha06
wurde veröffentlicht. Version 1.1.0-alpha06 enthält diese Commits.
Fehlerkorrekturen
- Beheben Sie Probleme mit der Profileinstaller-Transcodierung auf N, O und O_MR1. (I12d75)
Version 1.1.0-alpha05
15. September 2021
androidx.profileinstaller:profileinstaller:1.1.0-alpha05
wurde veröffentlicht. Version 1.1.0-alpha05 enthält diese Commits.
Fehlerkorrekturen
- Die Profiltranscodierung mit Android Nougat und Android Oreo für Multidex-APKs wurde korrigiert.
Version 1.1.0-alpha04
1. September 2021
androidx.profileinstaller:profileinstaller:1.1.0-alpha04
wurde veröffentlicht. Version 1.1.0-alpha04 enthält diese Commits.
Fehlerkorrekturen
- Korrigieren Sie
ProfileInstaller
, damit Apps, die Referenzprofile verwenden, MacroBenchmarks mitCompilationMode.BaselineProfile
leichter ausführen können. (I42657, b/196074999)
Version 1.1.0-alpha03
18. August 2021
androidx.profileinstaller:profileinstaller:1.1.0-alpha03
wurde veröffentlicht. Version 1.1.0-alpha03 enthält diese Commits.
Fehlerkorrekturen
- Ändern Sie das Überspringen des Profileinstaller-Verhaltens, um die PackageInfo.lastUpdatedTime in einer Datei im Dateiverzeichnis der Anwendung und bevor Sie das Profil bei der nächsten Ausführung installieren. (Ib93d1)
- Profilformat auf P-, Q- und R-Geräten so anpassen, dass sie den ART-Anforderungen entsprechen (I84e89)
Version 1.1.0-alpha02
4. August 2021
androidx.profileinstaller:profileinstaller:1.1.0-alpha02
wurde veröffentlicht. Version 1.1.0-alpha02 enthält diese Commits.
Aktualisiert, um mit Compose 1.1.0-alpha01 kompatibel zu machen.
Version 1.1.0-alpha01
21. Juli 2021
androidx.profileinstaller:profileinstaller:1.1.0-alpha01
wurde veröffentlicht. Version 1.1.0-alpha01 enthält diese Commits.
Fehlerkorrekturen
- Es wurde ein Fehler behoben, der unter bestimmten Umständen den strikten Modus auslöste.
Version 1.0
Version 1.0.4
13. Oktober 2021
androidx.profileinstaller:profileinstaller:1.0.4
wurde veröffentlicht. Version 1.0.4 enthält diese Commits.
- Aktualisiert, um Compose 1.0.4 zu unterstützen
Version 1.0.3
29. September 2021
androidx.profileinstaller:profileinstaller:1.0.3
wurde veröffentlicht. Version 1.0.3 enthält diese Commits.
- Aktualisiert, um Compose 1.0.3 zu unterstützen
Version 1.0.2
1. September 2021
androidx.profileinstaller:profileinstaller:1.0.2
wurde veröffentlicht. Version 1.0.2 enthält diese Commits.
Fehlerkorrekturen
- Profiltranscodierung für P-, Q- und R-Geräte hinzugefügt. Diese Änderung bedeutet, dass das Profil auf diesen Geräten transcodiert wird, sodass es immer von ART verwendet werden kann. Zuvor wurde die Transcodierung auf diesen Plattformen übersprungen, was dazu führen kann, dass ART das Quellprofil manchmal nicht verarbeiten konnte. Keine Änderungen an Entwickler-APIs.
Version 1.0.1
4. August 2021
androidx.profileinstaller:profileinstaller:1.0.1
wurde veröffentlicht. Version 1.0.1 enthält diese Commits.
Aktualisiert, um mit Compose 1.0.1 kompatibel zu machen.
Version 1.0.0
28. Juli 2021
androidx.profileinstaller:profileinstaller:1.0.0
wurde veröffentlicht. Version 1.0.0 enthält diese Commits.
Hauptfunktionen von Version 1.0.0
Das Profil-Installationsprogramm ist eine neue Bibliothek, mit der Bibliotheken und Anwendungen "Profilregeln" definieren und ART-Profilinformationen mit einem APK bündeln können. Mit dieser Bibliothek werden diese Profile nach dem Start der App installiert. Dies kann genutzt werden, um die Anwendungsleistung zu verbessern.
In den detaillierten Versionshinweisen unter 1.0.0-beta01 finden Sie weitere Informationen zu diesen Profilregeln und ihrer Funktionsweise.
Version 1.0.0-rc02
14. Juli 2021
androidx.profileinstaller:profileinstaller:1.0.0-rc02
wurde veröffentlicht. Version 1.0.0-rc02 enthält diese Commits.
Version 1.0.0-rc01
1. Juli 2021
androidx.profileinstaller:profileinstaller:1.0.0-rc01
wurde veröffentlicht. Version 1.0.0-rc01 enthält diese Commits.
Dies ist eine RC-Release ohne Änderungen gegenüber der Betaversion.
Version 1.0.0-beta01
16. Juni 2021
androidx.profileinstaller:profileinstaller:1.0.0-beta01
wurde veröffentlicht. Version 1.0.0-beta01 enthält diese Commits.
Zweck der Bibliothek
Das Profil-Installationsprogramm ist eine neue Bibliothek, mit der Bibliotheken und Anwendungen "Profilregeln" definieren und ART-Profilinformationen mit einem APK bündeln können. Mit dieser Bibliothek werden diese Profile nach dem Start der App installiert. Dies kann genutzt werden, um die Anwendungsleistung zu verbessern.
Diese Profilinstallation erfolgt über die Bibliothek „androidx.startup“. Wenn Sie die Profilinstallation aus irgendeinem Grund deaktivieren möchten, können Sie das Manifest ändern, um es zu entfernen:
<provider
android:name="androidx.startup.InitializationProvider"
android:authorities="${applicationId}.androidx-startup"
android:exported="false"
tools:node="merge">
<meta-data android:name="androidx.profileinstaller.ProfileInstallerInitializer"
tools:node="remove" />
</provider>
Das ist besonders nützlich, wenn deine App nicht triviale Startanforderungen hat und du die Profilinstallation manuell über die ProfileInstaller.writeProfile
API auslösen möchtest.
Was sind Profilregeln?
Profilregeln für eine Bibliothek werden in der Textdatei
baseline-prof.txt
imsrc/main
oder einem entsprechenden Verzeichnis angegeben. In der Datei ist eine Regel pro Zeile angegeben, wobei eine Regel in diesem Fall ein Muster für den Abgleich mit Methoden oder Klassen in der Bibliothek ist. Die Syntax für diese Regeln ist eine Obermenge des visuell lesbaren ART-Profilformats, das bei Verwendung vonadb shell profman --dump-classes-and-methods ...
verwendet wird. Für die Ausrichtung auf Methoden oder Klassen gibt es zwei Arten dieser Regeln.Eine Methodenregel hat das folgende Muster:
<FLAGS><CLASS_DESCRIPTOR>-><METHOD_SIGNATURE>
Und eine Klassenregel hat das folgende Muster:
<CLASS_DESCRIPTOR>
Hier steht
<FLAGS>
für mindestens eines der ZeichenH
,S
undP
, um anzugeben, ob diese Methode als „Hot“, „Startup“ oder „Post Startup“ gekennzeichnet werden soll.<CLASS_DESCRIPTOR>
ist der Deskriptor für die Klasse, zu der die Zielmethode gehört. Die Klasseandroidx.compose.runtime.SlotTable
hätte beispielsweise den DeskriptorLandroidx/compose/runtime/SlotTable;
.<METHOD_SIGNATURE>
ist die Signatur der Methode und enthält den Namen sowie die Parametertypen und Rückgabetypen der Methode. Die Methodefun isPlaced(): Boolean
fürLayoutNode
hat beispielsweise die SignaturisPlaced()Z
.Diese Muster können Platzhalter (
**
,*
und?
) enthalten, damit eine einzelne Regel mehrere Methoden oder Klassen umfasst.
Wozu dienen die Regeln?
Eine Methode mit dem Flag
H
gibt an, dass diese Methode "heiß" ist. und sollten im Voraus kompiliert werden.Eine Methode mit dem Flag
S
gibt an, dass es sich um eine Methode handelt, die beim Start aufgerufen und im Voraus kompiliert werden sollte, um die Kosten für die Kompilierung und die Interpretation der Methode beim Start zu vermeiden.Eine Methode mit dem Flag
P
gibt an, dass es sich um eine Methode handelt, die nach dem Start aufgerufen wird.Eine in dieser Datei vorhandene Klasse gibt an, dass sie beim Start verwendet wird und im Heap zugewiesen werden sollte, um Kosten für das Laden der Klasse zu vermeiden.
Wie funktioniert das?
Bibliotheken können diese Regeln definieren, die in AAR-Artefakte gepackt werden. Wenn dann ein APK erstellt wird, das diese Artefakte enthält, werden diese Regeln zusammengeführt und mit den zusammengeführten Regeln ein kompaktes binäres ART-Profil erstellt, das für das APK spezifisch ist. ART kann dieses Profil dann nutzen, wenn das APK auf Geräten installiert ist, um im Voraus eine bestimmte Teilmenge der App zu kompilieren und so die Leistung der App zu verbessern, insbesondere bei der ersten Ausführung. Dies hat keine Auswirkungen auf Debug-fähige Anwendungen.
Regeldateien sollten den Namen
baseline-prof.txt
haben und im Stammverzeichnis des Hauptquellsatzes abgelegt werden (diese Datei sollte IhrerAndroidManifset.xml
-Datei gleichgeordnet sein).Derzeit werden diese Dateien nur verwendet, wenn Sie das Android-Gradle-Plug-in 7.0 oder höher verwenden und derzeit nur mit einem Flag in Ihrem
gradle.properties
aktiviert sind:# Enable adding baseline-prof.txt files to AAR artifacts, and binary profiles to APKs android.experimental.enableArtProfiles=true
Für Profile ist ein Guthaben erforderlich
- Richtig gestaltete Profile, mit denen Methoden und Klassen, die sich im Startpfad befinden und leistungskritisch sind, korrekt priorisiert werden, erzielen die besten Ergebnisse. Wenn zu viele Methoden oder Klassen in Profilen enthalten sind, kann dies jedoch negative Auswirkungen auf den Arbeitsspeicher- und Laufwerksverbrauch haben. Daher empfiehlt es sich, mit konservativer Vorgehensweise zu beginnen, wenn Sie Ihre eigenen Profilregeln definieren.