appfunctions

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

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

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

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

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

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

الملاحظات

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

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

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

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

الإصدار 1.0

الإصدار ‎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)

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

• نقل المكتبات لاستخدام الإصدار 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 هذه التعديلات.

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

• إيقاف 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(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 API. (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.