إعدادات خدمة ART

قبل البدء، يمكنك إلقاء نظرة عامة وشاملة على خدمة ART.

بدءًا من الإصدار Android 14، ستتوفر ميزة تجميع AOT على الجهاز فقط معالجة التطبيقات (المعروفة أيضًا باسم dexopt) من خلال خدمة ART. خدمة ART هي جزء من ART ويمكنك تخصيصه من خلال خصائص النظام وواجهات برمجة التطبيقات.

خصائص النظام

تدعم خدمة ART جميع خيارات dex2oat

بالإضافة إلى ذلك، تتوافق خدمة ART مع خصائص النظام التالية:

pm.dexopt.<reason>

هذا عبارة عن مجموعة من خصائص النظام التي تحدد عوامل تصفية التجميع التلقائي لكل أسباب التجميع المحددة مسبقًا والموضحة في سيناريوهات إيقاف عرض المحتوى.

لمزيد من المعلومات، يُرجى مراجعة فلاتر برامج التجميع:

القيم التلقائية العادية هي:

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 (الإعداد التلقائي: السرعة)

هذا هو فلتر التجميع الاحتياطي للتطبيقات التي تستخدمها التطبيقات الأخرى.

من حيث المبدأ، تقدّم خدمة ART عملية تجميع إرشادي للملف الشخصي (speed-profile) لـ جميع التطبيقات متى أمكن، وذلك عادةً أثناء تشغيل البيانات في الخلفية. ومع ذلك، هناك بعض التطبيقات التي تستخدمها تطبيقات أخرى (إما من خلال <uses-library> أو تم تحميلها استخدام Context#createPackageContext ديناميكيًا مع CONTEXT_INCLUDE_CODE). ولا يمكن لهذه التطبيقات استخدام دليل الشخصية لأسباب تتعلق بالخصوصية.

بالنسبة إلى هذا التطبيق، في حال طلب تجميع إرشادي من خلال الملف الشخصي، تكون خدمة ART أولاً محاولة استخدام ملف تعريف على السحابة. في حال عدم توفّر ملف شخصي في السحابة الإلكترونية، ART Service لاستخدام فلتر التجميع المحدد بواسطة 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. وهذا يعني أنّ الحد الأقصى لعدد سلاسل المحادثات المتزامنة هو ناتج خاصيتَي النظام.
• ربط dalvik.vm.*dex2oat-cpu-set والملفات الشخصية للمهام دائمًا بوحدة المعالجة المركزية (CPU) الأساسية الاستخدام، بغض النظر عن الحد الأقصى لعدد سلاسل المحادثات المتزامنة (تمت مناقشتها أعلاه).

قد لا يستخدم استدعاء dex2oat واحد جميع نوى وحدة المعالجة المركزية (CPU) بشكل كامل، بغض النظر عن من dalvik.vm.*dex2oat-threads. وبالتالي، تؤدي زيادة عدد dex2oat للاستدعاءات (pm.dexopt.<reason>.concurrency) يمكن أن تستخدم نوى وحدة المعالجة المركزية بشكل أفضل، وتسريع التقدم الإجمالي لـ dexopt. يكون هذا مفيدًا بشكل خاص أثناء .

ومع ذلك، قد يؤدي وجود عدد كبير جدًا من استدعاءات dex2oat إلى نفاد مساحة على الرغم من أنّه يمكن الحدّ من حدوث ذلك عن طريق ضبط dalvik.vm.dex2oat-swap على true للسماح باستخدام ملف تبديل. قد يتسبب عدد كبير جدًا من الاستدعاءات أيضًا في التبديل غير الضروري للسياق. لذلك، يجب ضبط هذا الرقم بعناية على أساس كل منتج على حدة.

pm.dexopt.downgrad_after_inactive_days (الإعداد التلقائي: لم يتم الضبط)

وإذا تم تعيين هذا الخيار، لا تعتمد خدمة ART إلا التطبيقات المستخدمة ضمن آخر تطبيق عدد الأيام.

بالإضافة إلى ذلك، إذا كانت مساحة التخزين منخفضة تقريبًا، يمكن استخدام خدمة ART أثناء الاستخدام في الخلفية. خفض مستوى فلتر التجميع للتطبيقات التي لا يتم استخدامها خلال آخر مرة عدد الأيام لإخلاء بعض المساحة. سبب التجميع لذلك هو inactive، ويتم تحديد عامل تصفية التجميع بواسطة pm.dexopt.inactive. المساحة إنّ الحدّ الأدنى لتفعيل هذه الميزة هو الحدّ الأدنى للمساحة المنخفضة في "أداة إدارة مساحة التخزين". (قابلة للتهيئة من خلال الإعدادات العامة sys_storage_threshold_percentage sys_storage_threshold_max_bytes، الحجم التلقائي: 500 ميغابايت) بالإضافة إلى 500 ميغابايت.

إذا قمت بتخصيص قائمة الحزم من خلال ArtManagerLocal#setBatchDexoptStartCallback، الحِزم في القائمة المتوفّرة بحلول BatchDexoptStartCallback لـ bg-dexopt، لا يتم إرجاعها إلى إصدار سابق مطلقًا.

pm.dexopt.disable_bg_dexopt (القيمة التلقائية: خطأ)

هذه الميزة مخصَّصة للاختبار فقط. يمنع خدمة ART من جدولة الخلفية. وظيفة dexopt.

إذا تمت جدولة مهمة dexopt في الخلفية من قبل، ولكن لم يتم تشغيلها بعد، سيتم لن يكون له أي تأثير. وهذا يعني أن الوظيفة ستستمر.

يشير هذا المصطلح إلى تسلسل مقترَح من الأوامر لمنع مهمة تحسين الخلفية من الجري هو:

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

يمنع السطر الأول جدولة مهمة ضبط الخلفية، إذا كانت لم يتم تحديد موعدها بعد. يلغي السطر الثاني جدولة مهمة ضبط الخلفية، إذا إلا أنه قد تمت جدولته مسبقًا، ويلغي فورًا مهمة ضبط الخلفية، إذا إنه قيد التشغيل.

واجهات برمجة التطبيقات لخدمة ART

تعرض خدمة ART واجهات برمجة تطبيقات Java للتخصيص. يتم تحديد واجهات برمجة التطبيقات في 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;

تتطلّب معظم واجهات برمجة التطبيقات نسخة افتراضية من PackageManagerLocal.FilteredSnapshot، الذي يحتفظ بمعلومات جميع التطبيقات. يمكنك الحصول عليه من خلال الاتصال PackageManagerLocal#withFilteredSnapshot، حيث PackageManagerLocal أيضًا سينجلتون الذي يحمله LocalManagerRegistry ويمكن الحصول عليه من com.android.server.pm.PackageManagerServiceUtils#getPackageManagerLocal

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

في ما يلي بعض حالات الاستخدام النموذجي لواجهات برمجة التطبيقات.

تشغيل dexopt لأحد التطبيقات

يمكنك تفعيل dexopt أيّ تطبيق في أي وقت من خلال الاتصال. ArtManagerLocal#dexoptPackage

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

يمكنك أيضًا اختيار سبب إثبات الملكية الخاص بك. إذا قمت بذلك، فسيتم تحديد فئة الأولوية يجب تعيين عامل تصفية التجميع بشكل صريح.

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());
}

إلغاء الاشتراك

في حال بدء عملية من خلال استدعاء 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 أيضًا عمليات التشغيل بنفسها في العديد من السيناريوهات، مثل تحسين الخلفية للاستماع إلى جميع نتائج dexopt، سواء كانت العملية تبدأه مكالمة dexoptPackage أو من خلال خدمة ART، استخدم ArtManagerLocal#addDexoptDoneCallback

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

وتحدِّد الوسيطة الأولى ما إذا كان سيتم تضمين التعديلات في النتيجة فقط أم لا. في حال حذف فإنك تريد فقط الاستماع إلى الحزم التي يتم تحديثها بواسطة dexopt، فما عليك سوى تعيينها على true.

الوسيطة الثانية هي منفذ تنفيذ رد الاتصال. لتنفيذ معاودة الاتصال على سلسلة المحادثات نفسها التي تنفّذ dexopt، استخدِم Runnable::run. إذا كنت لا تريد أن طلب معاودة الاتصال لحظر dexopt، استخدام برنامج تنفيذ غير متزامن.

يمكنك إضافة عدة استدعاءات، وستنفذ خدمة ART جميع عمليات الاستدعاء. بالتتابع. ستظلّ جميع عمليات معاودة الاتصال نشطة لجميع المكالمات المستقبلية ما لم تزيلها.

إذا كنت تريد إزالة معاودة الاتصال، احتفظ بمرجع معاودة الاتصال عند وإضافته واستخدام 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 لتلك العمليات، استخدام 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.
      }
    });

يمكنك إضافة عناصر إلى قائمة الحزم أو إزالة عناصر منها أو فرزها أو حتى تستخدم قائمة مختلفة تمامًا.

يجب أن تتجاهل معاودة الاتصال أسبابًا غير معروفة، لأنّه قد تتم إضافة المزيد من الأسباب في المستقبل.

يمكنك ضبط BatchDexoptStartCallback واحد كحدّ أقصى. ستبقى ميزة معاودة الاتصال كما هي نشطة لجميع المكالمات المستقبلية ما لم تمسحها.

إذا كنت تريد محو معاودة الاتصال، فاستخدم ArtManagerLocal#clearBatchDexoptStartCallback

getArtManagerLocal().clearBatchDexoptStartCallback();

تخصيص مَعلمات مهمة ضبط الخلفية

يتم تلقائيًا تنفيذ مهمة ضبط الخلفية مرة واحدة في اليوم عندما يكون الجهاز غير نشِط لفترة قصيرة. والشحن. يمكن تغيير ذلك باستخدام ArtManagerLocal#setScheduleBackgroundDexoptJobCallback

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

يمكنك ضبط ScheduleBackgroundDexoptJobCallback واحد كحدّ أقصى. الإجراء الذي سينفّذه معاودة الاتصال ستظل نشطة لجميع المكالمات المستقبلية ما لم تقوم بمحوها.

إذا كنت تريد محو معاودة الاتصال، فاستخدم ArtManagerLocal#clearScheduleBackgroundDexoptJobCallback

getArtManagerLocal().clearScheduleBackgroundDexoptJobCallback();

إيقاف 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 واحد على الأكثر. إذا كنت تريد أيضًا استخدام BatchDexoptStartCallback لتخصيص قائمة الحزم أو معلمات dexopt، يجب عليك دمج الرمز في معاودة اتصال واحدة.

// Bad example.

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

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

لا تبدأ ART عملية الاعتماد التي يتم إجراؤها عند تثبيت التطبيق الخدمة. بدلاً من ذلك، يتم بدؤه بواسطة مدير الحزمة من خلال مكالمة dexoptPackage. لذلك، لا يؤدي إلى تشغيل BatchDexoptStartCallback ولإيقافها عند تثبيت التطبيق، عليك منع مدير الحزمة من الاتصال بـ dexoptPackage.

تجاهُل فلتر برنامج التجميع في حِزم معيّنة (إصدار Android 15 (الإصدار التجريبي من AOSP) أو الإصدارات الأحدث)

يمكنك تجاوز عامل تصفية التجميع لحزم معينة من خلال تسجيل حتى setAdjustCompilerFilterCallback. تُسمى معاودة الاتصال متى يتم استخدام أي حزمة، بغض النظر عن بدء عملية العرض خدمة ART أثناء تشغيل الجهاز وفي الخلفية أو من خلال طلب بيانات من واجهة برمجة التطبيقات dexoptPackage

إذا كانت الحزمة لا تحتاج إلى تعديل، يجب أن يعود رد الاتصال originalCompilerFilter

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

يمكنك ضبط سمة AdjustCompilerFilterCallback واحدة فقط. إذا كنت تريد استخدام AdjustCompilerFilterCallback لإلغاء عامل تصفية التجميع لبرامج متعددة ، فيجب دمج التعليمة البرمجية في معاودة اتصال واحدة. تظل معاودة الاتصال نشطة لجميع المكالمات المستقبلية ما لم تمسحها.

إذا كنت تريد محو معاودة الاتصال، فاستخدم ArtManagerLocal#clearAdjustCompilerFilterCallback

getArtManagerLocal().clearAdjustCompilerFilterCallback();

تخصيصات أخرى

توفّر خدمة ART أيضًا بعض التخصيصات الأخرى.

ضبط الحدّ الأدنى لدرجة الحرارة في الخلفية

يتم تنفيذ التحكُّم الحراري في مهمة ضبط الخلفية من خلال أداة جدولة المهام. يتم إلغاء المهمة فورًا عندما تصل درجة الحرارة إلى THERMAL_STATUS_MODERATE الحد الأدنى THERMAL_STATUS_MODERATE قابل للضبط.

تحديد ما إذا كان dexopt في الخلفية أم لا

تتم إدارة مهمة dexopt في الخلفية من خلال Job Scheduler، ومعرّف الوظيفة 27873780 لتحديد ما إذا كانت المهمة قيد التشغيل، استخدِم واجهات برمجة التطبيقات Job Scheduler API.

// Good example.

var jobScheduler =
    Objects.requireNonNull(mContext.getSystemService(JobScheduler.class));
int reason = jobScheduler.getPendingJobReason(27873780);

if (reason == 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.
  ...
}

توفير ملف شخصي للفهرسة

لاستخدام ملف شخصي لتوجيه عملية التحكّم، ضَع ملف .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. يشغِّل السطر الثاني 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).