קל לארגן דפים בעזרת אוספים
אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.
appfunctions
TODO
העדכון האחרון |
גרסה יציבה |
גרסה מועמדת להפצה |
גרסת בטא |
גרסת אלפא |
13 באוגוסט 2025 |
- |
- |
- |
1.0.0-alpha03 |
הצהרה על יחסי תלות
כדי להוסיף תלות ב-appfunctions, צריך להוסיף את מאגר Google Maven לפרויקט. מידע נוסף זמין במאמר בנושא מאגר Maven של Google.
מוסיפים את יחסי התלות של הארטיפקטים שאתם צריכים בקובץ build.gradle
של האפליקציה או המודול:
Groovy
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")
}
מידע נוסף על יחסי תלות זמין במאמר הוספת יחסי תלות ב-Build.
משוב
המשוב שלכם עוזר לנו לשפר את Jetpack. נשמח לשמוע מכם אם תגלו בעיות חדשות או אם יש לכם רעיונות לשיפור הספרייה הזו. לפני שיוצרים ספרייה חדשה, כדאי לעיין בבעיות הקיימות בספרייה הזו. כדי להוסיף את ההצבעה שלכם לבעיה קיימת, לוחצים על לחצן הכוכב.
יצירת בעיה חדשה
מידע נוסף זמין במאמרי העזרה בנושא כלי המעקב אחר בעיות.
אין הערות לגבי הגרסה של הארטיפקט הזה.
גירסה 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
.
שינויים ב-API
- הוספה של
AppFunctionStringValueConstraint
(I10e3f)
- הוספה של
AppFunctionIntValueConstraint
(Ifda13)
- הגדרת
AppFunctionPrimitiveTypeMetadata
מחדש למחלקות ספציפיות של סוגי נתונים. (I1a3b2)
- הוספת שדה תיאור ב-
AppFunctionResponseMetadata
(I2332b)
- הסרה של דרישת ההרשאה מ-
setAppFunctionEnabled
API (I1b92a)
- הוספת שדה תיאור ב-
AppFunctionParameterMetadata
(I40a67)
- הוספה של
AppFunctionUriGrant
(I67ca9)
- מוסיפים את API של
resolveAppFunctionAppMetadata
. (I17408)
- הוספה של
isDescribedByKdoc
בהערה @AppFunctionSerializable
(Ie14e7)
- הוספת שדה תיאור ב-
AppFunctionDataTypeMetadata
(I1bcac)
- החזרת
AppPackageMetadata
מ-API 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 API.
- תמיכה משופרת ב-
AppFunctionSerializable(s)
עם פרמטרים בזמן ההידור.
שינויים ב-API
- השקנו את
AppFunctionSchemaDefinition
API, שמאפשר לסוכנים להגדיר סכימות משלהם של פונקציות מוגדרות מראש.
תיקוני באגים
- טיפול בשגיאות במצב זמן ריצה חסר של
AppFunctions
.
- תיקון באג קטן ב-API של
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 מבוססת על ממשקי API של פלטפורמת android.app.appfunctions
. הספרייה הזו מפשטת את החשיפה של הפונקציונליות של האפליקציה ל-Assistant, ומאפשרת ל-Assistant ליצור אינטראקציה עם הפונקציות החשופות של האפליקציה.
-
androidx.appfunctions:appfunctions
: ממשקי API מרכזיים של לקוחות לניהול (הפעלה/השבתה) וליצירת אינטראקציה עם AppFunctions
(חיפוש/ביצוע).
-
androidx.appfunctions:appfunctions-service
: ממשקי API בצד השרת שמאפשרים לחשוף בקלות את הפונקציות של האפליקציה כ-AppFunctions
.
-
androidx.appfunctions:appfunctions-compiler
: קומפיילר KSP נדרש כדי ליצור את הקוד הדרוש לחשיפת AppFunctions
.
דוגמאות התוכן והקוד שבדף הזה כפופות לרישיונות המפורטים בקטע רישיון לתוכן. Java ו-OpenJDK הם סימנים מסחריים או סימנים מסחריים רשומים של חברת Oracle ו/או של השותפים העצמאיים שלה.
עדכון אחרון: 2025-08-13 (שעון UTC).
[[["התוכן קל להבנה","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 (שעון UTC)."],[],[],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`."]]