शुरू करने से पहले, ART सेवा के बारे में खास जानकारी देखें.
Android 14 से, ऐप्लिकेशन के लिए उपयोगकर्ता के डिवाइस पर एओटी कंपाइलेशन (dexopt) को Android रनटाइम सर्विस मैनेज करती है. ART Service, ART मॉड्यूल का हिस्सा है. इसे सिस्टम प्रॉपर्टी और एपीआई की मदद से, अपनी पसंद के मुताबिक बनाया जा सकता है.
सिस्टम की विशेषताएं
ART सर्विस, काम के सभी dex2oat विकल्पों के साथ काम करती है.
इसके अलावा, ART Service में ये सिस्टम प्रॉपर्टी काम करती हैं:
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-profile) करती है. ऐसा आम तौर पर, बैकग्राउंड में dexopt के दौरान होता है. हालांकि, कुछ ऐप्लिकेशन ऐसे होते हैं जिनका इस्तेमाल दूसरे ऐप्लिकेशन करते हैं. इसके लिए, वे <uses-library> का इस्तेमाल करते हैं या CONTEXT_INCLUDE_CODE के साथ Context#createPackageContext का इस्तेमाल करके, डाइनैमिक तरीके से लोड होते हैं. निजता की वजहों से, ऐसे ऐप्लिकेशन लोकल प्रोफ़ाइल का इस्तेमाल नहीं कर सकते.
अगर ऐसे किसी ऐप्लिकेशन के लिए, प्रोफ़ाइल के हिसाब से कंपाइलेशन का अनुरोध किया जाता है, तो ART Service सबसे पहले क्लाउड प्रोफ़ाइल का इस्तेमाल करने की कोशिश करती है. अगर कोई क्लाउड प्रोफ़ाइल मौजूद नहीं है, तो ART Service, pm.dexopt.shared के तय किए गए कंपाइलर फ़िल्टर का इस्तेमाल करती है.
अगर अनुरोध किया गया कंपाइलेशन, प्रोफ़ाइल के हिसाब से नहीं है, तो इस प्रॉपर्टी का कोई असर नहीं होगा.
pm.dexopt.<reason>.concurrency (डिफ़ॉल्ट: 1)
यह पहले से तय किए गए कुछ कंपाइलेशन की वजहों (first-boot, boot-after-ota, boot-after-mainline-update, और bg-dexopt) के लिए, dex2oat को शुरू करने की संख्या है.
ध्यान दें कि इस विकल्प का असर, dex2oat के संसाधन के इस्तेमाल से जुड़े विकल्पों (dalvik.vm.*dex2oat-threads, dalvik.vm.*dex2oat-cpu-set, और टास्क प्रोफ़ाइल) के साथ मिलकर होता है:
dalvik.vm.*dex2oat-threads, हर dex2oat invocation के लिए थ्रेड की संख्या को कंट्रोल करता है. वहीं,pm.dexopt.<reason>.concurrency, dex2oat invocation की संख्या को कंट्रोल करता है. इसका मतलब है कि एक साथ चलने वाले थ्रेड की ज़्यादा से ज़्यादा संख्या, सिस्टम की दो प्रॉपर्टी का प्रॉडक्ट होती है.dalvik.vm.*dex2oat-cpu-setऔर टास्क प्रोफ़ाइलें, सीपीयू कोर के इस्तेमाल को हमेशा सीमित रखती हैं. भले ही, एक साथ चलने वाले थ्रेड की संख्या ज़्यादा से ज़्यादा हो (इसके बारे में ऊपर बताया गया है).
ऐसा हो सकता है कि एक dex2oat invocation, सभी सीपीयू कोर का पूरी तरह से इस्तेमाल न करे. भले ही, dalvik.vm.*dex2oat-threads की वैल्यू कुछ भी हो. इसलिए, dex2oat को शुरू करने की संख्या (pm.dexopt.<reason>.concurrency) बढ़ाने से, सीपीयू कोर का बेहतर इस्तेमाल किया जा सकता है. इससे dexopt की प्रोसेस को तेज़ किया जा सकता है. यह खास तौर पर बूट के दौरान काम आता है.
हालांकि, dex2oat को बहुत ज़्यादा बार शुरू करने से, डिवाइस की मेमोरी खत्म हो सकती है. हालांकि, dalvik.vm.dex2oat-swap को true पर सेट करके, स्वैप फ़ाइल का इस्तेमाल करने की अनुमति दी जा सकती है. इससे इस समस्या को कम किया जा सकता है. बहुत ज़्यादा इनवोकेशन की वजह से,
कॉन्टेक्स्ट स्विचिंग की ज़रूरत पड़ सकती है. इसलिए, हर प्रॉडक्ट के लिए इस संख्या को ध्यान से सेट करना चाहिए.
pm.dexopt.downgrade_after_inactive_days (डिफ़ॉल्ट: सेट नहीं है)
अगर यह विकल्प सेट है, तो ART Service सिर्फ़ उन ऐप्लिकेशन को dexopt करती है जिन्हें पिछले कुछ दिनों में इस्तेमाल किया गया है.
इसके अलावा, अगर स्टोरेज कम है, तो बैकग्राउंड में dexopt के दौरान, 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 (डिफ़ॉल्ट: false)
यह सिर्फ़ टेस्टिंग के लिए है. यह ART Service को बैकग्राउंड में dexopt जॉब शेड्यूल करने से रोकता है.
अगर बैकग्राउंड में dexopt जॉब पहले से शेड्यूल है, लेकिन अब तक नहीं चला है, तो इस विकल्प का कोई असर नहीं होगा. इसका मतलब है कि जॉब अब भी चलेगा.
बैकग्राउंड में dexopt जॉब को चलने से रोकने के लिए, कमांड का यह क्रम अपनाने का सुझाव दिया जाता है:
setprop pm.dexopt.disable_bg_dexopt true
pm bg-dexopt-job --disable
पहली लाइन, बैकग्राउंड में dexopt जॉब को शेड्यूल होने से रोकती है. ऐसा तब होता है, जब उसे अब तक शेड्यूल न किया गया हो. दूसरी लाइन, बैकग्राउंड में dexopt जॉब को अनशेड्यूल करती है. ऐसा तब होता है, जब वह पहले से शेड्यूल हो. साथ ही, अगर बैकग्राउंड में dexopt जॉब चल रहा है, तो उसे तुरंत रद्द कर देती है.
ART Service API
ART सेवा, ज़रूरत के मुताबिक बदलाव करने के लिए Java एपीआई उपलब्ध कराती है. एपीआई के बारे में
ArtManagerLocal में बताया गया है. इस्तेमाल के लिए, art/libartservice/service/java/com/android/server/art/ArtManagerLocal.java में Javadoc देखें (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 को ट्रिगर करना
ArtManagerLocal#dexoptPackage को कॉल करके, किसी भी ऐप्लिकेशन के लिए dexopt को कभी भी ट्रिगर किया जा सकता है.
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 को रद्द करने का विकल्प भी होता है. इसे एआरटी सर्विस शुरू करती है.
getArtManagerLocal().cancelBackgroundDexoptJob();
dexopt के नतीजे पाएं
अगर किसी कार्रवाई को dexoptPackage कॉल से शुरू किया जाता है, तो आपको रिटर्न वैल्यू से नतीजा मिल सकता है.
DexoptResult result;
try (var snapshot = getPackageManagerLocal().withFilteredSnapshot()) {
result = getArtManagerLocal().dexoptPackage(...);
}
// Process the result here.
...
ART Service, कई मामलों में dexopt की प्रोसेस को खुद भी शुरू करती है. जैसे, बैकग्राउंड में dexopt की प्रोसेस. dexopt के सभी नतीजे सुनने के लिए, ArtManagerLocal#addDexoptDoneCallback का इस्तेमाल करें. इससे कोई फ़र्क़ नहीं पड़ता कि कार्रवाई dexoptPackage कॉल से शुरू की गई है या ART Service से.
getArtManagerLocal().addDexoptDoneCallback(
false /* onlyIncludeUpdates */,
Runnable::run,
(result) -> {
// Process the result here.
...
});
पहले आर्ग्युमेंट से यह तय होता है कि नतीजे में सिर्फ़ अपडेट शामिल करने हैं या नहीं. अगर आपको सिर्फ़ dexopt से अपडेट किए गए पैकेज सुनने हैं, तो इसे 'सही है' पर सेट करें.
दूसरा आर्ग्युमेंट, कॉलबैक को एक्ज़ीक्यूट करने वाला होता है. dexopt को पूरा करने वाले थ्रेड पर कॉलबैक को लागू करने के लिए, Runnable::run का इस्तेमाल करें. अगर आपको dexopt को ब्लॉक करने के लिए कॉलबैक नहीं चाहिए, तो एसिंक्रोनस एक्ज़ीक्यूटर का इस्तेमाल करें.
एक से ज़्यादा कॉलबैक जोड़े जा सकते हैं. एआरटी सर्विस, उन सभी को क्रम से लागू करेगी. जब तक आप कॉलबैक को नहीं हटाते, तब तक वे आने वाले सभी कॉल के लिए चालू रहेंगे.
अगर आपको कोई कॉलबैक हटाना है, तो उसे जोड़ते समय उसका रेफ़रंस सेव रखें और 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 Service, बूट और बैकग्राउंड 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.
}
});
पैकेज की सूची में आइटम जोड़े जा सकते हैं, उससे आइटम हटाए जा सकते हैं, उसे क्रम से लगाया जा सकता है या पूरी तरह से अलग सूची का इस्तेमाल भी किया जा सकता है.
आपके कॉलबैक को अज्ञात वजहों को अनदेखा करना चाहिए, क्योंकि आने वाले समय में और वजहें जोड़ी जा सकती हैं.
ज़्यादा से ज़्यादा एक BatchDexoptStartCallback सेट किया जा सकता है. कॉल बैक की सुविधा, आने वाले समय में किए जाने वाले सभी कॉल के लिए तब तक चालू रहेगी, जब तक इसे बंद नहीं किया जाता.
अगर आपको कॉलबैक को हटाना है, तो ArtManagerLocal#clearBatchDexoptStartCallback का इस्तेमाल करें.
getArtManagerLocal().clearBatchDexoptStartCallback();
बैकग्राउंड में dexopt जॉब के पैरामीटर को पसंद के मुताबिक बनाना
डिफ़ॉल्ट रूप से, बैकग्राउंड में dexopt जॉब दिन में एक बार तब चलता है, जब डिवाइस इस्तेमाल में न हो और चार्ज हो रहा हो. ArtManagerLocal#setScheduleBackgroundDexoptJobCallback का इस्तेमाल करके, इसे बदला जा सकता है.
getArtManagerLocal().setScheduleBackgroundDexoptJobCallback(
Runnable::run,
builder -> {
builder.setPeriodic(TimeUnit.DAYS.toMillis(2));
});
ज़्यादा से ज़्यादा एक ScheduleBackgroundDexoptJobCallback सेट किया जा सकता है. जब तक कॉल बैक को मिटाया नहीं जाता, तब तक यह आने वाले समय में किए जाने वाले सभी कॉल के लिए चालू रहेगा.
अगर आपको कॉलबैक को हटाना है, तो ArtManagerLocal#clearScheduleBackgroundDexoptJobCallback का इस्तेमाल करें.
getArtManagerLocal().clearScheduleBackgroundDexoptJobCallback();
dexopt को कुछ समय के लिए बंद करें
ART Service से शुरू होने वाली कोई भी dexopt कार्रवाई, BatchDexoptStartCallback को ट्रिगर करती है. dexopt को बंद करने के लिए, कार्रवाइयों को रद्द किया जा सकता है.
अगर रद्द की गई प्रोसेस बैकग्राउंड dexopt है, तो यह फिर से कोशिश करने की डिफ़ॉल्ट नीति का पालन करती है. इसके तहत, 30 सेकंड के बाद फिर से कोशिश की जाती है. इसके बाद, कोशिश करने के बीच का समय बढ़ता जाता है. हालांकि, यह समय पांच घंटे से ज़्यादा नहीं हो सकता.
// 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 हो सकता है. अगर आपको पैकेज की सूची या dexopt पैरामीटर को पसंद के मुताबिक बनाने के लिए, BatchDexoptStartCallback का भी इस्तेमाल करना है, तो आपको कोड को एक कॉलबैक में जोड़ना होगा.
// Bad example.
// Disable dexopt.
getArtManagerLocal().unscheduleBackgroundDexoptJob();
// Re-enable dexopt.
getArtManagerLocal().scheduleBackgroundDexoptJob();
ऐप्लिकेशन इंस्टॉल करने पर की जाने वाली dexopt कार्रवाई, ART Service से शुरू नहीं की जाती. इसके बजाय, इसे पैकेज मैनेजर, dexoptPackage कॉल के ज़रिए शुरू करता है. इसलिए, यह BatchDexoptStartCallback को ट्रिगर नहीं करता. ऐप्लिकेशन इंस्टॉल करते समय dexopt को बंद करने के लिए, पैकेज मैनेजर को dexoptPackage को कॉल करने से रोकें.
कुछ पैकेज के लिए कंपाइलर फ़िल्टर को बदलना (Android 15 और इसके बाद के वर्शन के लिए)
setAdjustCompilerFilterCallback के ज़रिए कॉलबैक रजिस्टर करके, कुछ पैकेज के लिए कंपाइलर फ़िल्टर को बदला जा सकता है. जब भी किसी पैकेज को dexopt किया जाता है, तो कॉलबैक को कॉल किया जाता है. इससे कोई फ़र्क़ नहीं पड़ता कि dexopt को बूट और बैकग्राउंड dexopt के दौरान 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 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 को गाइड करने के लिए प्रोफ़ाइल का इस्तेमाल करें. इसके लिए, APK के बगल में .prof फ़ाइल या .dm फ़ाइल डालें.
.prof फ़ाइल, बाइनरी-फ़ॉर्मैट वाली प्रोफ़ाइल फ़ाइल होनी चाहिए. साथ ही, फ़ाइल का नाम, APK का फ़ाइल नाम + .prof होना चाहिए. उदाहरण के लिए,
base.apk.prof
.dm फ़ाइल का नाम, APK का फ़ाइल नाम होना चाहिए. साथ ही, एक्सटेंशन को .dm से बदला जाना चाहिए. उदाहरण के लिए,
base.dm
यह पुष्टि करने के लिए कि प्रोफ़ाइल का इस्तेमाल dexopt के लिए किया जा रहा है, speed-profile के साथ dexopt चलाएं और नतीजा देखें.
pm art clear-app-profiles <package-name>
pm compile -m speed-profile -f -v <package-name>
पहली लाइन, रनटाइम से जनरेट की गई सभी प्रोफ़ाइलों को हटा देती है.जैसे, /data/misc/profiles में मौजूद प्रोफ़ाइलें. इससे यह पक्का होता है कि APK के बगल में मौजूद प्रोफ़ाइल ही वह प्रोफ़ाइल है जिसका इस्तेमाल एआरटी सेवा कर सकती है. दूसरी लाइन, speed-profile के साथ dexopt को चलाती है. साथ ही, ज़्यादा शब्दों में नतीजा प्रिंट करने के लिए, -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 Service, प्रोफ़ाइल का इस्तेमाल क्यों नहीं करती है, इसकी सामान्य वजहें यहां दी गई हैं:
- प्रोफ़ाइल का फ़ाइल नाम गलत है या यह APK के बगल में नहीं है.
- प्रोफ़ाइल का फ़ॉर्मैट गलत है.
- प्रोफ़ाइल, APK से मैच नहीं करती. (प्रोफ़ाइल में मौजूद चेकसम, APK में मौजूद
.dexफ़ाइलों के चेकसम से मेल नहीं खाते.)