Google は AI 技術を使用して、コンテンツをご希望の言語に翻訳しています。AI 翻訳には誤りが含まれる場合があります。

appfunctions

アプリが AI アシスタントと機能やデータを共有できるようにします。これにより、AI アシスタントはデバイス上で直接タスクを検出して実行し、ユーザーのリクエストに応えることができます。

最新の更新	安定版リリース	リリース候補版	ベータ版リリース	アルファ版リリース
2026 年 9 月 23 日	-	-	-	1.0.0-alpha12

依存関係の宣言

appfunctions への依存関係を追加するには、Google の Maven リポジトリをプロジェクトに追加する必要があります。詳しくは、Google の Maven リポジトリをご覧ください。

アプリまたはモジュールの build.gradle ファイルに、必要なアーティファクトの依存関係を追加します。

Groovy

dependencies {
    implementation "androidx.appfunctions:appfunctions:1.0.0-alpha12"
    // Use Kotlin Symbol Processing (KSP) for the appfunctions compiler plugin.
    // See KSP Quickstart to add KSP to your build
    ksp "androidx.appfunctions:appfunctions-compiler:1.0.0-alpha12"
}

Kotlin

dependencies {
    implementation("androidx.appfunctions:appfunctions:1.0.0-alpha12")
    // Use Kotlin Symbol Processing (KSP) for the appfunctions compiler plugin.
    // See KSP Quickstart to add KSP to your build
    ksp("androidx.appfunctions:appfunctions-compiler:1.0.0-alpha12")
}

依存関係について詳しくは、ビルド依存関係の追加をご覧ください。

フィードバック

お寄せいただいたフィードバックは Jetpack 改善の参考にさせていただきます。新しい問題が見つかった場合や、このライブラリを改善するアイデアをお持ちの場合は、お知らせください。新しい問題を報告していただく前に、このライブラリの既存の問題をご確認ください。スターボタンをクリックすると、既存の問題に投票できます。

新しい問題を報告する

詳細については、Issue Tracker のドキュメントをご覧ください。

このアーティファクトのリリースノートはありません。

バージョン 1.0

バージョン 1.0.0-alpha12

2026 年 9 月 23 日

androidx.appfunctions:appfunctions:1.0.0-alpha12、androidx.appfunctions:appfunctions-compiler:1.0.0-alpha12、androidx.appfunctions:appfunctions-testing:1.0.0-alpha12 がリリースされました。バージョン 1.0.0-alpha12 に含まれる commit については、こちらをご覧ください。

API の変更

AppFunctionData#serialize 呼び出し元がメタデータを提供する必要があります。（I61eca）
既存の Class ベースのオーバーロードに加えて、インラインの具現化された getHandleAppFunctionRequestAdapter を追加します。（Ic1b4e）
AppFunctionContext と AppFunctionConfiguration を削除しました（I9dd8f）
activityId を ExecuteAppFunctionRequest に追加しました（I6ac86）
registerAppFunction、registerAppFunctions、RegisterAppFunctionRequest、CallbackAppFunction を @ExperimentalAppFunctionsApi として追加します。（Idb2ca）
AppFunctionMetadata と AppFunctionSearchSpec に scope を追加（I4344c）
AppFunctionUriValueConstraint を公開 API として追加します。（I75070）
AppFunctionPackageMetadata コンストラクタを更新（I096f7）

バージョン 1.0.0-alpha11

2026 年 8 月 26 日

androidx.appfunctions:appfunctions:1.0.0-alpha11、androidx.appfunctions:appfunctions-compiler:1.0.0-alpha11、androidx.appfunctions:appfunctions-testing:1.0.0-alpha11 がリリースされました。バージョン 1.0.0-alpha11 に含まれる commit については、こちらをご覧ください。

API の変更

@AppFunctionSignature を試験運用版の公開 API として追加しました。この API は、Jetpack を介した動的な AppFunction 登録をサポートしています。（I72e23、b/501032667）
AppFunctionState と AppFunctionManager#getAppFunctionStates を追加します。これは AppFunctionMetadata#isEnabled に代わるものです。メタデータは状態から完全に分離されました。（I8e490、b/494238383）
Add getAppFunctionActivityStates。（I41093、b/542075714）
サイドカーで動作するアプリをサポートするために ExtensionsAppFunctionService を追加しました。（I7cf10、b/524941402）
プラットフォーム API に合わせて observeAppFunctions API を更新。（Ifa6fb、b/494238381）

バグの修正

OOBE 中に setAppFunctionEnabled を呼び出すと、ランタイムメタデータが欠落していることが原因でアプリがクラッシュする問題を修正（Ibe229、b/536750020）
メタデータが同じ信頼できる情報源から取得されるまで、AppFunctionData#serialize API を使用する際のデータ検証を一時的に無効にします。（I6c95、b/545200019）

バージョン 1.0.0-alpha10

2026 年 7 月 1 日

androidx.appfunctions:appfunctions:1.0.0-alpha10、androidx.appfunctions:appfunctions-compiler:1.0.0-alpha10、androidx.appfunctions:appfunctions-testing:1.0.0-alpha10 がリリースされました。バージョン 1.0.0-alpha10 に含まれる commit については、こちらをご覧ください。

API の変更

AppFunctionServiceEntryPoint を追加しました。すべての AppFunction アノテーションは、AppFunctionServiceEntryPoint でアノテーションが付けられた AppFunctionService 内で宣言する必要があります（Idc5d5、b/463909015）
AppFunction API と AppFunctionConfiguration API を移動しました。AppFunctionConfiguration は、AppFunctionServiceEntryPoint に置き換えられるため、今後のリリースで削除されます（Iaff23、I4cf3e、b/517876475）
コールバックをサポートするように AppFunctionService API を更新しました（I6e0d7、b/519880977）
searchAppFunctions API を追加（I8c0f9、I1fa27、b/494239238）
functionNames を AppFunctionSearchSpec に追加しました（I95f53、b/494239238）
AppFunctionInstruction アノテーションを追加しました（I21120、b/488994214）
実行時に登録されたアプリ関数シグネチャを宣言するために、AppFunctionSignature アノテーションと付随する定数を追加しました。（I82a05、Ie2361、Ib6bb2）

バグの修正

AppFunctionSignatures の生成された XML から enabledByDefault を省略（Ie2996、b/501032667）

バージョン 1.0.0-alpha09

2026 年 5 月 6 日

androidx.appfunctions:appfunctions-*:1.0.0-alpha09 がリリースされました。バージョン 1.0.0-alpha09 に含まれる commit については、こちらをご覧ください。

API の変更

ExecuteAppFunctionRequest で AppInteractionAttribution を受け入れる（I70ad8、b/462092640）

バグの修正

SDK37 での AppFunctionUriGrant の互換性の問題を修正しました（I21110、b/485613578）

バージョン 1.0.0-alpha08

2026 年 3 月 11 日

androidx.appfunctions:appfunctions-*:1.0.0-alpha08 がリリースされました。バージョン 1.0.0-alpha08 に含まれる commit については、こちらをご覧ください。

新機能

PendingIntent 以外の Parcelable のサポートを追加しました（I8ab9f）
Platform リクエストとレスポンスとの間で変換する API（Ifdf20）、

API の変更

スタイルガイドに準拠したパラメータ。（I69b2d）
プラットフォームリクエストとレスポンス間で変換する API を追加（Ifdf20、b/476047880）
AppFunctionManagerCompat を AppFunctionManager に変更しました。（Id9a78、b/448372122）
PendingIntent の get/set API を削除。（Ic7fd6、b/447530985）
Parcelable のサポートを追加し、PendingIntent を Parcelable として表すように移行しました。（I8ab9f、b/447530985）

バグの修正

ライブラリを Java 11 ターゲットを使用するように移行しました。つまり、生成されたバイトコードは Java 11（クラスファイルバージョン 55）になり、ライブラリを使用するために脱糖が必要になる可能性があります（If4c2a、b/457821470）

バージョン 1.0.0-alpha07

2025 年 11 月 19 日

androidx.appfunctions:appfunctions-*:1.0.0-alpha07 がリリースされました。バージョン 1.0.0-alpha07 に含まれる commit については、こちらをご覧ください。

API の変更

AppFunction の非推奨化をサポート（I39229、b/454661174）

バグの修正

null 以外の必須のトップレベルパラメータに関する問題を修正しました（Ic60fc、b/456717542）

バージョン 1.0.0-alpha06

2025 年 11 月 5 日

androidx.appfunctions:appfunctions-*:1.0.0-alpha06 がリリースされました。バージョン 1.0.0-alpha06 に含まれる commit については、こちらをご覧ください。

新機能

AppFunction レスポンスの一部としてリソースを埋め込むサポート
AppFunctionUriGrant での FLAG_GRANT_PERSISTABLE_URI_PERMISSION の使用を許可する

API の変更

ResourceHolder API を追加（I08c1c、b/447530724）
AppFunctionTextResource API を追加（I7d54f、b/447530724）
AppFunctionOneOfTypeMetadata API を追加しました（I12c67、b/449915612）
Service API から Compat サフィックスを削除しました。（Ib9291、b/449797980、b/449797980）
AllOfType からのビルド AppFunctionData をサポート（Ib1176、b/447535093）
AppFunctionData に Parcelable API の get/set を追加（I3aec7、b/447530985）

バグの修正

AppFunctionData を構築する際に、null 許容の必須フィールドを無視すると失敗する問題を修正（I52195）
AppFunction で List<PendingIntent> を使用するとコンパイル時に失敗する問題を修正しました（Iebde7）
ByteArray のメタデータが List<ByteArray> として誤って生成される問題を修正（I2e499）

バージョン 1.0.0-alpha05

2025 年 10 月 8 日

androidx.appfunctions:appfunctions-*:1.0.0-alpha05 がリリースされました。バージョン 1.0.0-alpha05 に含まれる commit については、こちらをご覧ください。

新機能

AppFunctionData を構築する際に必須フィールドが指定されるように強制する
制約値に対する AppFunctionData の検証

API の変更

AppFunctionService Compat API を追加しました。（I2f1b1、b/445388953）

バグの修正

必須フィールド AppFunctionsData のチェックを追加。（I36b16、b/394553462）
インターフェースをオーバーライドするときにパラメータの省略可能な状態が尊重されない問題を修正
AppSearch はアプリマニフェストで指定された対応するファイルを想定しているため、AppFunctions が存在しない場合でも空の XML ファイルを生成します。

バージョン 1.0.0-alpha04

2025 年 9 月 10 日

androidx.appfunctions:appfunctions-*:1.0.0-alpha04 がリリースされました。バージョン 1.0.0-alpha04 に含まれる commit については、こちらをご覧ください。

バグの修正

リリースビルドの R8 の問題を修正。

バージョン 1.0.0-alpha03

2025 年 8 月 13 日

androidx.appfunctions:appfunctions-*:1.0.0-alpha03 がリリースされました。バージョン 1.0.0-alpha03 に含まれる commit については、こちらをご覧ください。

新機能

KDoc を AppFunction の説明として使用する
AppFunctionIntValueConstraint アノテーションと AppFunctionStringValueConstraint アノテーションを使用して、それぞれ Int 型と String 型の値を制限します。
大規模言語モデルの自然言語の説明と、エージェントアプリ内に表示されるユーザー向けの説明を指定します。
AppFunctionUriGrant クラスを使用して、アプリ関数から返された URI に権限を自動的に付与します。
AppFunctionTestRule を使用して Robolectric テストを記述し、アプリの関数設定をテストします。

API の変更

AppFunctionStringValueConstraint を追加しました。（I10e3f）
AppFunctionIntValueConstraint を追加しました（Ifda13）
AppFunctionPrimitiveTypeMetadata を特定のデータ型クラスにリファクタリングします。（I1a3b2）
AppFunctionResponseMetadata に説明フィールドを追加（I2332b）
setAppFunctionEnabled API から権限要件を削除（I1b92a）
AppFunctionParameterMetadata に説明フィールドを追加（I40a67）
AppFunctionUriGrant を追加しました（I67ca9）
resolveAppFunctionAppMetadata API を追加しました。（I17408）
@AppFunctionSerializable アノテーションに isDescribedByKdoc を追加（Ie14e7）
AppFunctionDataTypeMetadata に説明フィールドを追加（I1bcac）
observeAppFunctions API から AppPackageMetadata を返します。（I68c7e）
AppFunctionMetadata に説明フィールドを追加（I060e2）
AppFunctionTestRule を追加しました（Id5ed0）
@AppFunction アノテーションに isDescribedByKdoc を追加（Ia84d2）

バグの修正

AppFunctionManagerCompat は U+ デバイス（Ifa8d0）のみをサポートします
AppFunction のメタデータ XML（I2aab2）に共有シリアライズ可能な型のプロパティの説明を追加
生成された AppFunction のメタデータ XML に説明要素を追加（Ie5bf6）

バージョン 1.0.0-alpha02

2025 年 6 月 4 日

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 に含まれる commit については、こちらをご覧ください。

新機能

Android 16 API をサポートします。
コンパイル時のパラメータ化された AppFunctionSerializable(s) のサポートを強化しました。

API の変更

AppFunctionSchemaDefinition API を導入し、エージェントが独自の事前定義関数スキーマを定義できるようにしました。

バグの修正

AppFunctions のランタイム有効状態がない場合のエラー処理。
AppFunctionComponentMetadata の変更を監視するための observeAppFunctions API の軽微なバグを修正しました。
追加のエラーログ。

バージョン 1.0.0-alpha01

2025 年 5 月 7 日

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 に含まれる commit については、こちらをご覧ください。

新機能

AppFunctions Jetpack ライブラリは android.app.appfunctions プラットフォーム API 上に構築されています。このライブラリを使用すると、アプリの機能をアシスタントに簡単に公開し、アシスタントが公開されたアプリの機能とやり取りできるようになります。

androidx.appfunctions:appfunctions: AppFunctions の管理（有効化/無効化）と操作（検索/実行）を行うためのコアクライアント API。
androidx.appfunctions:appfunctions-service: アプリの機能を AppFunctions として簡単に公開できるサービスサイド API。
androidx.appfunctions:appfunctions-compiler: AppFunctions を公開するために必要なコードを生成するために必要な KSP コンパイラ。