สร้างโปรไฟล์พื้นฐาน

Baseline Profile มีความสำคัญต่อการเพิ่มประสิทธิภาพ Jetpack Compose ให้สูงสุด การคอมไพล์เส้นทางของผู้ใช้ที่สำคัญล่วงหน้าจะช่วยให้มั่นใจได้ว่า Compose UI จะแสดงผลได้อย่างราบรื่น

สร้างโปรไฟล์โดยอัตโนมัติสำหรับแอปทุกรุ่นโดยใช้ไลบรารี Jetpack Macrobenchmark และ BaselineProfileRule เราขอแนะนำให้คุณใช้ com.android.tools.build:gradle:8.0.0 ขึ้นไปเพื่อใช้ประโยชน์จากการปรับปรุงบิลด์เมื่อใช้โปรไฟล์พื้นฐาน

ขั้นตอนทั่วไปในการสร้าง Baseline Profile ใหม่มีดังนี้

  1. ตั้งค่าโมดูลโปรไฟล์พื้นฐาน
  2. กำหนดการทดสอบ JUnit ที่ช่วยสร้างโปรไฟล์พื้นฐาน
  3. เพิ่มเส้นทางของผู้ใช้ที่สำคัญ (CUJ) ที่คุณต้องการเพิ่มประสิทธิภาพ
  4. สร้างโปรไฟล์พื้นฐาน

หลังจากสร้างโปรไฟล์พื้นฐานแล้ว ให้เปรียบเทียบโดยใช้อุปกรณ์จริงเพื่อวัดการปรับปรุงความเร็ว

สร้าง Baseline Profile ใหม่ด้วย AGP 8.2 ขึ้นไป

วิธีที่ง่ายที่สุดในการสร้าง Baseline Profile ใหม่คือการใช้เทมเพลตโมดูล Baseline Profile ซึ่งพร้อมใช้งานตั้งแต่ Android Studio Iguana และ Android Gradle Plugin (AGP) 8.2 เป็นต้นไป

เทมเพลตโมดูล Baseline Profile Generator ของ Android Studio จะสร้างโมดูลใหม่โดยอัตโนมัติเพื่อสร้างและเปรียบเทียบ Baseline Profile การเรียกใช้เทมเพลตจะสร้างการกำหนดค่าบิลด์ทั่วไป การสร้างโปรไฟล์พื้นฐาน และโค้ดการยืนยันส่วนใหญ่ เทมเพลตจะสร้างโค้ดเพื่อสร้างและเปรียบเทียบโปรไฟล์ Baseline เพื่อวัดการเริ่มต้นแอป

ตั้งค่าโมดูลโปรไฟล์พื้นฐาน

หากต้องการเรียกใช้เทมเพลตโมดูลโปรไฟล์พื้นฐาน ให้ทำตามขั้นตอนต่อไปนี้

  1. เลือก File > New > New Module
  2. เลือกเทมเพลต Baseline Profile Generator ในแผงเทมเพลต แล้วกำหนดค่าดังนี้
    รูปที่ 1 เทมเพลตโมดูล Baseline Profile Generator
    ช่องในเทมเพลตมีดังนี้
    • แอปพลิเคชันเป้าหมาย: แอปที่สร้างโปรไฟล์พื้นฐานขึ้นมา เมื่อคุณมีโมดูลแอปเพียงโมดูลเดียวในโปรเจ็กต์ รายการนี้จะมีเพียงรายการเดียว
    • ชื่อโมดูล: ชื่อที่ต้องการสำหรับโมดูล Baseline Profile ที่กำลังสร้าง
    • ชื่อแพ็กเกจ: ชื่อแพ็กเกจที่ต้องการสำหรับโมดูลโปรไฟล์พื้นฐาน
    • ภาษา: เลือกว่าต้องการให้โค้ดที่สร้างขึ้นเป็น Kotlin หรือ Java
    • ภาษาการกำหนดค่าบิลด์: คุณต้องการใช้ Kotlin Script (KTS) หรือ Groovy สำหรับสคริปต์การกำหนดค่าบิลด์หรือไม่
    • ใช้อุปกรณ์ที่มีการจัดการจาก Gradle: คุณใช้อุปกรณ์ที่มีการจัดการจาก Gradle เพื่อทดสอบแอปหรือไม่
  3. คลิกเสร็จสิ้น ระบบจะสร้างโมดูลใหม่ หากใช้การควบคุมแหล่งที่มา ระบบอาจแจ้งให้คุณเพิ่มไฟล์โมดูลที่สร้างใหม่ลงในการควบคุมแหล่งที่มา

กำหนดเครื่องมือสร้างโปรไฟล์พื้นฐาน

โมดูลที่สร้างขึ้นใหม่ประกอบด้วยการทดสอบเพื่อสร้างและเปรียบเทียบ Baseline Profile และทดสอบเฉพาะการเริ่มต้นแอปพื้นฐาน เราขอแนะนำให้คุณเพิ่มข้อมูลเหล่านี้เพื่อรวม CUJ และเวิร์กโฟลว์การเริ่มต้นขั้นสูง ตรวจสอบว่าการทดสอบที่เกี่ยวข้องกับการเริ่มต้นแอปอยู่ในบล็อก rule โดยตั้งค่า includeInStartupProfile เป็น true ในทางกลับกัน เพื่อประสิทธิภาพสูงสุด ให้ตรวจสอบว่าการทดสอบที่ไม่เกี่ยวข้องกับการเริ่มต้นแอปไม่ได้รวมอยู่ในโปรไฟล์การเริ่มต้นระบบ การเพิ่มประสิทธิภาพการเริ่มต้นแอปใช้เพื่อกำหนดส่วนพิเศษของโปรไฟล์พื้นฐานที่เรียกว่าโปรไฟล์การเริ่มต้น

การแยก CUJ เหล่านี้ออกจากโค้ดโปรไฟล์พื้นฐานและโค้ดการเปรียบเทียบที่สร้างขึ้นจะช่วยให้ดูแลรักษาได้ง่ายขึ้น เพื่อให้ใช้กับทั้ง 2 อย่างได้ ซึ่งหมายความว่าระบบจะใช้การเปลี่ยนแปลงใน CUJ อย่างสอดคล้องกัน

สร้างและติดตั้งโปรไฟล์พื้นฐาน

เทมเพลตโมดูลโปรไฟล์พื้นฐานจะเพิ่มการกำหนดค่าการเรียกใช้ใหม่เพื่อสร้างโปรไฟล์พื้นฐาน หากคุณใช้เวอร์ชันผลิตภัณฑ์ Android Studio จะสร้างการกำหนดค่าการเรียกใช้หลายรายการเพื่อให้คุณสร้างโปรไฟล์พื้นฐานแยกต่างหากสำหรับแต่ละเวอร์ชันได้

การกำหนดค่าการเรียกใช้ Generate Baseline Profile
รูปที่ 2 การเรียกใช้การกำหนดค่านี้จะสร้างโปรไฟล์พื้นฐาน

เมื่อการกำหนดค่าการเรียกใช้สร้างโปรไฟล์พื้นฐานเสร็จสมบูรณ์ ระบบจะคัดลอกโปรไฟล์พื้นฐานที่สร้างขึ้นไปยังไฟล์ src/variant/generated/baselineProfiles/baseline-prof.txt ในโมดูลที่กำลังสร้างโปรไฟล์ ตัวเลือกสินค้าย่อยคือประเภทบิลด์ที่เผยแพร่หรือตัวแปรบิลด์ที่เกี่ยวข้องกับประเภทบิลด์ที่เผยแพร่

Baseline Profile ที่สร้างขึ้นจะสร้างขึ้นใน build/outputs ตั้งแต่แรก เส้นทางแบบเต็มจะกำหนดโดยตัวแปรหรือเวอร์ชันของแอปที่กำลังทำโปรไฟล์ และขึ้นอยู่กับว่าคุณใช้อุปกรณ์ที่มีการจัดการจาก Gradle หรืออุปกรณ์ที่เชื่อมต่อสำหรับการทำโปรไฟล์ หากคุณใช้ชื่อที่ใช้โดยโค้ดและการกำหนดค่าบิลด์ที่สร้างขึ้นโดยเทมเพลต ระบบจะสร้างโปรไฟล์พื้นฐานในไฟล์ build/outputs/managed_device_android_test_additional_output/nonminifiedrelease/pixel6Api31/BaselineProfileGenerator_generate-baseline-prof.txt คุณอาจไม่ต้องโต้ตอบกับ Baseline Profile เวอร์ชันที่สร้างขึ้นนี้โดยตรง เว้นแต่คุณจะคัดลอกไปยังโมดูลเป้าหมายด้วยตนเอง (ไม่แนะนำ)

สร้างโปรไฟล์พื้นฐานใหม่ด้วย AGP 8.1

หากใช้เทมเพลตโมดูลโปรไฟล์พื้นฐานไม่ได้ ให้ใช้เทมเพลตโมดูล Macrobenchmark และปลั๊กอิน Gradle ของโปรไฟล์พื้นฐานเพื่อสร้างโปรไฟล์พื้นฐานใหม่ เราขอแนะนำให้ใช้เครื่องมือเหล่านี้โดยเริ่มจาก Android Studio Giraffe และ AGP 8.1

ขั้นตอนในการสร้างโปรไฟล์พื้นฐานใหม่โดยใช้เทมเพลตโมดูล Macrobenchmark และปลั๊กอิน Gradle ของโปรไฟล์พื้นฐานมีดังนี้

  1. ตั้งค่าโมดูล Macrobenchmark ในโปรเจ็กต์ Gradle

  2. กำหนดคลาสใหม่ชื่อ BaselineProfileGenerator:

    class BaselineProfileGenerator {
    @get:Rule
    val baselineProfileRule = BaselineProfileRule()

    @Test
    fun startup() = baselineProfileRule.collect(
        packageName = "com.example.app",
        profileBlock = {
            startActivityAndWait()
        }
    )
}

    เครื่องมือสร้างอาจมีการโต้ตอบกับแอปของคุณนอกเหนือจากการเริ่มต้นแอป ซึ่งจะช่วยให้คุณเพิ่มประสิทธิภาพรันไทม์ของแอปได้ เช่น การเลื่อนรายการ การเรียกใช้ภาพเคลื่อนไหว และการไปยังส่วนต่างๆ ภายใน Activity ดูตัวอย่างอื่นๆ ของการทดสอบที่ใช้ @BaselineProfileRule เพื่อปรับปรุงเส้นทางของผู้ใช้ที่สำคัญ

  3. เพิ่มปลั๊กอิน Baseline Profile Gradle (libs.plugins.androidx.baselineprofile) ปลั๊กอินนี้ช่วยให้สร้าง Baseline Profile และดูแลรักษาในอนาคตได้ง่ายขึ้น

  4. หากต้องการสร้างโปรไฟล์พื้นฐาน ให้เรียกใช้งาน Gradle :app:generateBaselineProfile หรือ :app:generateVariantBaselineProfile ในเทอร์มินัล

    เรียกใช้โปรแกรมสร้างเป็นการทดสอบการวัดคุมในอุปกรณ์จริงที่รูทแล้ว โปรแกรมจำลอง หรืออุปกรณ์ที่มีการจัดการจาก Gradle หากคุณใช้อุปกรณ์ที่มีการจัดการจาก Gradle ให้ตั้งค่า aosp เป็น systemImageSource เนื่องจากคุณต้องมีสิทธิ์เข้าถึงระดับรูทสำหรับเครื่องมือสร้างโปรไฟล์พื้นฐาน

    เมื่อสิ้นสุดงานการสร้าง ระบบจะคัดลอกโปรไฟล์พื้นฐานไปยัง app/src//generated/baselineProfiles

สร้าง Baseline Profile ใหม่โดยไม่มีเทมเพลต

เราขอแนะนำให้สร้างโปรไฟล์พื้นฐานโดยใช้เทมเพลตโมดูลโปรไฟล์พื้นฐาน (แนะนำ) หรือเทมเพลต Macrobenchmark ของ Android Studio แต่คุณจะใช้ปลั๊กอิน Gradle ของโปรไฟล์พื้นฐานเพียงอย่างเดียวก็ได้ อ่านข้อมูลเพิ่มเติมเกี่ยวกับปลั๊กอิน Gradle ของโปรไฟล์พื้นฐานได้ที่กำหนดค่าการสร้างโปรไฟล์พื้นฐาน

วิธีสร้างโปรไฟล์พื้นฐานโดยใช้ปลั๊กอิน Gradle ของโปรไฟล์พื้นฐานโดยตรงมีดังนี้

  1. สร้างโมดูล com.android.test ใหม่ เช่น :baseline-profile

  2. กำหนดค่าไฟล์ build.gradle.kts สำหรับ :baseline-profile ดังนี้

    1. ใช้ปลั๊กอิน androidx.baselineprofile
    2. ตรวจสอบว่า targetProjectPath ชี้ไปยังโมดูล :app
    3. เพิ่มอุปกรณ์ที่มีการจัดการจาก Gradle (GMD) (ไม่บังคับ) ในตัวอย่างต่อไปนี้คือ pixel6Api31 หากไม่ได้ระบุ ปลั๊กอินจะใช้อุปกรณ์ที่เชื่อมต่อ ไม่ว่าจะเป็นอุปกรณ์จำลองหรืออุปกรณ์จริง
    4. ใช้การกำหนดค่าที่ต้องการตามที่แสดงในตัวอย่างต่อไปนี้

    Kotlin

    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 ตัวอย่างต่อไปนี้เป็นการทดสอบที่สร้างโปรไฟล์พื้นฐานสำหรับการเริ่มต้นแอป

        class BaselineProfileGenerator {
    @get:Rule
    val baselineProfileRule = BaselineProfileRule()

    @Test
    fun startup() = baselineProfileRule.collect(
        packageName = "com.example.app",
        profileBlock = {
            uiAutomator { startApp(PACKAGE_NAME) }
        }
    )
}

  4. อัปเดตไฟล์ build.gradle.kts ในโมดูลแอป เช่น :app

    1. ใช้ปลั๊กอิน androidx.baselineprofile
    2. เพิ่มทรัพยากร Dependency baselineProfile ลงในโมดูล :baseline-profile

    Kotlin

    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 หรืองาน Gradle :app:generateVariantBaselineProfile

  6. เมื่อสิ้นสุดงานการสร้าง ระบบจะคัดลอกโปรไฟล์พื้นฐานไปยัง app/src/variant/generated/baselineProfiles

เปรียบเทียบโปรไฟล์พื้นฐาน

หากต้องการเปรียบเทียบ Baseline Profile ให้สร้างการกำหนดค่าการเรียกใช้การทดสอบ Android ที่ใช้เครื่องมือวัดใหม่จากการดำเนินการในแถบด้านข้างที่เรียกใช้การเปรียบเทียบที่กำหนดไว้ในไฟล์ StartupBenchmarks.kt ดูข้อมูลเพิ่มเติมเกี่ยวกับการทดสอบการเปรียบเทียบได้ที่หัวข้อสร้างคลาส Macrobenchmark และเปรียบเทียบ Baseline Profile กับไลบรารี Macrobenchmark

รูปที่ 3 เรียกใช้การทดสอบ Android จากการดำเนินการในแถบด้านข้าง

เมื่อเรียกใช้ภายใน Android Studio เอาต์พุตของบิลด์จะมีรายละเอียดของการปรับปรุงความเร็วที่โปรไฟล์พื้นฐานมีให้ ดังนี้

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

บันทึกเส้นทางโค้ดที่จำเป็นทั้งหมด

เมตริกหลัก 2 รายการสําหรับวัดเวลาเริ่มต้นของแอปมีดังนี้

ระบบจะรายงาน TTFD เมื่อมีการเรียกใช้เมธอด reportFullyDrawn ของ ComponentActivity หากไม่มีการเรียกใช้ reportFullyDrawn ระบบจะรายงาน TTID แทน คุณอาจต้องหน่วงเวลาเมื่อมีการเรียกใช้ reportFullyDrawn จนกว่าการโหลดแบบอะซิงโครนัสจะเสร็จสมบูรณ์ ตัวอย่างเช่น หาก UI มีรายการแบบ Lazy แบบไดนามิก รายการอาจสร้างขึ้นโดยงานเบื้องหลังที่เสร็จสมบูรณ์หลังจากวาดรายการเป็นครั้งแรก และหลังจากที่ UI ได้รับการทำเครื่องหมายว่าวาดเสร็จสมบูรณ์แล้ว ในกรณีเช่นนี้ โค้ดที่ทำงานหลังจาก UI เข้าสู่สถานะวาดเสร็จสมบูรณ์จะไม่รวมอยู่ในโปรไฟล์พื้นฐาน

หากต้องการรวมการสร้างรายการเป็นส่วนหนึ่งของโปรไฟล์พื้นฐาน ให้รับ FullyDrawnReporter โดยใช้ getFullyDrawnReporter และเพิ่ม Reporter ลงในโค้ดแอป ปล่อย Reporter เมื่อพื้นหลังทำงานเสร็จสิ้น สร้างรายการ FullyDrawnReporter จะไม่เรียกใช้เมธอด reportFullyDrawn จนกว่าจะมีการปล่อย Reporter ทั้งหมด การทำเช่นนี้จะทำให้ Baseline Profile มีเส้นทางโค้ดที่จำเป็นในการสร้างรายการ การดำเนินการนี้จะไม่เปลี่ยนลักษณะการทำงานของแอปสำหรับผู้ใช้ แต่จะช่วยให้ Baseline Profile รวมเส้นทางโค้ดที่จำเป็นทั้งหมด

หากต้องการระบุสถานะที่วาดเสร็จสมบูรณ์ ให้ใช้ Compose API ต่อไปนี้

  • ReportDrawn บ่งบอกว่า Composable พร้อมสำหรับการโต้ตอบทันที
  • ReportDrawnWhen ใช้เพรดิเคต เช่น list.count > 0 เพื่อระบุว่า Composable พร้อมสำหรับการโต้ตอบเมื่อใด
  • ReportDrawnAfter ใช้เมธอดการระงับซึ่งเมื่อเสร็จสมบูรณ์แล้วจะบ่งบอกว่า Composable พร้อมสำหรับการโต้ตอบแล้ว
ก่อนหน้า
ภาพรวม
ถัดไป
สร้างโปรไฟล์พื้นฐานสำหรับไลบรารี