Basisprofile für eine Bibliothek erstellen

Verwenden Sie das Gradle-Plug-in für Baseline Profile, um Baseline-Profile für eine Bibliothek zu erstellen.

Zum Erstellen von Baseline-Profilen für eine Bibliothek sind drei Module erforderlich:

  • Beispiel-App-Modul: Enthält die Beispiel-App, die deine Bibliothek verwendet.
  • Bibliotheksmodul: Das Modul, für das Sie das Profil erstellen möchten.
  • Modul „Baseline Profile“: das Testmodul, das die Baseline-Profile generiert.

Führen Sie die folgenden Schritte aus, um ein Baseline-Profil für eine Bibliothek zu generieren:

  1. Erstellen Sie ein neues com.android.test-Modul, z. B. :baseline-profile.
  2. Konfigurieren Sie die Datei build.gradle.kts für das Modul :baseline-profile. Die Konfiguration ist im Wesentlichen die gleiche wie für eine Anwendung. Achte jedoch darauf, dass targetProjectPath auf das Beispielanwendungsmodul festgelegt ist.
  3. Erstellen Sie einen Baseline-Profiltest im :baseline-profile-Testmodul. Sie muss spezifisch für die Beispiel-App sein und alle Funktionen der Bibliothek nutzen.
  4. Aktualisieren Sie die Konfiguration in der Datei build.gradle.ktss im Bibliotheksmodul, z. B. :library.
    1. Wenden Sie das Plug-in androidx.baselineprofile an.
    2. Fügen Sie dem Modul :baseline-profile eine baselineProfile-Abhängigkeit hinzu.
    3. Wenden Sie die gewünschte Konfiguration für das Nutzer-Plug-in wie im folgenden Beispiel gezeigt an.

    Kotlin

    plugins {
        id("com.android.library")
        id("androidx.baselineprofile")
    }
    
    android { ... }
    
    dependencies {
        ...
        // Add a baselineProfile dependency to the `:baseline-profile` module.
        baselineProfile(project(":baseline-profile"))
    }
    
    // Baseline Profile Gradle plugin configuration.
    baselineProfile {
    
        // Filters the generated profile rules. 
        // This example keeps the classes in the `com.library` package all its subpackages.
        filter {
            include "com.mylibrary.**"
        }
    }
    

    Groovig

    plugins {
        id 'com.android.library'
        id 'androidx.baselineprofile'
    }
    
    android { ... }
    
    dependencies {
        ...
        // Add a baselineProfile dependency to the `:baseline-profile` module.
        baselineProfile ':baseline-profile'
    }
    
    // Baseline Profile Gradle plugin configuration.
    baselineProfile {
    
        // Filters the generated profile rules. 
        // This example keeps the classes in the `com.library` package all its subpackages.
        filter {
            include 'com.mylibrary.**'
        }
    }
    
  5. Fügen Sie der Datei build.gradle.kts im App-Modul :sample-app das Plug-in androidx.baselineprofile hinzu.

    Kotlin

    plugins {
        ...
        id("androidx.baselineprofile")
    }
    

    Groovig

    plugins {
        ...
        id 'androidx.baselineprofile'
    }
    
  6. Generieren Sie das Profil, indem Sie den folgenden Code ausführen: ./gradlew :library:generateBaselineProfile.

Am Ende der Generierungsaufgabe wird das Referenzprofil unter library/src/main/generated/baselineProfiles gespeichert.