appfunctions

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

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

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

dependencies {
    implementation "androidx.appfunctions:appfunctions:1.0.0-alpha05"
    implementation "androidx.appfunctions:appfunctions-service:1.0.0-alpha05"
    implementation "androidx.appfunctions:appfunctions-compiler:1.0.0-alpha05"
}

dependencies {
    implementation("androidx.appfunctions:appfunctions:1.0.0-alpha05")
    implementation("androidx.appfunctions:appfunctions-service:1.0.0-alpha05")
    implementation("androidx.appfunctions:appfunctions-compiler:1.0.0-alpha05")
}

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

الملاحظات

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

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

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

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

الإصدار 1.0

الإصدار 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 لمراعاة التغييرات في 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.