JavaScriptEngine

  
يمكنك تفعيل تطبيق Android لتقييم JavaScript.
آخر خبر الإصدار المستقر إصدار محتمل الإصدار التجريبي الإصدار الأولي
‫06 مايو 2026 1.1.0 - - -

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

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

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

Groovy

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

Kotlin

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

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

الملاحظات

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

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

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

الإصدار 1.1 من JavaScriptEngine

الإصدار 1.1.0

‫06 مايو 2026

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

الإصدار ‎1.1.0-rc01

‫22 أبريل 2026

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

الإصدار ‎1.1.0-beta01

‫08 أبريل 2026

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

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

  • تعديل JavaScriptEngine إلى الإصدار ‎1.1.0-beta01‏ (I7b63b)

الإصدار ‎1.1.0-alpha02

‫25 مارس 2026

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

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

  • إضافة واجهة برمجة تطبيقات لمنافذ الرسائل لتوفير اتصال متماثل ومرن ومنخفض التكلفة مع وحدات JavaScript المعزولة. يسمح ذلك بإرسال السلاسل وArrayBuffers واستلامها بدون تضمينها داخل التقييمات أو كائنات البيانات المسماة. (I04bc0, b/490128971)

الإصدار ‎1.1.0-alpha01

‫11 مارس 2026

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

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

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

الإصدار 1.0

الإصدار 1.0.0

‫2 يوليو 2025

تم إصدار 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.