ProfileInstaller

  
لتمكين المكتبات من الملء المسبق لآثار التجميع المسبق لوقت القراءة بواسطة ART.
آخر تعديل الإصدار الثابت إصدار محتمل الإصدار التجريبي الإصدار التجريبي الأول
2 أكتوبر 2024 1.4.1 - - -

الإعلان عن التبعيات

لإضافة تبعية على ProfileInstaller، يجب إضافة مستودع Google Maven إلى مشروعك. اطّلِع على مستودع Maven من Google لمزيد من المعلومات.

أضِف التبعيات للعناصر التي تحتاج إليها في ملف build.gradle ل تطبيقك أو وحدتك:

Groovy

dependencies {
    implementation "androidx.profileinstaller:profileinstaller:1.4.1"
}

Kotlin

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

لمزيد من المعلومات حول العناصر الاعتمادية، يُرجى الاطّلاع على إضافة تبعيات الإصدار.

ملاحظات

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

إنشاء مشكلة جديدة

اطّلِع على مستندات أداة تتبُّع المشاكل لمزيد من المعلومات.

الإصدار 1.4

الإصدار 1.4.1

2 أكتوبر 2024

تم طرح androidx.profileinstaller:profileinstaller:1.4.1. يحتوي الإصدار 1.4.1 على عمليات الربط هذه.

إصلاح الأخطاء

  • تم إصلاح مشكلة عدم توفّر إمكانية تسجيل الملف الشخصي الأساسي في عمليات متعددة من خلال الإشارة إلى عمليات متعددة بشكل تسلسلي. يتطلّب هذا الإصلاح التحديث إلى androidx.benchmark:benchmark-macro:1.4.0-alpha02 في وحدة الملف الشخصي لاختبار الأداء على مستوى النظام/الملف الشخصي الأساسي وandroidx.profileinstaller:profileinstaller:1.4.1 في التطبيق. (I0f519، b/366231469)

الإصدار 1.4.0

18 أيلول (سبتمبر) 2024

تم إصدار androidx.profileinstaller:profileinstaller:1.4.0. يحتوي الإصدار 1.4.0 على عمليات التنفيذ هذه.

التغييرات المهمة منذ الإصدار 1.3.0

  • يتيح ProfileInstaller الآن التقاط/تثبيت الملفات الشخصية على الإصدار 35 من واجهة برمجة التطبيقات أو الإصدارات الأحدث. ولن تكون هناك حاجة إلى إجراء تحديثات على ProfileInstaller بعد الآن عند تحديث إصدار النظام الأساسي. (6f9f6fa)
  • إصلاح الأعطال عند إسقاط ملفات تظليل على نظام التشغيل Android U (واجهة برمجة التطبيقات 34) وعلى المحاكيات (I031ca، b/274314544)
  • إصلاح تحويل ترميز علامة الطريقة بتنسيق الملف الشخصي V_015S (aosp/2906631، aosp/2847740)

الإصدار 1.4.0-rc01

4 أيلول (سبتمبر) 2024

تم طرح androidx.profileinstaller:profileinstaller:1.4.0-rc01 بدون أي تغييرات عن الإصدار التجريبي الأخير. يحتوي الإصدار 1.4.0-rc01 على عمليات التنفيذ هذه.

الإصدار 1.4.0-beta01

21 آب (أغسطس) 2024

تم طرح androidx.profileinstaller:profileinstaller:1.4.0-beta01 بدون أي تغييرات من الإصدار الأولي الأخير. يحتوي الإصدار 1.4.0-beta01 على عمليات التنفيذ هذه.

الإصدار 1.4.0-alpha02

7 آب (أغسطس) 2024

تم طرح androidx.profileinstaller:profileinstaller:1.4.0-alpha02. يحتوي الإصدار 1.4.0-alpha02 على عمليات التنفيذ هذه.

الميزات الجديدة

  • تمت إضافة إمكانية استخدام واجهة برمجة التطبيقات 35 إلى أداة تثبيت الملفات الشخصية. (6f9f6fa)

إصلاح الأخطاء

  • تمت إزالة التحديد اليدوي للوصول إلى واجهات برمجة تطبيقات المنصة الجديدة لأنّ ذلك يحدث تلقائيًا من خلال وضع نماذج لواجهات برمجة التطبيقات عند استخدام R8 مع AGP 7.3 أو إصدار أحدث (مثل R8 الإصدار 3.3) ولجميع الإصدارات عند استخدام AGP 8.1 أو إصدار أحدث (مثل D8 الإصدار 8.1). ننصح العملاء الذين لا يستخدمون AGP بالترقية إلى الإصدار 8.1 من D8 أو إصدار أحدث. يُرجى مراجعة هذه المقالة للاطّلاع على مزيد من التفاصيل. (If6b4c، b/345472586)

الإصدار 1.4.0-alpha01

7 شباط (فبراير) 2024

تم طرح androidx.profileinstaller:profileinstaller:1.4.0-alpha01. يحتوي الإصدار 1.4.0-alpha01 على هذه المراجعات.

إصلاح الأخطاء

  • تمت إضافة رمز خطأ لعدم تضمين ملف شخصي في أداة إثبات ملكية الملف الشخصي. (Ifb109، b/313928520)
  • إصلاح الأعطال عند إسقاط ملفات تظليل على نظام التشغيل Android U (واجهة برمجة التطبيقات 34) وعلى المحاكيات (I031ca، b/274314544)
  • تم تفعيل الدعم لنظام Android U في أداة تثبيت الملف الشخصي. (Iaf177)
  • تم إصلاح مشكلة تعذُّر تثبيت الملف الشخصي على نظام التشغيل Android U بسبب عدم إنشاء الملف الشخصي الحالي فارغًا عند بدء العملية. (Ie3899)
  • إصلاح طريقة تحويل ترميز الصور النقطية في تنسيق الملف الشخصي V_015S (aosp/2906631) و (aosp/2847740)

الإصدار 1.3

الإصدار 1.3.1

3 أيار (مايو) 2023

تم إصدار androidx.profileinstaller:profileinstaller:1.3.1. يحتوي الإصدار 1.3.1 على عمليات الالتزام هذه.

إصلاح الأخطاء

  • تم تفعيل الدعم لنظام Android U في أداة تثبيت الملف الشخصي (Iaf177)
  • تم إصلاح مشكلة تعذُّر تثبيت الملف الشخصي على نظام التشغيل Android U بسبب عدم إنشاء الملف الشخصي الحالي فارغًا عند بدء العملية. (Ie3899)

الإصدار 1.3.0

22 آذار (مارس) 2023

تم طرح androidx.profileinstaller:profileinstaller:1.3.0. يحتوي الإصدار 1.3.0 على هذه المراجعات.

التغييرات المهمة منذ الإصدار 1.2.0

  • تم إصلاح NullPointerException في ProfileInstallReceiver. (b/243851384)
  • تمت إضافة واجهة برمجة التطبيقات ProfileVerifier للتحقّق من داخل التطبيق مما إذا تم تجميع ملف شخصي أساسي أو جدولته أو كان غير متوفّر (I263a4، b/246653809)
  • تضيف هذه الميزة بثًا جديدًا لوحدة التحكّم في البرامج يتيح لبرنامج Macrobenchmark تفريغ بيانات الملف الشخصي في الذاكرة بالكامل على القرص لتضمينها في عملية إنشاء الملف الشخصي الأساسي. هذا الإجراء مطلوب لاستخدام مكتبة مقاييس الأداء الكلية لتسجيل الملفات الشخصية المرجعية من خلال BaselineProfileRule، وتقييم أداء الملف الشخصي باستخدام CompilationMode.Partial(warmupIterations).
  • تمت إضافة رمز تشخيص لرصد الملفات الشخصية الأساسية المضغوطة. لا يمكن تثبيت الملفات الشخصية الأساسية المضغوطة بواسطة Profileinstaller في اختبارات الأداء الشاملة أو في مرحلة الإنتاج بسبب زيادة الحمل على وحدة المعالجة المركزية، ويجب تجنُّبها عند إنشاء تطبيقك من خلال التحديث إلى Studio/AGP Electric Eel أو الإصدار bundletool 1.13.1(I86413، b/261998144).
  • تمت إضافة أدوات ربط لاختبارات الأداء الشاملة لتسجيل الملفات الشخصية وحذف ذاكرة التخزين المؤقت للظلال، وهي مطلوبة لإنشاء الملفات الشخصية الأساسية أو اختبارات الأداء الشاملة على الأجهزة غير الجذرة (Ie0a7d وb/250083467 وb/253094958) (Ia5171 وb/231455742)

الإصدار 1.3.0-rc01

8 آذار (مارس) 2023

تم طرح androidx.profileinstaller:profileinstaller:1.3.0-rc01 بدون أي تغييرات منذ آخر إصدار تجريبي. يحتوي الإصدار 1.3.0-rc01 على هذه المراجعات.

الإصدار 1.3.0-beta01

8 شباط (فبراير) 2023

تم إصدار androidx.profileinstaller:profileinstaller:1.3.0-beta01. يحتوي الإصدار 1.3.0-beta01 على هذه المراجعات.

تغييرات واجهة برمجة التطبيقات

  • تم إيقاف ميزة معالجة الملفات المضغوطة، لأنّ فتحها وفك ضغطها يؤديان إلى انخفاض في استخدام وحدة المعالجة المركزية بمقدار 10 مللي ثانية أثناء بدء التشغيل، لذلك تمت إضافة أداة تشخيص بدلاً من ذلك لاكتشاف الملفات الأساسية المضغوطة بشكل غير صحيح. (I86413، b/261998144)

الإصدار 1.3.0-alpha03

11 كانون الثاني (يناير) 2023

تم إصدار androidx.profileinstaller:profileinstaller:1.3.0-alpha03. يحتوي الإصدار 1.3.0-alpha03 على هذه المراجعات.

إصلاح الأخطاء

  • تفعيل معالجة الملفات التجارية الأساسية المضغوطة أو غير المضغوطة (Ic61a0)
  • إصلاح MacrobenchmarkScope.dropShaderCache() لمنع تعطّله من خلال إصلاح سجلّ البث في بيان أداة تثبيت الملف الشخصي (I5c728، b/258619948)

الإصدار 1.3.0-alpha02

9 تشرين الثاني (نوفمبر) 2022

تم إصدار androidx.profileinstaller:profileinstaller:1.3.0-alpha02. يحتوي الإصدار 1.3.0-alpha02 على هذه عمليات التنفيذ.

تغييرات واجهة برمجة التطبيقات

  • تمت إضافة عنصر ربط لمعايير الأداء لإلغاء ذاكرة التخزين المؤقت للظلال، لضمان أداء ثابت لعمليات بدء التشغيل البارد، خاصةً عند التجميع باستخدام الملفات الشخصية من عمليات تكرار الإحماء. هذا التحديث مطلوب لقياس عمليات التشغيل على البارد باستخدام benchmark-macro-junit4:1.2.0-alpha05 أو إصدار أحدث. للاطّلاع على تغييرات واجهة برمجة التطبيقات في مكتبة مقاييس الأداء، يُرجى الرجوع إلى صفحة مقياس الأداء 1.2.0-alpha07. (Ia5171، b/231455742)

الإصدار 1.3.0-alpha01

24 تشرين الأول (أكتوبر) 2022

تم إصدار androidx.profileinstaller:profileinstaller:1.3.0-alpha01. يحتوي الإصدار 1.3.0-alpha01 على هذه المراجعات.

تغييرات واجهة برمجة التطبيقات

  • تمت إضافة واجهة برمجة التطبيقات ProfileVerifier للتحقّق من داخل التطبيق مما إذا تم تجميع ملف قياسي أو جدولته أو كان غير متوفّر (I263a4، b/246653809)
  • تضيف هذه الميزة بثًا جديدًا لوحدة التحكّم في البرامج يتيح لبرنامج Macrobenchmark تفريغ بيانات الملف الشخصي في الذاكرة بالكامل على القرص لتضمينها في عملية إنشاء الملف الشخصي الأساسي. هذا الإجراء مطلوب لاستخدام مكتبة اختبارات الأداء الشاملة لتسجيل الملفات الشخصية الأساسية باستخدام BaselineProfileRule وتقييم أداء الملف الشخصي باستخدام CompilationMode.Partial(warmupIterations). (Ie0a7d، b/250083467، b/253094958)

الإصدار 1.2.2

الإصدار 1.2.2

11 كانون الثاني (يناير) 2023

تم إصدار androidx.profileinstaller:profileinstaller:1.2.2. يحتوي الإصدار 1.2.2 على عمليات الربط هذه.

إصلاح الأخطاء

  • تفعيل معالجة الملفات التجارية الأساسية المضغوطة أو غير المضغوطة (Ic61a0)

الإصدار 1.2.1

الإصدار 1.2.1

7 كانون الأول (ديسمبر) 2022

تم إصدار androidx.profileinstaller:profileinstaller:1.2.1. يحتوي الإصدار 1.2.1 على عمليات الالتزام هذه.

الميزات الجديدة

  • فعِّل أداة تثبيت الملف الشخصي لـ S_V2 (المستوى 32 لواجهة برمجة التطبيقات) وTIRAMISU (المستوى 33 لواجهة برمجة التطبيقات) (b/254900303).

الإصدار 1.2.0

الإصدار 1.2.0

27 تموز (يوليو) 2022

تم إصدار androidx.profileinstaller:profileinstaller:1.2.0. يحتوي الإصدار 1.2.0 على هذه المراجعات.

التغييرات المهمة منذ الإصدار 1.1.0

  • تمت إضافة إمكانية استخدام تنسيق الملف الشخصي ART على نظام التشغيل Android 12 والإصدارات الأحدث.
  • أضِف واجهات برمجة تطبيقات جديدة في ProfileInstallReceiver للحصول على نتائج أكثر اتساقًا مع Macrobenchmarks عند استخدام الملفات الشخصية الأساسية.

الإصدار 1.2.0-rc01

15 حزيران (يونيو) 2022

تم إصدار androidx.profileinstaller:profileinstaller:1.2.0-rc01. يحتوي الإصدار 1.2.0-rc01 على هذه المراجعات.

  • هذا الإصدار مماثل لـ androidx.profileinstaller:profileinstaller:1.2.0-beta03.

الإصدار 1.2.0-beta03

1 حزيران (يونيو) 2022

تم طرح androidx.profileinstaller:profileinstaller:1.2.0-beta03. يحتوي الإصدار 1.2.0-beta03 على هذه المراجعات.

الإصدار 1.2.0-beta02

18 أيار (مايو) 2022

تم طرح androidx.profileinstaller:profileinstaller:1.2.0-beta02. يحتوي الإصدار 1.2.0-beta02 على هذه المراجعات.

  • ما مِن تغييرات مطلوبة لإتاحة الإصدارات 1.2.0-beta02 من Compose.

الإصدار 1.2.0-beta01

11 أيار (مايو) 2022

تم طرح androidx.profileinstaller:profileinstaller:1.2.0-beta01. يحتوي الإصدار 1.2.0-beta01 على هذه المراجعات.

تغييرات واجهة برمجة التطبيقات

  • يمكنك إضافة واجهات برمجة تطبيقات جديدة في ProfileInstallReceiver للحصول على نتائج أكثر اتساقًا مع Macrobenchmarks عند استخدام الملفات الشخصية المرجعية. (If2ae5، وb/215740637)

إصلاح الأخطاء

  • يعرض "أداة تثبيت الملف الشخصي" رسالة مفيدة عند محاولة استخدام تنسيق البيانات الوصفية V_001 على نظام التشغيل Android 12 والإصدارات الأحدث. (aosp/1978526، b/217502387)
  • يستخدم "أداة تثبيت الملفات الشخصية" الآن الإصدار 1.1.1 من androidx.startup. (aosp/2077099، b/229828376)

الإصدار 1.2.0-alpha02

26 يناير 2022

تم إصدار androidx.profileinstaller:profileinstaller:1.2.0-alpha02. يحتوي الإصدار 1.2.0-alpha02 على هذه المراجعات.

هذا الإصدار مطابق للإصدار 1.2.0-alpha01.

الإصدار 1.2.0-alpha01

12 كانون الثاني (يناير) 2022

تم إصدار androidx.profileinstaller:profileinstaller:1.2.0-alpha01. يحتوي الإصدار 1.2.0-alpha01 على هذه عمليات التنفيذ.

الميزات الجديدة

  • إضافة دعم لتنسيق ملف ART المستخدَم في Android 12 والإصدارات الأحدث

الإصدار 1.1.0

الإصدار 1.1.0

9 شباط (فبراير) 2022

تم إصدار androidx.profileinstaller:profileinstaller:1.1.0. يحتوي الإصدار 1.1.0 على عمليات الالتزام هذه.

الإصدار 1.1.0-rc01

15 كانون الأول (ديسمبر) 2021

تم إصدار androidx.profileinstaller:profileinstaller:1.1.0-rc01 بدون أي تحديثات منذ 1.1.0-beta04. يحتوي الإصدار 1.1.0-rc01 على هذه المراجعات.

الإصدار 1.1.0-beta04

1 كانون الأول (ديسمبر) 2021

تم طرح androidx.profileinstaller:profileinstaller:1.1.0-beta04. يحتوي الإصدار 1.1.0-beta04 على هذه المراجعات.

الإصدار 1.1.0-beta03

17 تشرين الثاني (نوفمبر) 2021

تم إصدار androidx.profileinstaller:profileinstaller:1.1.0-beta03. يحتوي الإصدار 1.1.0-beta03 على هذه المراجعات.

إصلاح الأخطاء

  • تم تعديله ليتوافق مع الإصدار 1.1.0-beta03 من Compose

الإصدار 1.1.0-beta02

3 تشرين الثاني (نوفمبر) 2021

تم طرح androidx.profileinstaller:profileinstaller:1.1.0-beta02. يحتوي الإصدار 1.1.0-beta02 على هذه المراجعات.

إصلاح الأخطاء

  • تم تعديله ليتوافق مع الإصدار 1.1.0-beta02 من Compose

الإصدار 1.1.0-beta01

27 تشرين الأول (أكتوبر) 2021

تم إصدار androidx.profileinstaller:profileinstaller:1.1.0-beta01. يحتوي الإصدار 1.1.0-beta01 على هذه المراجعات.

  • لم يتم إجراء أي تغييرات منذ الإصدار 1.1.0-alpha07.

الإصدار 1.1.0-alpha07

13 تشرين الأول (أكتوبر) 2021

تم إصدار androidx.profileinstaller:profileinstaller:1.1.0-alpha07. يحتوي الإصدار 1.1.0-alpha07 على هذه عمليات التنفيذ.

الميزات الجديدة

  • تمت إضافة إمكانية استخدام profm على نظام التشغيل Android N.

الإصدار 1.1.0-alpha06

29 أيلول (سبتمبر) 2021

تم إصدار androidx.profileinstaller:profileinstaller:1.1.0-alpha06. يحتوي الإصدار 1.1.0-alpha06 على هذه عمليات التنفيذ.

إصلاح الأخطاء

  • حلّ مشاكل تحويل ترميز أداة ProfileInstaller على الإصدارات N وO وO_MR1 (I12d75)

الإصدار 1.1.0-alpha05

15 أيلول (سبتمبر) 2021

تم طرح androidx.profileinstaller:profileinstaller:1.1.0-alpha05.