JavascriptEngine

تحديد الاعتماديات

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

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

dependencies {
    implementation "androidx.javascriptengine:javascriptengine:1.1.0-alpha01"
}

dependencies {
    implementation("androidx.javascriptengine:javascriptengine:1.1.0-alpha01")
}

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

الملاحظات

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

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

يُرجى الاطّلاع على مستندات Issue Tracker للحصول على مزيد من المعلومات.

الإصدار 1.1

الإصدار ‎1.1.0-alpha01

‫11 مارس 2026

تم طرح androidx.javascriptengine:javascriptengine:1.1.0-alpha01. يتضمّن الإصدار 1.1.0-alpha01 هذه التعديلات.

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

• نقل المكتبات لاستخدام الإصدار 11 من Java وهذا يعني أنّ الرمز الثانوي الذي يتم إنتاجه سيكون Java 11 (إصدار ملف الفئة 55) وقد يتطلّب إزالة التجميل اللغوي لاستخدام المكتبة (If4c2a، b/457821470).
• تستخدم هذه المكتبة الآن تعليقات توضيحية بشأن القيم الخالية من JSpecify، وهي تعليقات توضيحية خاصة باستخدام النوع. على مطوّري Kotlin استخدام وسيطة المترجم البرمجي التالية لفرض الاستخدام الصحيح: -Xjspecify-annotations=strict (هذه هي القيمة التلقائية بدءًا من الإصدار 2.1.0 من مترجم Kotlin البرمجي) (Ieee48، b/326456246)

الإصدار 1.0

الإصدار 1.0.0

‫2 يوليو 2022

تم إصدار androidx.javascriptengine:javascriptengine:1.0.0 بدون أي تغييرات ملحوظة منذ آخر إصدار تجريبي. يتضمّن الإصدار 1.0.0 هذه التعديلات.

الإصدار ‎1.0.0-rc01

‫26 مارس 2025

تم إصدار androidx.javascriptengine:javascriptengine:1.0.0-rc01 بدون أي تغييرات ملحوظة منذ آخر إصدار تجريبي. يتضمّن الإصدار 1.0.0-rc01 هذه التعديلات.

الإصدار ‎1.0.0-beta01

‫1 نوفمبر 2023

تم إصدار androidx.javascriptengine:javascriptengine:1.0.0-beta01 بدون أي تغييرات ملحوظة منذ آخر إصدار أولي. يتضمّن الإصدار 1.0.0-beta01 هذه التعديلات.

الإصدار ‎1.0.0-alpha07

‫18 أكتوبر 2023

تم طرح androidx.javascriptengine:javascriptengine:1.0.0-alpha07. يتضمّن الإصدار 1.0.0-alpha07 هذه التعديلات.

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

• تم طرح واجهة برمجة تطبيقات جديدة للسماح للتطبيقات بتسجيل عمليات رد الاتصال للتعامل مع الأعطال المعزولة.

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

• تمّت إعادة تسمية DEFAULT_MAX_HEAP_SIZE إلى AUTOMATIC_MAX_HEAP_SIZE. (I6d303)
• تمّت إعادة تسمية FileDescriptorIoException إلى DataInputException. (Iba4eb)
• تمّت إعادة تسمية DEFAULT_ISOLATE_HEAP_SIZE إلى DEFAULT_MAX_HEAP_SIZE. (Iaa16f)
• إزالة طريقتَي وحدة التحكّم getSource وgetTrace غير الوظيفيتَين (I4b7a2)
• إظهار FileDescriptorIoException (Ic44e6)
• السماح للتطبيقات بتسجيل عمليات رد الاتصال للتعامل مع الأعطال المعزولة (Iad25f)

الإصدار ‎1.0.0-alpha06

‫4 أكتوبر 2023

تم طرح androidx.javascriptengine:javascriptengine:1.0.0-alpha06. يتضمّن الإصدار 1.0.0-alpha06 هذه التعديلات.

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

• تم تقديم واجهة برمجة تطبيقات جديدة لتقييم JavaScript من ParcelFileDescriptor/AssetFileDescriptor بدون الحاجة إلى تحويل المصدر إلى سلسلة. يتم جعل فئة JavaScriptIsolate آمنة للاستخدام المتزامن.

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

• تغيير provideNamedData لطرح استثناء بدلاً من عرض القيمة "خطأ". (I8909a)
• إضافة واجهات برمجة تطبيقات لتقييم JavaScript من خلال Afds وPfds (I03e3a)
• جعل MemoryLimitExceededException وSandboxDeadException فئة فرعية من IsolateTerminatedException (Icf359)
• إزالة واجهة برمجة التطبيقات المتاحة للجميع evaluateJavaScriptAsync(@NonNull byte[] code) (I4b3ac)

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

• اجعل سلسلة التعليمات JavaScriptIsolate آمنة. (Ib28e0)

الإصدار ‎1.0.0-alpha05

‫5 أبريل 2023

تم طرح androidx.javascriptengine:javascriptengine:1.0.0-alpha05. يتضمّن الإصدار 1.0.0-alpha05 هذه التعديلات.

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

• لم يعُد التقييم والنتيجة خاضعَين لحدود Binder (I13b1d)
• إضافة دالة ردّ للتعامل مع رسائل وحدة التحكّم المعزولة (I11725، Ic1c11)

الإصدار ‎1.0.0-alpha04

‫22 فبراير 2023

تم طرح androidx.javascriptengine:javascriptengine:1.0.0-alpha04. يتضمّن الإصدار 1.0.0-alpha04 هذه التعديلات.

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

• إصلاح حالة نادرة من الخطأ NullPointerException تحدث عند تعطّل العملية المعزولة.

الإصدار ‎1.0.0-alpha03

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

تم طرح androidx.javascriptengine:javascriptengine:1.0.0-alpha03. يتضمّن الإصدار 1.0.0-alpha03 هذه التعديلات.

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

• احتواء الأعطال الناتجة عن نفاد الذاكرة في العزل المسؤول بدلاً من تعطيل الحماية بالكامل وبعد أن يخرج من الذاكرة، لا يمكن استخدامه لإجراء تقييمات أخرى.
• في الوقت الحالي، لا يتم تحرير الموارد التي يحتوي عليها التطبيق المعزول إلا بعد إغلاق البيئة المحمية. قد يتغير سلوك تحرير الموارد هذا في الإصدارات اللاحقة من المكتبة.

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

• يتم عرض الخطأ MemoryLimitExceededException عندما يؤدي التقييم إلى نفاد ذاكرة الجهاز المعزول.(I336ca)

الإصدار ‎1.0.0-alpha02

‫5 أكتوبر 2022

تم طرح androidx.javascriptengine:javascriptengine:1.0.0-alpha02. يتضمّن الإصدار 1.0.0-alpha02 هذه التعديلات.

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

• أضِف JavaScriptSandbox#isSupported للتحقّق مما إذا كان النظام يتيح استخدام بيئات الاختبار المعزولة في JavaScript.

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

• يتم عرض SandboxUnsupportedException عندما يتعذّر إنشاء JavaScriptSandbox بسبب عدم توفّر دعم النظام. (I0dcd6)

الإصدار ‎1.0.0-alpha01

‫10 أغسطس 2022

تم طرح androidx.javascriptengine:javascriptengine:1.0.0-alpha01. يتضمّن الإصدار 1.0.0-alpha01 هذه التعديلات.

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

• أضفنا دعمًا تجريبيًا للرمزين JavaScriptSandbox وJavaScriptIsolate لتمكين العملاء من تقييم JavaScript في بيئة آمنة ومقيّدة. هذه الميزة قيد التطوير النشط، وقد تخضع واجهات برمجة التطبيقات للتغيير بدون إشعار.

• يُرجى إرسال طلبات الميزات والأخطاء إلى مكوّن JavascriptEngine.