appfunctions

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

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

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

dependencies {
    implementation "androidx.appfunctions:appfunctions:1.0.0-alpha13"
    // Use Kotlin Symbol Processing (KSP) for the appfunctions compiler plugin.
    // See KSP Quickstart to add KSP to your build
    ksp "androidx.appfunctions:appfunctions-compiler:1.0.0-alpha13"
}

dependencies {
    implementation("androidx.appfunctions:appfunctions:1.0.0-alpha13")
    // Use Kotlin Symbol Processing (KSP) for the appfunctions compiler plugin.
    // See KSP Quickstart to add KSP to your build
    ksp("androidx.appfunctions:appfunctions-compiler:1.0.0-alpha13")
}

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

الملاحظات

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

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

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

لا تتوفّر ملاحظات إصدار لهذا العنصر.

الإصدار 1.0

الإصدار ‎1.0.0-alpha13

‫7 أكتوبر 2026

تم إصدار "androidx.appfunctions:appfunctions:1.0.0-alpha13" و"androidx.appfunctions:appfunctions-compiler:1.0.0-alpha13" و"androidx.appfunctions:appfunctions-testing:1.0.0-alpha13". يتضمّن الإصدار ‎1.0.0-alpha13 هذه التعديلات.

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

• أضِف التعليق التوضيحي ‎ @AppFunctionAccessLevel لدعم إعداد قيود الوصول. (Id47e1)
• إعادة تسمية التعليق التوضيحي AppFunction إلى AppFunctionDeclaration (I4b15d)
• تمّت إعادة تسمية ObserveAppFunctionsEvent إلى AppFunctionsChangeEvent (Iec918)
• اعرض AppFunctionMetadata في AppFunctionService. (If1117)

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

• إتاحة جميع أنواع الخوادم الوكيلة المضمّنة (LocalDate وLocalTime وInstant وZoneId) في AppFunctionData (I61c16)

الإصدار ‎1.0.0-alpha12

‫23 سبتمبر 2026

تم إصدار "androidx.appfunctions:appfunctions:1.0.0-alpha12" و"androidx.appfunctions:appfunctions-compiler:1.0.0-alpha12" و"androidx.appfunctions:appfunctions-testing:1.0.0-alpha12". يتضمّن الإصدار ‎1.0.0-alpha12 هذه التعديلات.

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

• يتطلّب هذا الإجراء أن يقدّم AppFunctionData#serialize المتصل البيانات الوصفية. (I61eca)
• تضيف هذه السمة getHandleAppFunctionRequestAdapter مضمّنة إلى جانب التحميل الزائد الحالي المستند إلى Class. (Ic1b4e)
• إزالة AppFunctionContext وAppFunctionConfiguration (I9dd8f)
• يضيف activityId إلى ExecuteAppFunctionRequest (I6ac86)
• تضيف registerAppFunction وregisterAppFunctions وRegisterAppFunctionRequest وCallbackAppFunction بصفتهم @ExperimentalAppFunctionsApi. (Idb2ca)
• يضيف scope في AppFunctionMetadata وAppFunctionSearchSpec (I4344c)
• تضيف AppFunctionUriValueConstraint كواجهة برمجة تطبيقات عامة. (I75070)
• تعديل الدالة الإنشائية AppFunctionPackageMetadata (I096f7)

الإصدار ‎1.0.0-alpha11

‫26 أغسطس 2026

تم إصدار "androidx.appfunctions:appfunctions:1.0.0-alpha11" و"androidx.appfunctions:appfunctions-compiler:1.0.0-alpha11" و"androidx.appfunctions:appfunctions-testing:1.0.0-alpha11". يتضمّن الإصدار ‎1.0.0-alpha11 هذه التعديلات.

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

• أضِف @AppFunctionSignature كواجهة برمجة تطبيقات عامة تجريبية. تتيح واجهة برمجة التطبيقات التسجيل الديناميكي لـ AppFunction من خلال Jetpack. (I72e23، b/501032667)
• أضِف AppFunctionState وAppFunctionManager#getAppFunctionStates. يحلّ هذا الإصدار محلّ AppFunctionMetadata#isEnabled. أصبحت بيانات التعريف الآن منفصلة تمامًا عن الحالة. (I8e490، b/494238383)
• Add getAppFunctionActivityStates. (I41093، b/542075714)
• أضِف ExtensionsAppFunctionService لدعم التطبيقات التي تعمل مع Sidecar. (I7cf10، b/524941402)
• تعديل واجهة برمجة التطبيقات observeAppFunctions لتتطابق مع واجهة برمجة التطبيقات الخاصة بالمنصة (Ifa6fb، b/494238381)

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

• تم إصلاح المشكلة التي كانت تؤدي إلى تعطُّل التطبيق عند استدعاء setAppFunctionEnabled أثناء تجربة الإعداد السريع (OOBE) بسبب عدم توفّر بيانات وصفية لوقت التشغيل. (Ibe229، b/536750020)
• إيقاف التحقّق من صحة البيانات مؤقتًا عند استخدام واجهة برمجة التطبيقات AppFunctionData#serialize إلى أن تأتي البيانات الوصفية من المصدر المرجعي نفسه (I6c95، b/545200019)

الإصدار ‎1.0.0-alpha10

‫01 يوليو 2026

تم إصدار "androidx.appfunctions:appfunctions:1.0.0-alpha10" و"androidx.appfunctions:appfunctions-compiler:1.0.0-alpha10" و"androidx.appfunctions:appfunctions-testing:1.0.0-alpha10". يتضمّن الإصدار ‎1.0.0-alpha10 هذه التعديلات.

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

• تمت إضافة AppFunctionServiceEntryPoint. يجب الإعلان عن جميع تعليقات AppFunction التوضيحية ضمن AppFunctionService التي تمّت إضافة التعليق التوضيحي AppFunctionServiceEntryPoint إليها (Idc5d5، b/463909015)
• تم نقل واجهتَي برمجة التطبيقات AppFunction وAppFunctionConfiguration . ستتم إزالة AppFunctionConfiguration في إصدار مستقبلي وسيتم استبدالها بـ AppFunctionServiceEntryPoint (Iaff23 وI4cf3e وb/517876475)
• تم تعديل واجهة برمجة التطبيقات AppFunctionService لتتوافق مع الاستدعاء (I6e0d7، b/519880977)
• إضافة واجهة برمجة التطبيقات searchAppFunctions (I8c0f9 وI1fa27 وb/494239238)
• تمت إضافة functionNames إلى AppFunctionSearchSpec (I95f53، b/494239238)
• تمت إضافة التعليق التوضيحي AppFunctionInstruction (I21120، b/488994214)
• تمت إضافة التعليق التوضيحي AppFunctionSignature والثوابت المصاحبة له للإعلان عن تواقيع وظائف التطبيق المسجّلة في وقت التشغيل. (I82a05 وIe2361 وIb6bb2)

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

• إزالة enabledByDefault من ملف XML الذي تم إنشاؤه لـ AppFunctionSignatures (Ie2996، b/501032667)

الإصدار ‎1.0.0-alpha09

‫6 مايو 2026

تم طرح androidx.appfunctions:appfunctions-*:1.0.0-alpha09. يتضمّن الإصدار ‎1.0.0-alpha09 هذه التعديلات.

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

• قبول AppInteractionAttribution في ExecuteAppFunctionRequest (I70ad8، b/462092640)

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

• إصلاح مشكلة التوافق AppFunctionUriGrant في الإصدار 37 من حزمة تطوير البرامج (SDK) (I21110، b/485613578)

الإصدار ‎1.0.0-alpha08

‫11 مارس 2026

تم طرح androidx.appfunctions:appfunctions-*:1.0.0-alpha08. يتضمّن الإصدار ‎1.0.0-alpha08 هذه التعديلات.

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

• إضافة دعم لـ Parcelable (s) بالإضافة إلى PendingIntent (I8ab9f)
• واجهات برمجة التطبيقات للتحويل من/إلى طلب واستجابة المنصة (Ifdf20)،

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

• توافق المَعلمات مع دليل الأسلوب (I69b2d)
• إضافة واجهات برمجة تطبيقات للتحويل من/إلى طلب واستجابة المنصة (Ifdf20، b/476047880)
• تمّت إعادة تسمية AppFunctionManagerCompat إلى AppFunctionManager. (Id9a78، b/448372122)
• إزالة واجهات برمجة التطبيقات get/set الخاصة بـ PendingIntent (Ic7fd6، b/447530985)
• إتاحة استخدام Parcelables ونقل PendingIntent ليتم تمثيله كـ Parcelable (I8ab9f، b/447530985)

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

• نقل المكتبات لاستخدام إصدار Java 11 المستهدف وهذا يعني أنّ رمز البايت الذي تم إنشاؤه سيكون Java 11 (إصدار ملف الفئة 55) وقد يتطلّب إزالة التجميل اللغوي لاستخدام المكتبة (If4c2a، b/457821470).

الإصدار ‎1.0.0-alpha07

‫19 نوفمبر 2025

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

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

• إيقاف AppFunction نهائيًا (I39229، b/454661174)

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

• حلّ مشكلة المَعلمات المطلوبة غير الفارغة على المستوى الأعلى (Ic60fc، b/456717542)

الإصدار ‎1.0.0-alpha06

‫5 نوفمبر 2025

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

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

• إتاحة تضمين الموارد كجزء من استجابة AppFunction
• السماح باستخدام FLAG_GRANT_PERSISTABLE_URI_PERMISSION في AppFunctionUriGrant

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

• إضافة واجهة برمجة التطبيقات ResourceHolder (I08c1c وb/447530724)
• إضافة واجهة برمجة التطبيقات AppFunctionTextResource (I7d54f، b/447530724)
• إضافة واجهة برمجة التطبيقات AppFunctionOneOfTypeMetadata (I12c67، b/449915612)
• إزالة اللاحقة Compat من واجهات برمجة التطبيقات للخدمات (Ib9291، b/449797980، b/449797980)
• إتاحة الإصدار AppFunctionData من AllOfType (Ib1176، b/447535093)
• إضافة واجهات برمجة تطبيقات get/set Parcelable في AppFunctionData (I3aec7، b/447530985)

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

• حلّ المشكلة المتمثّلة في تعذُّر تجاهل الحقل المطلوب القابل للتصغير عند إنشاء AppFunctionData (I52195)
• إصلاح المشكلة التي تؤدي إلى تعذُّر استخدام List<PendingIntent> مع AppFunction في وقت الترجمة البرمجية (Iebde7)
• حلّ المشكلة التي أدّت إلى إنشاء البيانات الوصفية الخاصة بـ ByteArray بشكل غير صحيح على أنّها List<ByteArray> (I2e499)

الإصدار ‎1.0.0-alpha05

‫8 أكتوبر 2025

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

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

• فرض توفير الحقول المطلوبة عند إنشاء AppFunctionData
• التحقّق من صحة AppFunctionData مقارنةً بقيم الشروط

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

• أضِف AppFunctionService واجهات برمجة التطبيقات المتوافقة. (I2f1b1، b/445388953)

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

• إضافة علامة AppFunctionsData في الحقل المطلوب (I36b16، b/394553462)
• تم إصلاح المشكلة التي لم يتم فيها مراعاة حالة المَعلمة الاختيارية عند إلغاء واجهة.
• إنشاء ملف XML فارغ حتى في حال عدم توفّر أي AppFunctions، لأنّ AppSearch يتوقّع الملف المقابل المحدّد في بيان التطبيق

الإصدار ‎1.0.0-alpha04

‫10 سبتمبر 2025

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

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

• حلّ المشاكل في R8 لإصدارات التطبيق.

الإصدار ‎1.0.0-alpha03

‫13 أغسطس 2025

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

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

• استخدام تعليقات KDoc كأوصاف AppFunction
• يمكنك حصر قيم النوعَين Int وString باستخدام التعليقَين التوضيحيَين AppFunctionIntValueConstraint وAppFunctionStringValueConstraint على التوالي.
• تحديد وصف بلغة طبيعية للنماذج اللغوية الكبيرة ووصف مرئي للمستخدم يظهر داخل تطبيقات الوكيل
• منح الأذونات تلقائيًا لعناوين URI التي يتم عرضها من خلال إحدى وظائف التطبيق باستخدام فئة AppFunctionUriGrant
• اكتب اختبارات Robolectric باستخدام AppFunctionTestRule لاختبار إعداد وظيفة تطبيقك.

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

• إضافة AppFunctionStringValueConstraint (I10e3f)
• إضافة AppFunctionIntValueConstraint (Ifda13)
• إعادة هيكلة AppFunctionPrimitiveTypeMetadata إلى فئات أنواع بيانات محددة (I1a3b2)
• إضافة حقل الوصف في AppFunctionResponseMetadata (I2332b)
• إزالة شرط الإذن من واجهة برمجة التطبيقات setAppFunctionEnabled (I1b92a)
• إضافة حقل الوصف في AppFunctionParameterMetadata (I40a67)
• إضافة AppFunctionUriGrant (I67ca9)
• أضِف واجهة برمجة التطبيقات resolveAppFunctionAppMetadata. (I17408)
• إضافة التعليق التوضيحي isDescribedByKdoc في @AppFunctionSerializable (Ie14e7)
• إضافة حقل الوصف في AppFunctionDataTypeMetadata (I1bcac)
• إرجاع AppPackageMetadata من واجهة برمجة التطبيقات observeAppFunctions (I68c7e)
• إضافة حقل الوصف في AppFunctionMetadata (I060e2)
• إضافة AppFunctionTestRule (Id5ed0)
• إضافة isDescribedByKdoc في التعليق التوضيحي @AppFunction (Ia84d2)

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

• يتوافق AppFunctionManagerCompat مع أجهزة U+‎ فقط (Ifa8d0)
• إضافة أوصاف السمات للأنواع القابلة للتسلسل المشتركة في ملف XML الخاص بالبيانات الوصفية AppFunction (I2aab2)
• إضافة عنصر وصف في ملف XML الخاص بالبيانات الوصفية لـ AppFunction الذي تم إنشاؤه (Ie5bf6)

الإصدار ‎1.0.0-alpha02

‫4 يونيو 2025

تم إصدار "androidx.appfunctions:appfunctions:1.0.0-alpha02" و"androidx.appfunctions:appfunctions-compiler:1.0.0-alpha02" و"androidx.appfunctions:appfunctions-service:1.0.0-alpha02". يتضمّن الإصدار ‎1.0.0-alpha02 هذه التعديلات.

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

• توافُق التطبيق مع واجهات برمجة التطبيقات في Android 16
• تحسين دعم AppFunctionSerializable(s) المحدَّد المَعلمات في وقت الترجمة البرمجية

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

• تم طرح واجهة برمجة التطبيقات AppFunctionSchemaDefinition، ما يتيح للوكلاء تحديد مخططات وظائفهم المحدّدة مسبقًا.

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

• التعامل مع الخطأ في حال عدم توفّر حالة التفعيل في وقت التشغيل لـ AppFunctions
• تم إصلاح خطأ بسيط في واجهة برمجة التطبيقات ‎observeAppFunctions API لرصد التغييرات في AppFunctionComponentMetadata.
• سجلّات الأخطاء الإضافية

الإصدار ‎1.0.0-alpha01

‫7 مايو 2025

تم إصدار "androidx.appfunctions:appfunctions:1.0.0-alpha01" و"androidx.appfunctions:appfunctions-compiler:1.0.0-alpha01" و"androidx.appfunctions:appfunctions-service:1.0.0-alpha01". يتضمّن الإصدار ‎1.0.0-alpha01 هذه التعديلات.

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

تم إنشاء AppFunctions مكتبة Jetpack استنادًا إلى واجهات برمجة التطبيقات لمنصة android.app.appfunctions. تسهّل هذه المكتبة عرض وظائف تطبيقك على "مساعد Google" وتتيح له التفاعل مع الوظائف المعروضة في التطبيق.

• ‫androidx.appfunctions:appfunctions: واجهات برمجة التطبيقات الأساسية للعملاء من أجل إدارة (تفعيل/إيقاف) AppFunctions والتفاعل معه (البحث/التنفيذ).
• androidx.appfunctions:appfunctions-service: واجهات برمجة تطبيقات من جهة الخادم لعرض وظائف تطبيقك بسهولة على شكل AppFunctions.
• ‫androidx.appfunctions:appfunctions-compiler: يجب استخدام برنامج تجميع KSP لإنشاء الرمز البرمجي اللازم لعرض AppFunctions.