การกําหนดค่าบริการ ART

ก่อนเริ่มต้น โปรดดูภาพรวมระดับสูงของบริการ ART

ตั้งแต่ Android 14 เป็นต้นไป การคอมไพล์ AOT ในอุปกรณ์สำหรับแอป (หรือที่เรียกว่า dexopt) จะจัดการโดยบริการ ART บริการ ART เป็นส่วนหนึ่งของโมดูล ART และคุณสามารถปรับแต่งบริการดังกล่าวผ่านพร็อพเพอร์ตี้ระบบและ API ได้

คุณสมบัติของระบบ

บริการ ART รองรับตัวเลือก dex2oat ที่เกี่ยวข้องทั้งหมด

นอกจากนี้ บริการ ART ยังรองรับพร็อพเพอร์ตี้ของระบบต่อไปนี้ด้วย

pm.dexopt.<reason>

นี่คือชุดพร็อพเพอร์ตี้ของระบบที่กำหนดตัวกรองคอมไพเลอร์เริ่มต้นสำหรับเหตุผลในการคอมไพล์ที่กำหนดไว้ล่วงหน้าทั้งหมดซึ่งอธิบายไว้ในสถานการณ์ Dexopt

ดูข้อมูลเพิ่มเติมได้ที่ตัวกรองคอมไพเลอร์

ค่าเริ่มต้นมาตรฐานมีดังนี้

pm.dexopt.first-boot=verify
pm.dexopt.boot-after-ota=verify
pm.dexopt.boot-after-mainline-update=verify
pm.dexopt.bg-dexopt=speed-profile
pm.dexopt.inactive=verify
pm.dexopt.cmdline=verify

pm.dexopt.shared (ค่าเริ่มต้น: speed)

นี่คือตัวกรองคอมไพเลอร์สำรองสำหรับแอปที่แอปอื่นๆ ใช้งาน

โดยหลักการแล้ว บริการ ART จะทำการคอมไพล์ตามโปรไฟล์ (speed-profile) สำหรับแอปทั้งหมดเมื่อเป็นไปได้ ซึ่งโดยปกติจะทำในระหว่าง dexopt ในเบื้องหลัง อย่างไรก็ตาม มีบางแอปที่แอปอื่นๆ ใช้งาน (ผ่าน <uses-library> หรือโหลดแบบไดนามิกโดยใช้ Context#createPackageContext กับ CONTEXT_INCLUDE_CODE) แอปดังกล่าวจะใช้โปรไฟล์ในเครื่องไม่ได้เนื่องจากเหตุผลด้านความเป็นส่วนตัว

สำหรับแอปดังกล่าว หากมีการขอการคอมไพล์ที่ใช้โปรไฟล์เป็นแนวทาง บริการ ART จะพยายามใช้โปรไฟล์ระบบคลาวด์ก่อน หากไม่มีโปรไฟล์ระบบคลาวด์ บริการ ART จะกลับไปใช้ตัวกรองคอมไพเลอร์ที่ระบุโดย pm.dexopt.shared

หากการคอมไพล์ที่ขอไม่ได้อิงตามโปรไฟล์ พร็อพเพอร์ตี้นี้จะไม่มีผล

pm.dexopt.<reason>.concurrency (ค่าเริ่มต้น: 1)

นี่คือจำนวนการเรียกใช้ dex2oat สำหรับเหตุผลในการคอมไพล์ที่กำหนดไว้ล่วงหน้าบางประการ (first-boot, boot-after-ota, boot-after-mainline-update และ bg-dexopt)

โปรดทราบว่าผลลัพธ์ของตัวเลือกนี้จะรวมกับตัวเลือกการใช้ทรัพยากร dex2oat (dalvik.vm.*dex2oat-threads, dalvik.vm.*dex2oat-cpu-set และโปรไฟล์งาน) ดังนี้

  • dalvik.vm.*dex2oat-threads ควบคุมจำนวนชุดข้อความสำหรับการเรียกใช้ dex2oat แต่ละครั้ง ส่วน pm.dexopt.<reason>.concurrency ควบคุมจำนวนการเรียกใช้ dex2oat ซึ่งหมายความว่าจำนวนชุดข้อความที่โหลดพร้อมกันสูงสุดคือผลคูณของพร็อพเพอร์ตี้ทั้ง 2 ของระบบ
  • dalvik.vm.*dex2oat-cpu-set และโปรไฟล์งานจะเชื่อมโยงการใช้งานแกน CPU เสมอ ไม่ว่าจะมีจำนวนเธรดที่เกิดขึ้นพร้อมกันสูงสุดเท่าใดก็ตาม (ตามที่กล่าวถึงข้างต้น)

การเรียกใช้ dex2oat ครั้งเดียวอาจใช้แกน CPU ทั้งหมดได้ไม่เต็มประสิทธิภาพ ไม่ว่า dalvik.vm.*dex2oat-threads จะเป็นอย่างไรก็ตาม ดังนั้น การเพิ่มจำนวนการเรียกใช้ dex2oat (pm.dexopt.<reason>.concurrency) จะช่วยให้ใช้แกน CPU ได้ดีขึ้นเพื่อเร่งความคืบหน้าโดยรวมของ dexopt ซึ่งจะมีประโยชน์อย่างยิ่งในระหว่างการเปิดเครื่อง

อย่างไรก็ตาม การเรียกใช้ dex2oat มากเกินไปอาจทำให้อุปกรณ์หน่วยความจำหมด แม้ว่าจะลดปัญหานี้ได้โดยการตั้งค่า dalvik.vm.dex2oat-swap เป็น true เพื่ออนุญาตให้ใช้ไฟล์สลับ การเรียกใช้มากเกินไปอาจทำให้เกิดการสลับบริบทที่ไม่จำเป็นด้วย ดังนั้น คุณควรปรับแต่งตัวเลขนี้อย่างรอบคอบตามผลิตภัณฑ์แต่ละรายการ

pm.dexopt.downgrade_after_inactive_days (ค่าเริ่มต้น: ไม่ได้ตั้งค่า)

หากตั้งค่าตัวเลือกนี้ บริการ ART จะทำการ Dexopt เฉพาะแอปที่ใช้ภายในจำนวนวันที่ระบุล่าสุดเท่านั้น

นอกจากนี้ หากพื้นที่เก็บข้อมูลเหลือน้อย ในระหว่างการทำ Dexopt ในเบื้องหลัง บริการ ART จะดาวน์เกรดตัวกรองคอมไพเลอร์ของแอปที่ไม่ได้ใช้ภายในจำนวนวันที่กำหนดล่าสุดเพื่อเพิ่มพื้นที่ว่าง เหตุผลของคอมไพเลอร์สำหรับกรณีนี้คือ inactive และตัวกรองคอมไพเลอร์จะกำหนดโดย pm.dexopt.inactive เกณฑ์พื้นที่ว่างในการเรียกใช้ฟีเจอร์นี้คือเกณฑ์พื้นที่ว่างเหลือน้อยของตัวจัดการพื้นที่เก็บข้อมูล (กำหนดค่าได้ผ่านการตั้งค่าส่วนกลาง sys_storage_threshold_percentage และ sys_storage_threshold_max_bytes โดยค่าเริ่มต้นคือ 500 MB) บวก 500 MB

หากคุณปรับแต่งรายการแพ็กเกจผ่าน ArtManagerLocal#setBatchDexoptStartCallback แพ็กเกจในรายการที่ BatchDexoptStartCallback มีให้สำหรับ bg-dexopt จะไม่มีการดาวน์เกรด

pm.dexopt.disable_bg_dexopt (ค่าเริ่มต้น: false)

ใช้สำหรับการทดสอบเท่านั้น ซึ่งจะป้องกันไม่ให้บริการ ART กำหนดเวลางาน dexopt ในเบื้องหลัง

หากมีการกำหนดเวลางาน dexopt ในเบื้องหลังไว้แล้วแต่ยังไม่ได้เรียกใช้ ตัวเลือกนี้จะไม่มีผล กล่าวคือ งานจะยังคงทำงานอยู่

ลำดับคำสั่งที่แนะนำเพื่อป้องกันไม่ให้งาน dexopt ในเบื้องหลังทำงานมีดังนี้

setprop pm.dexopt.disable_bg_dexopt true
pm bg-dexopt-job --disable

บรรทัดแรกจะป้องกันไม่ให้มีการกำหนดเวลางาน dexopt ในเบื้องหลัง หากยังไม่ได้กำหนดเวลา บรรทัดที่ 2 จะยกเลิกการกำหนดเวลางาน dexopt ในเบื้องหลัง หากมีการกำหนดเวลาไว้แล้ว และจะยกเลิกงาน dexopt ในเบื้องหลังทันที หากกำลังทำงานอยู่

API ของบริการ ART

บริการ ART แสดง Java API สำหรับการปรับแต่ง API จะกำหนดไว้ใน ArtManagerLocal ดู Javadoc ใน art/libartservice/service/java/com/android/server/art/ArtManagerLocal.java สำหรับการใช้งาน (แหล่งที่มาของ Android 14, แหล่งที่มาของการพัฒนาที่ยังไม่ได้เผยแพร่)

ArtManagerLocal เป็นซิงเกิลตันที่ LocalManagerRegistry ถืออยู่ ฟังก์ชันตัวช่วย com.android.server.pm.DexOptHelper#getArtManagerLocal จะช่วยให้คุณได้รับข้อมูลนี้

import static com.android.server.pm.DexOptHelper.getArtManagerLocal;

API ส่วนใหญ่ต้องใช้อินสแตนซ์ของ PackageManagerLocal.FilteredSnapshot ซึ่งเก็บข้อมูลของแอปทั้งหมด คุณสามารถรับได้โดยเรียกใช้ PackageManagerLocal#withFilteredSnapshot โดยที่ PackageManagerLocal เป็นซิงเกิลตันที่ LocalManagerRegistry เก็บไว้และรับได้จาก com.android.server.pm.PackageManagerServiceUtils#getPackageManagerLocal

import static com.android.server.pm.PackageManagerServiceUtils.getPackageManagerLocal;

ต่อไปนี้เป็นกรณีการใช้งานทั่วไปของ API

ทริกเกอร์ dexopt สำหรับแอป

คุณเรียกใช้ dexopt สำหรับแอปใดก็ได้ทุกเมื่อโดยเรียกใช้ ArtManagerLocal#dexoptPackage

try (var snapshot = getPackageManagerLocal().withFilteredSnapshot()) {
  getArtManagerLocal().dexoptPackage(
      snapshot,
      "com.google.android.calculator",
      new DexoptParams.Builder(ReasonMapping.REASON_INSTALL).build());
}

นอกจากนี้ คุณยังส่งเหตุผล dexopt ของคุณเองได้ด้วย หากทำเช่นนั้น คุณต้องตั้งค่าคลาสลำดับความสำคัญและตัวกรองคอมไพเลอร์อย่างชัดเจน

try (var snapshot = getPackageManagerLocal().withFilteredSnapshot()) {
  getArtManagerLocal().dexoptPackage(
      snapshot,
      "com.google.android.calculator",
      new DexoptParams.Builder("my-reason")
          .setCompilerFilter("speed-profile")
          .setPriorityClass(ArtFlags.PRIORITY_BACKGROUND)
          .build());
}

ยกเลิก dexopt

หากการดำเนินการเริ่มต้นโดยการเรียก dexoptPackage คุณสามารถส่งสัญญาณการยกเลิก ซึ่งจะช่วยให้คุณยกเลิกการดำเนินการได้ ณ จุดใดจุดหนึ่ง ซึ่งจะมีประโยชน์เมื่อคุณเรียกใช้ dexopt แบบอะซิงโครนัส

Executor executor = ...;  // Your asynchronous executor here.
var cancellationSignal = new CancellationSignal();
executor.execute(() -> {
  try (var snapshot = getPackageManagerLocal().withFilteredSnapshot()) {
    getArtManagerLocal().dexoptPackage(
        snapshot,
        "com.google.android.calculator",
        new DexoptParams.Builder(ReasonMapping.REASON_INSTALL).build(),
        cancellationSignal);
  }
});

// When you want to cancel the operation.
cancellationSignal.cancel();

นอกจากนี้ คุณยังยกเลิก dexopt ในเบื้องหลังซึ่งเริ่มต้นโดยบริการ ART ได้ด้วย

getArtManagerLocal().cancelBackgroundDexoptJob();

ดูผลลัพธ์ dexopt

หากการดำเนินการเริ่มต้นโดยการเรียกใช้ dexoptPackage คุณจะดูผลลัพธ์ได้จากค่าที่แสดงผล

DexoptResult result;
try (var snapshot = getPackageManagerLocal().withFilteredSnapshot()) {
  result = getArtManagerLocal().dexoptPackage(...);
}

// Process the result here.
...

นอกจากนี้ ART Service ยังเริ่มการดำเนินการ dexopt ด้วยตนเองในหลายสถานการณ์ เช่น dexopt ในเบื้องหลัง หากต้องการฟังผลลัพธ์ dexopt ทั้งหมด ไม่ว่าการดำเนินการจะเริ่มต้นโดยการเรียก dexoptPackage หรือโดย ART Service ให้ใช้ ArtManagerLocal#addDexoptDoneCallback

getArtManagerLocal().addDexoptDoneCallback(
    false /* onlyIncludeUpdates */,
    Runnable::run,
    (result) -> {
      // Process the result here.
      ...
    });

อาร์กิวเมนต์แรกจะกำหนดว่าจะรวมเฉพาะการอัปเดตในผลลัพธ์หรือไม่ หากต้องการฟังเฉพาะแพ็กเกจที่อัปเดตโดย dexopt ให้ตั้งค่าเป็น "จริง"

อาร์กิวเมนต์ที่ 2 คือผู้ดำเนินการของ Callback หากต้องการเรียกกลับในชุดข้อความเดียวกันกับที่ดำเนินการ dexopt ให้ใช้ Runnable::run หากไม่ต้องการให้ Callback บล็อก dexopt ให้ใช้ Executor แบบอะซิงโครนัส

คุณสามารถเพิ่ม Callback ได้หลายรายการ และบริการ ART จะเรียกใช้ Callback ทั้งหมดตามลำดับ Callback ทั้งหมดจะยังคงทำงานอยู่สำหรับการโทรในอนาคตทั้งหมด เว้นแต่คุณจะนำออก

หากต้องการนำ Callback ออก ให้เก็บข้อมูลอ้างอิงของ Callback ไว้เมื่อเพิ่ม และใช้ ArtManagerLocal#removeDexoptDoneCallback

DexoptDoneCallback callback = (result) -> {
  // Process the result here.
  ...
};

getArtManagerLocal().addDexoptDoneCallback(
    false /* onlyIncludeUpdates */, Runnable::run, callback);

// When you want to remove it.
getArtManagerLocal().removeDexoptDoneCallback(callback);

ปรับแต่งรายการแพ็กเกจและพารามิเตอร์ dexopt

บริการ ART จะเริ่มการดำเนินการ dexopt เองในระหว่างการเปิดเครื่องและ dexopt ในเบื้องหลัง หากต้องการปรับแต่งรายการแพ็กเกจหรือพารามิเตอร์ dexopt สำหรับการดำเนินการเหล่านั้น ให้ใช้ ArtManagerLocal#setBatchDexoptStartCallback

getArtManagerLocal().setBatchDexoptStartCallback(
    Runnable::run,
    (snapshot, reason, defaultPackages, builder, cancellationSignal) -> {
      switch (reason) {
        case ReasonMapping.REASON_BG_DEXOPT:
          var myPackages = new ArrayList<String>(defaultPackages);
          myPackages.add(...);
          myPackages.remove(...);
          myPackages.sort(...);
          builder.setPackages(myPackages);
          break;
        default:
          // Ignore unknown reasons.
      }
    });

คุณสามารถเพิ่มรายการลงในรายการแพ็กเกจ นำรายการออก จัดเรียง หรือแม้แต่ใช้รายการอื่นที่แตกต่างไปจากเดิมอย่างสิ้นเชิง

Callback ต้องละเว้นเหตุผลที่ไม่รู้จักเนื่องจากอาจมีการเพิ่มเหตุผลอื่นๆ ในอนาคต

คุณตั้งค่า BatchDexoptStartCallback ได้สูงสุด 1 รายการ การติดต่อกลับจะยังคงทำงานอยู่สำหรับการโทรในอนาคตทั้งหมด เว้นแต่คุณจะล้างข้อมูล

หากต้องการล้าง Callback ให้ใช้ ArtManagerLocal#clearBatchDexoptStartCallback

getArtManagerLocal().clearBatchDexoptStartCallback();

ปรับแต่งพารามิเตอร์ของงาน dexopt ในเบื้องหลัง

โดยค่าเริ่มต้น งาน dexopt ในเบื้องหลังจะทำงานวันละครั้งเมื่ออุปกรณ์ไม่มีการใช้งานและกำลังชาร์จ ซึ่งเปลี่ยนแปลงได้โดยใช้ ArtManagerLocal#setScheduleBackgroundDexoptJobCallback

getArtManagerLocal().setScheduleBackgroundDexoptJobCallback(
    Runnable::run,
    builder -> {
      builder.setPeriodic(TimeUnit.DAYS.toMillis(2));
    });

คุณตั้งค่า ScheduleBackgroundDexoptJobCallback ได้สูงสุด 1 รายการ Callback จะยังคงทำงานอยู่สำหรับการโทรในอนาคตทั้งหมด เว้นแต่คุณจะล้างออก

หากต้องการล้าง Callback ให้ใช้ ArtManagerLocal#clearScheduleBackgroundDexoptJobCallback

getArtManagerLocal().clearScheduleBackgroundDexoptJobCallback();

ปิดใช้ dexopt ชั่วคราว

การดำเนินการ dexopt ที่เริ่มต้นโดยบริการ ART จะทริกเกอร์ BatchDexoptStartCallback คุณสามารถยกเลิกการดำเนินการต่อไปเพื่อปิดใช้ dexopt ได้อย่างมีประสิทธิภาพ

หากการดำเนินการที่คุณยกเลิกคือ dexopt ในเบื้องหลัง ระบบจะทำตามนโยบายการลองใหม่เริ่มต้น (30 วินาที, แบบทวีคูณ, สูงสุด 5 ชั่วโมง)

// Good example.

var shouldDisableDexopt = new AtomicBoolean(false);

getArtManagerLocal().setBatchDexoptStartCallback(
    Runnable::run,
    (snapshot, reason, defaultPackages, builder, cancellationSignal) -> {
      if (shouldDisableDexopt.get()) {
        cancellationSignal.cancel();
      }
    });

// Disable dexopt.
shouldDisableDexopt.set(true);
getArtManagerLocal().cancelBackgroundDexoptJob();

// Re-enable dexopt.
shouldDisableDexopt.set(false);

คุณมี BatchDexoptStartCallback ได้สูงสุด 1 รายการ หากต้องการใช้ BatchDexoptStartCallback เพื่อปรับแต่งรายการแพ็กเกจหรือพารามิเตอร์ dexopt ด้วย คุณต้องรวมโค้ดไว้ใน Callback เดียว

// Bad example.

// Disable dexopt.
getArtManagerLocal().unscheduleBackgroundDexoptJob();

// Re-enable dexopt.
getArtManagerLocal().scheduleBackgroundDexoptJob();

การดำเนินการ dexopt ที่ทำกับการติดตั้งแอปไม่ได้เริ่มต้นโดยบริการ ART แต่จะเริ่มต้นโดยเครื่องมือจัดการแพ็กเกจผ่านการเรียก dexoptPackage ดังนั้นจึงไม่ทริกเกอร์ BatchDexoptStartCallback หากต้องการปิดใช้ dexopt ในการติดตั้งแอป ให้ป้องกันไม่ให้เครื่องมือจัดการแพ็กเกจเรียกใช้ dexoptPackage

ลบล้างตัวกรองคอมไพเลอร์สำหรับบางแพ็กเกจ (Android 15 ขึ้นไป)

คุณสามารถลบล้างตัวกรองคอมไพเลอร์สำหรับบางแพ็กเกจได้โดยลงทะเบียน Callback ผ่าน setAdjustCompilerFilterCallback ระบบจะเรียกใช้ Callback เมื่อใดก็ตามที่แพ็กเกจกำลังจะได้รับการเพิ่มประสิทธิภาพ Dex ไม่ว่าการเพิ่มประสิทธิภาพ Dex จะเริ่มต้นโดยบริการ ART ระหว่างการเปิดเครื่องและการเพิ่มประสิทธิภาพ Dex ในเบื้องหลัง หรือโดยการเรียก API dexoptPackage

หากแพ็กเกจไม่จำเป็นต้องมีการปรับเปลี่ยน Callback ต้องแสดงผลเป็น originalCompilerFilter

getArtManagerLocal().setAdjustCompilerFilterCallback(
    Runnable::run,
    (packageName, originalCompilerFilter, reason) -> {
      if (isVeryImportantPackage(packageName)) {
        return "speed-profile";
      }
      return originalCompilerFilter;
    });

คุณตั้งค่า AdjustCompilerFilterCallback ได้เพียงรายการเดียวเท่านั้น หากต้องการใช้ AdjustCompilerFilterCallback เพื่อลบล้างตัวกรองคอมไพเลอร์สำหรับหลายแพ็กเกจ คุณต้องรวมโค้ดไว้ใน Callback เดียว การติดต่อกลับจะยังคงทำงานอยู่สำหรับการโทรในอนาคตทั้งหมด เว้นแต่คุณจะล้างข้อมูล

หากต้องการล้าง Callback ให้ใช้ ArtManagerLocal#clearAdjustCompilerFilterCallback

getArtManagerLocal().clearAdjustCompilerFilterCallback();

การปรับแต่งอื่นๆ

นอกจากนี้ ART Service ยังรองรับการปรับแต่งอื่นๆ ด้วย

ตั้งค่าเกณฑ์ความร้อนสำหรับ dexopt ในเบื้องหลัง

การควบคุมความร้อนของงาน dexopt ในเบื้องหลังจะดำเนินการโดย Job Scheduler ระบบจะยกเลิกงานทันทีเมื่ออุณหภูมิถึง THERMAL_STATUS_MODERATE เกณฑ์ของ THERMAL_STATUS_MODERATE สามารถปรับได้

ตรวจสอบว่า dexopt ในเบื้องหลังทำงานอยู่หรือไม่

งาน dexopt ในเบื้องหลังจะจัดการโดย Job Scheduler และรหัสงานคือ 27873780 หากต้องการตรวจสอบว่างานทำงานใน Android 16 ขึ้นไปหรือไม่ ให้ใช้ JobScheduler#getPendingJobReasons (ใน Android 14 และ 15 ให้ใช้ JobScheduler#getPendingJobReason แทน)

// Good example (Android 16 and higher).

var jobScheduler =
    Objects.requireNonNull(mContext.getSystemService(JobScheduler.class));
int[] reasons = jobScheduler.getPendingJobReasons(27873780);

if (Arrays.stream(reasons).anyMatch(r -> r == PENDING_JOB_REASON_EXECUTING)) {
  // Do something when the job is running.
  ...
}
// Bad example.

var backgroundDexoptRunning = new AtomicBoolean(false);

getArtManagerLocal().setBatchDexoptStartCallback(
    Runnable::run,
    (snapshot, reason, defaultPackages, builder, cancellationSignal) -> {
      if (reason.equals(ReasonMapping.REASON_BG_DEXOPT)) {
        backgroundDexoptRunning.set(true);
      }
    });

getArtManagerLocal().addDexoptDoneCallback(
    false /* onlyIncludeUpdates */,
    Runnable::run,
    (result) -> {
      if (result.getReason().equals(ReasonMapping.REASON_BG_DEXOPT)) {
        backgroundDexoptRunning.set(false);
      }
    });

if (backgroundDexoptRunning.get()) {
  // Do something when the job is running.
  ...
}

ระบุโปรไฟล์สำหรับ dexopt

หากต้องการใช้โปรไฟล์เพื่อเป็นแนวทางในการทำ dexopt ให้ใส่ไฟล์ .prof หรือไฟล์ .dm ไว้ข้าง APK

ไฟล์ .prof ต้องเป็นไฟล์โปรไฟล์รูปแบบไบนารี และชื่อไฟล์ต้องเป็นชื่อไฟล์ของ APK + .prof ตัวอย่างเช่น

base.apk.prof

ชื่อไฟล์ของไฟล์ .dm ต้องเป็นชื่อไฟล์ของ APK ที่มีนามสกุลแทนที่ด้วย .dm ตัวอย่างเช่น

base.dm

หากต้องการยืนยันว่ามีการใช้โปรไฟล์สำหรับ dexopt ให้เรียกใช้ dexopt ด้วย speed-profile แล้วตรวจสอบผลลัพธ์

pm art clear-app-profiles <package-name>
pm compile -m speed-profile -f -v <package-name>

บรรทัดแรกจะล้างโปรไฟล์ทั้งหมดที่รันไทม์สร้างขึ้น (เช่น โปรไฟล์ใน /data/misc/profiles) หากมี เพื่อให้แน่ใจว่าโปรไฟล์ที่อยู่ถัดจาก APK เป็นโปรไฟล์เดียวที่บริการ ART สามารถใช้ได้ บรรทัดที่ 2 จะเรียกใช้ dexopt ด้วย speed-profile และส่ง -v เพื่อพิมพ์ผลลัพธ์แบบละเอียด

หากมีการใช้โปรไฟล์อยู่ คุณจะเห็น actualCompilerFilter=speed-profile ในผลลัพธ์ ไม่เช่นนั้น คุณจะเห็น actualCompilerFilter=verify ตัวอย่างเช่น

DexContainerFileDexoptResult{dexContainerFile=/data/app/~~QR0fTV0UbDbIP1Su7XzyPg==/com.google.android.gms-LvusF2uARKOtBbcaPHdUtQ==/base.apk, primaryAbi=true, abi=x86_64, actualCompilerFilter=speed-profile, status=PERFORMED, dex2oatWallTimeMillis=4549, dex2oatCpuTimeMillis=14550, sizeBytes=3715344, sizeBeforeBytes=3715344}

สาเหตุที่พบบ่อยที่ทำให้บริการ ART ไม่ใช้โปรไฟล์มีดังนี้

  • โปรไฟล์มีชื่อไฟล์ไม่ถูกต้องหรือไม่ได้อยู่ติดกับ APK
  • โปรไฟล์อยู่ในรูปแบบที่ไม่ถูกต้อง
  • โปรไฟล์ไม่ตรงกับ APK (การตรวจสอบข้อผิดพลาดในโปรไฟล์ไม่ตรงกับการตรวจสอบข้อผิดพลาดของไฟล์ .dex ใน APK)