ایجاد «نمایه‌های مبنا» برای کتابخانه

برای ایجاد «نمایه‌های مبنا» برای کتابخانه، از افزونه Baseline Profile Gradle استفاده کنید.

سه ماژول در ایجاد «نمایه‌های پایه» برای کتابخانه دخیل هستند:

  • واحد برنامه نمونه: حاوی برنامه نمونه‌ای است که از کتابخانه شما استفاده می‌کند.
  • ماژول کتابخانه: ماژولی که می‌خواهید نمایه را برای آن تولید کنید.
  • واحد Baseline Profile: واحد آزمایشی که Baseline Profiles را تولید می‌کند.

برای تولید «نمایه مبنا» برای کتابخانه، مراحل زیر را انجام دهید:

  1. ماژول com.android.test جدیدی ایجاد کنید—برای مثال، :baseline-profile.
  2. فایل build.gradle.kts را برای واحد :baseline-profile پیکربندی کنید. پیکربندی اساساً همانند پیکربندی برنامه است، اما حتماً targetProjectPath را روی واحد برنامه نمونه تنظیم کنید.
  3. آزمون «نمایه خط مبنا» را در واحد آزمایشی :baseline-profile ایجاد کنید. این مورد باید مختص برنامه نمونه باشد و باید از همه عملکردهای کتابخانه استفاده کند.
  4. پیکربندی را در فایل build.gradle.ktss در واحد کتابخانه، مثلاً :library، به‌روز کنید.
    1. افزایه androidx.baselineprofile را اعمال کنید.
    2. وابستگی baselineProfile را به مدول :baseline-profile اضافه کنید.
    3. پیکربندی افزونه مصرف‌کننده موردنظرتان را اعمال کنید، همان‌طور که در مثال زیر نشان داده شده است.

    کاتلین

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

    شیک

    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. افزونه androidx.baselineprofile را به فایل build.gradle.kts در واحد برنامه :sample-app اضافه کنید.

    کاتلین

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

    شیک

    plugins {
        ...
        id 'androidx.baselineprofile'
    }
  6. نمایه را با اجرای کد زیر تولید کنید: ./gradlew :library:generateBaselineProfile.

در پایان تکلیف تولید، «نمایه پایه» در library/src/main/generated/baselineProfiles ذخیره می‌شود.