Stay organized with collections
Save and categorize content based on your preferences.
appfunctions
TODO
Latest Update |
Stable Release |
Release Candidate |
Beta Release |
Alpha Release |
August 13, 2025 |
- |
- |
- |
1.0.0-alpha03 |
Declaring dependencies
To add a dependency on appfunctions, you must add the Google Maven repository to your
project. Read Google's Maven repository
for more information.
Add the dependencies for the artifacts you need in the build.gradle
file for
your app or module:
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")
}
For more information about dependencies, see Add build dependencies.
Feedback
Your feedback helps make Jetpack better. Let us know if you discover new issues or have
ideas for improving this library. Please take a look at the
existing issues
in this library before you create a new one. You can add your vote to an existing issue by
clicking the star button.
Create a new issue
See the Issue Tracker documentation
for more information.
There are no release notes for this artifact.
Version 1.0
Version 1.0.0-alpha03
August 13, 2025
androidx.appfunctions:appfunctions-*:1.0.0-alpha03
is released. Version 1.0.0-alpha03 contains these commits.
New Features
- Use KDoc(s) as
AppFunction
descriptions
- Restrict values for Int and String types using
AppFunctionIntValueConstraint
and AppFunctionStringValueConstraint
annotations, respectively.
- Specify a natural language description for large language models and a user visible description displayed within agent apps.
- Automatically grant permissions to URI(s) returned from an app function using
AppFunctionUriGrant
class.
- Write Robolectric tests using
AppFunctionTestRule
for testing your app function setup.
API Changes
- Add
AppFunctionStringValueConstraint
(I10e3f)
- Add
AppFunctionIntValueConstraint
(Ifda13)
- Refactor
AppFunctionPrimitiveTypeMetadata
to specific data type classes. (I1a3b2)
- Add description field in
AppFunctionResponseMetadata
(I2332b)
- Remove permission requirement from
setAppFunctionEnabled
API (I1b92a)
- Add description field in
AppFunctionParameterMetadata
(I40a67)
- Add
AppFunctionUriGrant
(I67ca9)
- Add
resolveAppFunctionAppMetadata
API. (I17408)
- Add
isDescribedByKdoc
in @AppFunctionSerializable
annotation (Ie14e7)
- Add description field in
AppFunctionDataTypeMetadata
(I1bcac)
- Return
AppPackageMetadata
from observeAppFunctions
API. (I68c7e)
- Add description field in
AppFunctionMetadata
(I060e2)
- Add
AppFunctionTestRule
(Id5ed0)
- Add
isDescribedByKdoc
in @AppFunction
annotation (Ia84d2)
Bug Fixes
AppFunctionManagerCompat
only supports U+ devices (Ifa8d0)
- Add property descriptions of shared serializable types in
AppFunction
's metadata xml (I2aab2)
- Add a description element in generated
AppFunction
's metadata xml (Ie5bf6)
Version 1.0.0-alpha02
June 4, 2025
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.
New Features
- Support Android 16 API(s).
- Better support for parameterized
AppFunctionSerializable(s)
at compile time.
API Changes
- Introduced
AppFunctionSchemaDefinition
API, enabling agents to define their own predefined function schemas.
Bug Fixes
- Error handling for missing runtime enabled state of
AppFunctions
.
- Minor bugfix in
observeAppFunctions
API to observe changes in AppFunctionComponentMetadata
.
- Additional error logs.
Version 1.0.0-alpha01
May 7, 2025
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.
New Features
The 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.
androidx.appfunctions:appfunctions
: Core client APIs for managing (enable/disable) and interacting with (search/execute) AppFunctions
.
androidx.appfunctions:appfunctions-service
: Service-side APIs to easily expose your app's functionalities as AppFunctions
.
androidx.appfunctions:appfunctions-compiler
: Required KSP compiler to generate necessary code for exposing AppFunctions
.
Content and code samples on this page are subject to the licenses described in the Content License. Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
Last updated 2025-08-13 UTC.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 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`."]]