appfunctions

  
تسمح للتطبيقات بمشاركة الوظائف والبيانات مع مساعدي الذكاء الاصطناعي، ما يتيح لهم العثور على المهام وتنفيذها مباشرةً على الجهاز لتلبية طلبات المستخدمين.
آخر الأخبار الإصدار الثابت إصدار محتمل الإصدار التجريبي الإصدار الأوّلي
‫01 يوليو 2026 - - - 1.0.0-alpha10

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

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

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

رائع

dependencies {
    implementation "androidx.appfunctions:appfunctions:1.0.0-alpha10"
    implementation "androidx.appfunctions:appfunctions-service:1.0.0-alpha10"
    // 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-alpha10"
}

Kotlin

dependencies {
    implementation("androidx.appfunctions:appfunctions:1.0.0-alpha10")
    implementation("androidx.appfunctions:appfunctions-service:1.0.0-alpha10")
    // 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-alpha10")
}

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

الملاحظات

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

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

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

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

الإصدار 1.0

الإصدار ‎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)
  • أضِف إمكانية استخدام Parcelable ونقِل PendingIntent ليتم تمثيله كـ Parcelable. (I8ab9f، b/447530985)

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

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

الإصدار ‎1.0.0-alpha07

‫19 نوفمبر 2025

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

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

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

  • حلّ مشكلة المَعلمات المطلوبة غير الفارغة على المستوى الأعلى (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(s) كأوصاف 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.