با مجموعهها، منظم بمانید
ذخیره و طبقهبندی محتوا براساس اولویتهای شما.
توابع برنامه
TODO
| آخرین به روز رسانی | انتشار پایدار | کاندید را آزاد کنید | نسخه بتا | انتشار آلفا |
|---|
| 13 آگوست 2025 | - | - | - | 1.0.0-alpha03 |
اعلام وابستگی ها
برای افزودن وابستگی به توابع برنامه، باید مخزن 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"
} کاتلین
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 کمک می کند. اگر مسائل جدیدی کشف کردید یا ایده هایی برای بهبود این کتابخانه دارید، به ما اطلاع دهید. لطفاً قبل از ایجاد کتابخانه جدید، به مسائل موجود در این کتابخانه نگاهی بیندازید. با کلیک کردن روی دکمه ستاره می توانید رای خود را به یک موضوع موجود اضافه کنید.
یک شماره جدید ایجاد کنید
برای اطلاعات بیشتر به مستندات ردیاب مشکل مراجعه کنید.
هیچ یادداشت انتشار برای این مصنوع وجود ندارد.
نسخه 1.0
نسخه 1.0.0-alpha03
13 آگوست 2025
androidx.appfunctions:appfunctions-*:1.0.0-alpha03 منتشر شد. نسخه 1.0.0-alpha03 حاوی این تعهدات است.
ویژگی های جدید
- از KDoc(ها) به عنوان توضیحات
AppFunction استفاده کنید - مقادیر را برای انواع Int و String با استفاده از حاشیه نویسی
AppFunctionIntValueConstraint و AppFunctionStringValueConstraint به ترتیب محدود کنید. - یک توصیف زبان طبیعی برای مدل‌های زبان بزرگ و یک توضیح قابل مشاهده توسط کاربر که در برنامه‌های عامل نمایش داده می‌شود، مشخص کنید.
- با استفاده از کلاس
AppFunctionUriGrant به URI(های) بازگردانده شده از یک تابع برنامه به طور خودکار مجوز اعطا کنید. - با استفاده از
AppFunctionTestRule تست های روبولکتریک را برای آزمایش تنظیمات عملکرد برنامه خود بنویسید.
تغییرات API
- افزودن
AppFunctionStringValueConstraint ( I10e3f ) - افزودن
AppFunctionIntValueConstraint ( Ifda13 ) - Refactor
AppFunctionPrimitiveTypeMetadata به کلاس های نوع داده خاص. ( I1a3b2 ) - افزودن فیلد توضیحات در
AppFunctionResponseMetadata ( I2332b ) - حذف نیاز مجوز از
setAppFunctionEnabled API ( I1b92a ) - افزودن فیلد توضیحات در
AppFunctionParameterMetadata ( I40a67 ) - افزودن
AppFunctionUriGrant ( I67ca9 ) - API
resolveAppFunctionAppMetadata اضافه کنید. ( I17408 ) - اضافه کردن
isDescribedByKdoc در حاشیه نویسی @AppFunctionSerializable ( Ie14e7 ) - افزودن فیلد توضیحات در
AppFunctionDataTypeMetadata ( I1bcac ) -
AppPackageMetadata از observeAppFunctions API برگردانید. ( 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 API(های)
- پشتیبانی بهتر از پارامترهای
AppFunctionSerializable(s) در زمان کامپایل.
تغییرات API
-
AppFunctionSchemaDefinition API را معرفی کرد، که عامل ها را قادر می سازد تا طرحواره های تابع از پیش تعریف شده خود را تعریف کنند.
رفع اشکال
- رسیدگی به خطا برای وضعیت فعال زمان اجرا از دست رفته
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 بر روی APIهای پلت فرم android.app.appfunctions ساخته شده است. این کتابخانه نمایش عملکرد برنامه شما را برای دستیار ساده می کند و به دستیار اجازه می دهد تا با عملکردهای در معرض برنامه تعامل داشته باشد.
-
androidx.appfunctions:appfunctions : APIهای مشتری اصلی برای مدیریت (فعال/غیرفعال) و تعامل با (جستجو/اجرا) AppFunctions . -
androidx.appfunctions:appfunctions-service : API های سمت سرویس برای نمایش آسان عملکردهای برنامه شما به عنوان AppFunctions . -
androidx.appfunctions:appfunctions-compiler : کامپایلر KSP مورد نیاز برای تولید کدهای لازم برای افشای AppFunctions .
محتوا و نمونه کدها در این صفحه مشمول پروانههای توصیفشده در پروانه محتوا هستند. جاوا و 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`."]]
