تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
appfunctions
TODO
| آخر الأخبار |
الإصدار الثابت |
إصدار محتمل |
الإصدار التجريبي |
الإصدار الأوّلي |
| 13 أغسطس 2025 |
- |
- |
- |
1.0.0-alpha03 |
تعريف التبعيات
لإضافة تبعية على appfunctions، يجب إضافة مستودع Google Maven إلى مشروعك. اطّلِع على مستودع Maven من Google
لمزيد من المعلومات.
أضِف التبعيات الخاصة بالعناصر التي تحتاج إليها في ملف build.gradle لتطبيقك أو وحدتك:
رائع
dependencies {
implementation "androidx.appfunctions:appfunctions:1.0.0-alpha03"
implementation "androidx.appfunctions:appfunctions-service:1.0.0-alpha03"
implementation "androidx.appfunctions:appfunctions-compiler:1.0.0-alpha03"
}
Kotlin
dependencies {
implementation("androidx.appfunctions:appfunctions:1.0.0-alpha03")
implementation("androidx.appfunctions:appfunctions-service:1.0.0-alpha03")
implementation("androidx.appfunctions:appfunctions-compiler:1.0.0-alpha03")
}
لمزيد من المعلومات حول العناصر التابعة، يُرجى الاطّلاع على إضافة عناصر تابعة للإنشاء.
الملاحظات
تساعدنا ملاحظاتك في تحسين Jetpack. يُرجى إعلامنا إذا اكتشفت مشاكل جديدة أو كانت لديك أفكار لتحسين هذه المكتبة. يُرجى الاطّلاع على
المشاكل الحالية
في هذه المكتبة قبل إنشاء مشكلة جديدة. يمكنك إضافة صوتك إلى مشكلة حالية من خلال النقر على زر النجمة.
إنشاء مشكلة جديدة
يُرجى الاطّلاع على مستندات Issue Tracker
للحصول على مزيد من المعلومات.
لا تتوفّر ملاحظات إصدار لهذا العنصر.
الإصدار 1.0
الإصدار 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 على عمليات الإيداع هذه.
الميزات الجديدة
- توافُق التطبيق مع واجهات برمجة التطبيقات في الإصدار 16 من نظام التشغيل Android
- تحسين التوافق مع
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 library استنادًا إلى android.app.appfunctions واجهات برمجة التطبيقات الخاصة بالمنصة. تسهّل هذه المكتبة عرض وظائف تطبيقك على "مساعد Google" وتتيح له التفاعل مع الوظائف المعروضة في التطبيق.
androidx.appfunctions:appfunctions: واجهات برمجة التطبيقات الأساسية للعملاء من أجل إدارة (تفعيل/إيقاف) AppFunctions والتفاعل معه (البحث/التنفيذ).androidx.appfunctions:appfunctions-service: واجهات برمجة تطبيقات من جهة الخادم لعرض وظائف تطبيقك بسهولة على شكل AppFunctions.androidx.appfunctions:appfunctions-compiler: يجب توفّر برنامج تجميع KSP لإنشاء الرمز البرمجي اللازم لعرض AppFunctions.
يخضع كل من المحتوى وعيّنات التعليمات البرمجية في هذه الصفحة للتراخيص الموضحّة في ترخيص استخدام المحتوى. إنّ Java وOpenJDK هما علامتان تجاريتان مسجَّلتان لشركة Oracle و/أو الشركات التابعة لها.
تاريخ التعديل الأخير: 2025-08-13 (حسب التوقيت العالمي المتفَّق عليه)
[[["يسهُل فهم المحتوى.","easyToUnderstand","thumb-up"],["ساعَدني المحتوى في حلّ مشكلتي.","solvedMyProblem","thumb-up"],["غير ذلك","otherUp","thumb-up"]],[["لا يحتوي على المعلومات التي أحتاج إليها.","missingTheInformationINeed","thumb-down"],["الخطوات معقدة للغاية / كثيرة جدًا.","tooComplicatedTooManySteps","thumb-down"],["المحتوى قديم.","outOfDate","thumb-down"],["ثمة مشكلة في الترجمة.","translationIssue","thumb-down"],["مشكلة في العيّنات / التعليمات البرمجية","samplesCodeIssue","thumb-down"],["غير ذلك","otherDown","thumb-down"]],["تاريخ التعديل الأخير: 2025-08-13 (حسب التوقيت العالمي المتفَّق عليه)"],[],[],null,["# appfunctions\n============\n\nAPI Reference \n[androidx.appfunctions](/reference/kotlin/androidx/appfunctions/package-summary) \nTODO \n\n| Latest Update | Stable Release | Release Candidate | Beta Release | Alpha Release |\n|-----------------|----------------|-------------------|--------------|------------------------------------------------------------------------|\n| August 13, 2025 | - | - | - | [1.0.0-alpha03](/jetpack/androidx/releases/appfunctions#1.0.0-alpha03) |\n\nDeclaring dependencies\n----------------------\n\nTo add a dependency on appfunctions, you must add the Google Maven repository to your\nproject. Read [Google's Maven repository](/studio/build/dependencies#google-maven)\nfor more information.\n\nAdd the dependencies for the artifacts you need in the `build.gradle` file for\nyour app or module: \n\n### Groovy\n\n```groovy\ndependencies {\n implementation \"androidx.appfunctions:appfunctions:1.0.0-alpha03\"\n implementation \"androidx.appfunctions:appfunctions-service:1.0.0-alpha03\"\n implementation \"androidx.appfunctions:appfunctions-compiler:1.0.0-alpha03\"\n}\n```\n\n### Kotlin\n\n```kotlin\ndependencies {\n implementation(\"androidx.appfunctions:appfunctions:1.0.0-alpha03\")\n implementation(\"androidx.appfunctions:appfunctions-service:1.0.0-alpha03\")\n implementation(\"androidx.appfunctions:appfunctions-compiler:1.0.0-alpha03\")\n}\n```\n\nFor more information about dependencies, see [Add build dependencies](/studio/build/dependencies).\n\nFeedback\n--------\n\nYour feedback helps make Jetpack better. Let us know if you discover new issues or have\nideas for improving this library. Please take a look at the\n[existing issues](https://issuetracker.google.com/issues?q=componentid:1709065%20status:open)\nin this library before you create a new one. You can add your vote to an existing issue by\nclicking the star button.\n\n[Create a new issue](https://issuetracker.google.com/issues/new?component=1709065&template=2081773)\n\nSee the [Issue Tracker documentation](https://developers.google.com/issue-tracker)\nfor more information.\n\nThere are no release notes for this artifact.\n\nVersion 1.0\n-----------\n\n### Version 1.0.0-alpha03\n\nAugust 13, 2025\n\n`androidx.appfunctions:appfunctions-*:1.0.0-alpha03` is released. Version 1.0.0-alpha03 contains [these commits](https://android.googlesource.com/platform/frameworks/support/+log/0fc7aad34811cf94484effd29bc2696bb001758f/appfunctions).\n\n**New Features**\n\n- Use KDoc(s) as `AppFunction` descriptions\n- Restrict values for Int and String types using `AppFunctionIntValueConstraint` and `AppFunctionStringValueConstraint` annotations, respectively.\n- Specify a natural language description for large language models and a user visible description displayed within agent apps.\n- Automatically grant permissions to URI(s) returned from an app function using `AppFunctionUriGrant` class.\n- Write Robolectric tests using `AppFunctionTestRule` for testing your app function setup.\n\n**API Changes**\n\n- Add `AppFunctionStringValueConstraint` ([I10e3f](https://android-review.googlesource.com/#/q/I10e3fdff4693e4bf2088d170c0ac654457e8411c))\n- Add `AppFunctionIntValueConstraint` ([Ifda13](https://android-review.googlesource.com/#/q/Ifda13b0c50b2caa57de6bd7844b987ce72e70379))\n- Refactor `AppFunctionPrimitiveTypeMetadata` to specific data type classes. ([I1a3b2](https://android-review.googlesource.com/#/q/I1a3b2e308411bf070c485d90fbe70e399a92642e))\n- Add description field in `AppFunctionResponseMetadata` ([I2332b](https://android-review.googlesource.com/#/q/I2332bb9f5cd75c6269c3b1d671a38e0cb3b20d3d))\n- Remove permission requirement from `setAppFunctionEnabled` API ([I1b92a](https://android-review.googlesource.com/#/q/I1b92a6627801c98aa5fd0e49445092467b9120b9))\n- Add description field in `AppFunctionParameterMetadata` ([I40a67](https://android-review.googlesource.com/#/q/I40a67b95d3f6616e0d747f1be317bb758e1697e6))\n- Add `AppFunctionUriGrant` ([I67ca9](https://android-review.googlesource.com/#/q/I67ca988737fbe065ce8874f5b9b233c218a2f85b))\n- Add `resolveAppFunctionAppMetadata` API. ([I17408](https://android-review.googlesource.com/#/q/I174089a944187498e16190cb931197cf1b763fc4))\n- Add `isDescribedByKdoc` in `@AppFunctionSerializable` annotation ([Ie14e7](https://android-review.googlesource.com/#/q/Ie14e74525a708d7d775c1c0ef579f2349b06e5e8))\n- Add description field in `AppFunctionDataTypeMetadata` ([I1bcac](https://android-review.googlesource.com/#/q/I1bcacafddd42cd5190655d3d6b343c5058384e5e))\n- Return `AppPackageMetadata` from `observeAppFunctions` API. ([I68c7e](https://android-review.googlesource.com/#/q/I68c7e47ea7f2dfc7094ae5c19978fbb3263a6868))\n- Add description field in `AppFunctionMetadata` ([I060e2](https://android-review.googlesource.com/#/q/I060e22469b217a09008ca291d6d76b9d76cf268a))\n- Add `AppFunctionTestRule` ([Id5ed0](https://android-review.googlesource.com/#/q/Id5ed0992d87e1587fb9e3c4a96a6d9f6b3c33724))\n- Add `isDescribedByKdoc` in `@AppFunction` annotation ([Ia84d2](https://android-review.googlesource.com/#/q/Ia84d2a381fce668eec266c3555779be61b419315))\n\n**Bug Fixes**\n\n- `AppFunctionManagerCompat` only supports U+ devices ([Ifa8d0](https://android-review.googlesource.com/#/q/Ifa8d06581a37fabcd8f68b1ab6c89ae889ed57ae))\n- Add property descriptions of shared serializable types in `AppFunction`'s metadata xml ([I2aab2](https://android-review.googlesource.com/#/q/I2aab2c3148393e6177c20963dd5a274d38defce2))\n- Add a description element in generated `AppFunction`'s metadata xml ([Ie5bf6](https://android-review.googlesource.com/#/q/Ie5bf6e021da58c3779a8e463a1e3366637e27c08))\n\n### Version 1.0.0-alpha02\n\nJune 4, 2025\n\n`androidx.appfunctions:appfunctions:1.0.0-alpha02`, `androidx.appfunctions:appfunctions-compiler:1.0.0-alpha02`, and `androidx.appfunctions:appfunctions-service:1.0.0-alpha02` are released. Version 1.0.0-alpha02 contains [these commits](https://android.googlesource.com/platform/frameworks/support/+log/b6c541571b9fb5471f965fc52612cb280713e5e4..786176dc2284c87a0e620477608e0aca9adeff15/appfunctions).\n\n**New Features**\n\n- Support Android 16 API(s).\n- Better support for parameterized `AppFunctionSerializable(s)` at compile time.\n\n**API Changes**\n\n- Introduced `AppFunctionSchemaDefinition` API, enabling agents to define their own predefined function schemas.\n\n**Bug Fixes**\n\n- Error handling for missing runtime enabled state of `AppFunctions`.\n- Minor bugfix in `observeAppFunctions` API to observe changes in `AppFunctionComponentMetadata`.\n- Additional error logs.\n\n### Version 1.0.0-alpha01\n\nMay 7, 2025\n\n`androidx.appfunctions:appfunctions:1.0.0-alpha01`, `androidx.appfunctions:appfunctions-compiler:1.0.0-alpha01`, and `androidx.appfunctions:appfunctions-service:1.0.0-alpha01` are released. Version 1.0.0-alpha01 contains [these commits](https://android.googlesource.com/platform/frameworks/support/+log/b6c541571b9fb5471f965fc52612cb280713e5e4/appfunctions).\n\n**New Features**\n\nThe `AppFunctions` Jetpack library is built on top of `android.app.appfunctions` platform APIs. This library simplifies exposing your app's functionality to the Assistant and allows the Assistant to interact with the app's exposed functions.\n\n- **`androidx.appfunctions:appfunctions`** : Core client APIs for managing (enable/disable) and interacting with (search/execute) `AppFunctions`.\n- **`androidx.appfunctions:appfunctions-service`** : Service-side APIs to easily expose your app's functionalities as `AppFunctions`.\n- **`androidx.appfunctions:appfunctions-compiler`** : Required KSP compiler to generate necessary code for exposing `AppFunctions`."]]
