Criar perfis de referência para uma biblioteca

Para criar perfis de referência para uma biblioteca, use o plug-in do perfil de referência para Gradle.

Há três módulos na criação de perfis de referência para uma biblioteca:

  • Módulo de app de exemplo: contém o app de exemplo que usa a biblioteca.
  • Módulo de biblioteca: o módulo para o qual você quer gerar o perfil.
  • Módulo do perfil de referência: o módulo de teste que gera os perfis de referência.

Para gerar um perfil de referência para uma biblioteca, siga estas etapas:

  1. Crie um novo módulo com.android.test, por exemplo, :baseline-profile.
  2. Configure o arquivo build.gradle.kts para o módulo :baseline-profile. A configuração é basicamente a mesma de um app, mas você precisa definir targetProjectPath como o módulo do app de exemplo.
  3. Crie um teste de perfil de referência no módulo de teste :baseline-profile. Ele precisa ser específico para o app de exemplo e usar todas as funcionalidades da biblioteca.
  4. Atualize a configuração no arquivo build.gradle.ktss no módulo de biblioteca como :library.
    1. Aplique o plug-in androidx.baselineprofile.
    2. Adicione uma dependência de baselineProfile ao módulo :baseline-profile.
    3. Aplique a configuração do plug-in de consumidor que você quer, conforme mostrado no exemplo abaixo.

    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.**"
        }
    }
    

    Groovy

    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. Adicione o plug-in androidx.baselineprofile ao arquivo build.gradle.kts no módulo :sample-app do app.

    Kotlin

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

    Groovy

    plugins {
        ...
        id 'androidx.baselineprofile'
    }
    
  6. Gere o perfil executando este código: ./gradlew :library:generateBaselineProfile.

No final da tarefa de geração, o perfil de referência é armazenado em library/src/main/generated/baselineProfiles.