ایجاد پروفایل های پایه

توصیه می‌کنیم با استفاده از الگوی ماژول پروفایل پایه آندروید استودیو (ترجیحا) یا الگوی Macrobenchmark یک نمایه پایه ایجاد کنید، اما می‌توانید به تنهایی از افزونه Baseline Profile Gradle نیز استفاده کنید. برای مطالعه بیشتر در مورد پلاگین Baseline Profile Gradle، به پیکربندی نسل نمایه خط پایه خود مراجعه کنید.

در اینجا نحوه ایجاد نمایه پایه با استفاده از افزونه Baseline Profile Gradle به طور مستقیم آورده شده است:

1. یک ماژول com.android.test جدید ایجاد کنید—مثلاً :baseline-profile .

2. فایل build.gradle.kts را برای :baseline-profile پیکربندی کنید:

   1. افزونه androidx.baselineprofile را اعمال کنید.
   2. اطمینان حاصل کنید که targetProjectPath به ماژول :app اشاره می کند.
   3. به صورت اختیاری، یک دستگاه با مدیریت Gradle (GMD) اضافه کنید. در مثال زیر، pixel6Api31 است. اگر مشخص نشده باشد، افزونه از یک دستگاه متصل، شبیه سازی شده یا فیزیکی استفاده می کند.
   4. همانطور که در مثال زیر نشان داده شده است، پیکربندی مورد نظر خود را اعمال کنید.
   کاتلین

   plugins {
       id("com.android.test")
       id("androidx.baselineprofile")
   }
   
   android {
       defaultConfig {
           ...
       }
   
       // Point to the app module, the module that you're generating the Baseline Profile for.
       targetProjectPath = ":app"
       // Configure a GMD (optional).
       testOptions.managedDevices.devices {
           pixel6Api31(com.android.build.api.dsl.ManagedVirtualDevice) {
               device = "Pixel 6"
               apiLevel = 31
               systemImageSource = "aosp"
           }
       }
   }
   
   dependencies { ... }
   
   // Baseline Profile Gradle plugin configuration. Everything is optional. This
   // example uses the GMD added earlier and disables connected devices.
   baselineProfile {
       // Specifies the GMDs to run the tests on. The default is none.
       managedDevices += "pixel6Api31"
       // Enables using connected devices to generate profiles. The default is
       // `true`. When using connected devices, they must be rooted or API 33 and
       // higher.
       useConnectedDevices = false
   }

   شیار

   plugins {
       id 'com.android.test'
       id 'androidx.baselineprofile'
   }
   
   android {
       defaultConfig {
           ...
       }
   
       // Point to the app module, the module that you're generating the Baseline Profile for.
       targetProjectPath ':app'
       // Configure a GMD (optional).
       testOptions.managedDevices.devices {
           pixel6Api31(com.android.build.api.dsl.ManagedVirtualDevice) {
               device 'Pixel 6'
               apiLevel 31
               systemImageSource 'aosp'
           }
       }
   }
   
   dependencies { ... }
   
   // Baseline Profile Gradle plugin configuration. Everything is optional. This
   // example uses the GMD added earlier and disables connected devices.
   baselineProfile {
       // Specifies the GMDs to run the tests on. The default is none.
       managedDevices ['pixel6Api31']
       // Enables using connected devices to generate profiles. The default is
       // `true`. When using connected devices, they must be rooted or API 33 and
       // higher.
       useConnectedDevices false
   }

3. یک تست Baseline Profile در ماژول تست :baseline-profile ایجاد کنید. مثال زیر تستی است که برنامه را راه اندازی می کند و منتظر می ماند تا بیکار شود.

   کاتلین

   class BaselineProfileGenerator {
   
       @get:Rule
       val baselineRule = BaselineProfileRule()
   
       @Test
       fun startupBaselineProfile() {
           baselineRule.collect("com.myapp") {
               startActivityAndWait()
           }
       }
   }

   جاوا

   public class BaselineProfileGenerator {
   
       @Rule
       Public BaselineProfileRule baselineRule = new BaselineProfileRule();
   
       @Test
       Public void startupBaselineProfile() {
           baselineRule.collect(
               "com.myapp",
               (scope -> {
                   scope.startActivityAndWait();
                   Return Unit.INSTANCE;
               })
           )
       }
   }

4. فایل build.gradle.kts را در ماژول برنامه به‌روزرسانی کنید، برای مثال :app .

   1. افزونه androidx.baselineprofile را اعمال کنید.
   2. یک وابستگی baselineProfile به ماژول :baseline-profile اضافه کنید.
   کاتلین

   plugins {
       id("com.android.application")
       id("androidx.baselineprofile")
   }
   
   android {
       // There are no changes to the `android` block.
       ...
   }
   
   dependencies {
       ...
       // Add a `baselineProfile` dependency on the `:baseline-profile` module.
       baselineProfile(project(":baseline-profile"))
   }

   شیار

   plugins {
       id 'com.android.application'
       id 'androidx.baselineprofile'
   }
   
   android {
       // No changes to the `android` block.
       ...
   }
   
   dependencies {
       ...
       // Add a `baselineProfile` dependency on the `:baseline-profile` module.
       baselineProfile ':baseline-profile'
   }

5. با اجرای وظایف :app:generateBaselineProfile یا :app:generate Variant BaselineProfile Gradle نمایه را ایجاد کنید.

6. در پایان کار تولید، نمایه خط پایه در app/src/ variant /generated/baselineProfiles کپی می‌شود.

یک نمایه پایه جدید با AGP 7.3-7.4 ایجاد کنید

امکان تولید نمایه های پایه با AGP 7.3-7.4 وجود دارد، اما ما قویاً توصیه می کنیم حداقل به AGP 8.1 ارتقا دهید تا بتوانید از افزونه Baseline Profile Gradle و آخرین ویژگی های آن استفاده کنید.

اگر نیاز به ایجاد نمایه های پایه با AGP 7.3-7.4 دارید، مراحل مشابه مراحل AGP 8.1 است، با استثنائات زیر:

• افزونه Baseline Profile Gradle را اضافه نکنید.
• برای تولید نمایه‌های پایه، وظیفه Gradle ./gradlew [emulator name][flavor][build type]AndroidTest را اجرا کنید. به عنوان مثال، ./gradlew :benchmark:pixel6Api31BenchmarkAndroidTest .
• شما باید قوانین نمایه خط پایه ایجاد شده را به صورت دستی در کد خود اعمال کنید .

قوانین ایجاد شده را به صورت دستی اعمال کنید

ژنراتور Baseline Profile یک فایل متنی با فرمت قابل خواندن توسط انسان (HRF) روی دستگاه ایجاد می کند و آن را در دستگاه میزبان شما کپی می کند. برای اعمال نمایه تولید شده در کد خود، این مراحل را دنبال کنید:

1. فایل HRF را در پوشه ساخت ماژولی که نمایه را در آن ایجاد می‌کنید، پیدا کنید: [module]/build/outputs/managed_device_android_test_additional_output/[device] .

   نمایه‌ها از الگوی نام‌گذاری [class name]-[test method name]-baseline-prof.txt پیروی می‌کنند که به شکل زیر است: BaselineProfileGenerator-startup-baseline-prof.txt .

2. نمایه تولید شده را در src/main/ کپی کنید و نام فایل را به baseline-prof.txt تغییر دهید.

3. یک وابستگی به کتابخانه ProfileInstaller در فایل build.gradle.kts برنامه خود اضافه کنید تا در جایی که نمایه‌های ابری در دسترس نیستند، کامپایل نمایه خط پایه محلی را فعال کنید. این تنها راه برای بارگذاری یک نمایه پایه به صورت محلی است.

   dependencies {
        implementation("androidx.profileinstaller:profileinstaller:1.4.0")
   }
   

4. در حالی که قوانین HRF اعمال شده به شکل باینری کامپایل شده و در APK یا AAB گنجانده شده است، نسخه تولیدی برنامه خود را بسازید. سپس برنامه خود را طبق معمول توزیع کنید.

نمایه خط پایه را محک بزنید

برای محک زدن نمایه خط پایه خود، یک پیکربندی جدید اجرای آزمایشی ابزاری Android از عمل ناودان ایجاد کنید که معیارهای تعریف شده در فایل StartupBenchmarks.kt یا StartupBencharks.java را اجرا می کند. برای کسب اطلاعات بیشتر در مورد تست معیار، به ایجاد کلاس Macrobenchmark و اندازه‌گیری خودکار با کتابخانه Macrobenchmark مراجعه کنید.

هنگامی که این را در Android Studio اجرا می کنید، خروجی ساخت شامل جزئیات بهبود سرعت است که نمایه Baseline ارائه می دهد:

StartupBenchmarks_startupCompilationBaselineProfiles
timeToInitialDisplayMs   min 161.8,   median 178.9,   max 194.6
StartupBenchmarks_startupCompilationNone
timeToInitialDisplayMs   min 184.7,   median 196.9,   max 202.9

تمام مسیرهای کد مورد نیاز را ضبط کنید

دو معیار کلیدی برای اندازه گیری زمان راه اندازی اپلیکیشن به شرح زیر است:

زمان تا نمایش اولیه (TTID)

مدت زمانی که طول می کشد تا اولین فریم از رابط کاربری برنامه نمایش داده شود.

زمان نمایش کامل (TTFD)

TTID به اضافه زمان نمایش محتوایی که پس از نمایش فریم اولیه به صورت ناهمزمان بارگیری می شود.

پس از فراخوانی متد reportFullyDrawn() ComponentActivity ، TTFD گزارش می‌شود. اگر reportFullyDrawn() هرگز فراخوانی نشود، به جای آن TTID گزارش می شود. ممکن است لازم باشد هنگام reportFullyDrawn() تا زمانی که بارگیری ناهمزمان کامل شود، به تاخیر بیاندازید. به عنوان مثال، اگر UI حاوی یک لیست پویا مانند RecyclerView یا لیست تنبل باشد ، ممکن است لیست با یک کار پس زمینه پر شود که پس از اولین ترسیم لیست و بنابراین پس از علامت گذاری رابط کاربری به عنوان کاملاً رسم شده تکمیل می شود. در چنین مواردی، کدی که پس از رسیدن رابط کاربری به حالت کاملا ترسیم شده اجرا می‌شود، در نمایه خط پایه گنجانده نمی‌شود.

برای گنجاندن جمعیت لیست به عنوان بخشی از نمایه پایه خود، با استفاده از getFullyDrawnReporter() FullyDrawnReporter دریافت کنید و یک گزارشگر به آن در کد برنامه خود اضافه کنید. پس از تکمیل کار پس‌زمینه، گزارشگر را رها کنید. FullyDrawnReporter متد reportFullyDrawn() فراخوانی نمی کند تا زمانی که همه گزارشگران آزاد شوند. با انجام این کار، Baseline Profile شامل مسیرهای کد مورد نیاز برای پر کردن لیست می شود. این رفتار برنامه را برای کاربر تغییر نمی‌دهد، اما به نمایه خط پایه اجازه می‌دهد تمام مسیرهای کد لازم را شامل شود.

اگر برنامه شما از Jetpack Compose استفاده می‌کند، از APIهای زیر برای نشان دادن وضعیت کاملاً ترسیم شده استفاده کنید:

• ReportDrawn نشان می دهد که composable شما بلافاصله برای تعامل آماده است.
• ReportDrawnWhen یک گزاره مانند list.count > 0 را می گیرد تا نشان دهد که سازنده شما چه زمانی برای تعامل آماده است.
• ReportDrawnAfter یک روش تعلیق را انتخاب می کند که وقتی کامل شد، نشان می دهد که composable شما برای تعامل آماده است.

{% کلمه به کلمه %} {% آخر کلمه %} برای شما توصیه می شود

• توجه: وقتی جاوا اسکریپت خاموش است، متن پیوند نمایش داده می شود
• معیارهای ماکرو بنچمارک را ضبط کنید
• یک ماکرو بنچمارک بنویسید
• کتابخانه JankStats

{% کلمه به کلمه %} {% آخر کلمه %}