إنشاء ملفات شخصية أساسية لمكتبة

لإنشاء "ملفات شخصية أساسية" لمكتبة، استخدِم المكوّن الإضافي Baseline Profile Gradle.

هناك ثلاث وحدات متضمنة في إنشاء الملفات الشخصية الأساسية للمكتبة:

  • نموذج وحدة التطبيق: يحتوي على نموذج التطبيق الذي يستخدم مكتبتك.
  • وحدة المكتبة: الوحدة التي تريد إنشاء ملف تعريف لها.
  • وحدة الملف الشخصي الأساسي: وحدة الاختبار التي تنشئ "الملفات الشخصية المرجعية".

لإنشاء "ملف شخصي أساسي" لمكتبة، عليك اتّباع الخطوات التالية:

  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. طبِّق إعدادات المكوّن الإضافي للمستهلك التي تريدها، كما هو موضَّح في المثال التالي.

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

    رائع

    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

    Kotlin

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

    رائع

    plugins {
        ...
        id 'androidx.baselineprofile'
    }
    
  6. إنشاء الملف الشخصي عن طريق تشغيل الرمز التالي: ./gradlew :library:generateBaselineProfile.

في نهاية مهمة الإنشاء، يتم تخزين الملف الشخصي الأساسي في library/src/main/generated/baselineProfiles.