appfunctions

  
TODO
最近更新時間 穩定版 候選版 Beta 版 Alpha 版
2025 年 10 月 8 日 - - - 1.0.0-alpha05

宣告依附元件

如要新增 appfunctions 的依附元件，必須將 Google Maven 存放區新增至專案。詳情請參閱 Google 的 Maven 存放區。

在應用程式或模組的 build.gradle 檔案中，新增所需構件的依附元件：

Groovy

dependencies {
    implementation "androidx.appfunctions:appfunctions:1.0.0-alpha05"
    implementation "androidx.appfunctions:appfunctions-service:1.0.0-alpha05"
    // 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-alpha05"
}

Kotlin

dependencies {
    implementation("androidx.appfunctions:appfunctions:1.0.0-alpha05")
    implementation("androidx.appfunctions:appfunctions-service:1.0.0-alpha05")
    // 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-alpha05")
}

如要進一步瞭解依附元件，請參閱「新增建構依附元件」一文。

意見回饋

您的意見可協助我們改善 Jetpack。如果您發現新問題，或是有改進這個程式庫的建議，請告訴我們。回報新問題前，請先查看這個程式庫的現有問題。只要按一下星號按鈕，即可投票給現有的問題。

建立新問題

詳情請參閱 Issue Tracker 文件。

這個構件沒有任何版本資訊。

1.0 版本

1.0.0-alpha05 版本

2025 年 10 月 8 日

發布 androidx.appfunctions:appfunctions-*:1.0.0-alpha05。1.0.0-alpha05 版包含這些修訂項目。

新功能

  • 建構 AppFunctionData 時，強制提供必填欄位
  • 根據限制值驗證 AppFunctionData

API 變更

修正錯誤

  • 新增必填欄位 AppFunctionsData 檢查。(I36b16、b/394553462)
  • 修正覆寫介面時，系統未遵循參數選用狀態的問題。
  • 即使沒有 AppFunctions，也要產生空白的 XML 檔案，因為 AppSearch 會預期應用程式資訊清單中指定對應的檔案。

1.0.0-alpha04 版本

2025 年 9 月 10 日

發布 androidx.appfunctions:appfunctions-*:1.0.0-alpha04。1.0.0-alpha04 版包含這些修訂項目。

修正錯誤

  • 修正發布子版本的 R8 問題。

1.0.0-alpha03 版本

2025 年 8 月 13 日

發布 androidx.appfunctions:appfunctions-*:1.0.0-alpha03。1.0.0-alpha03 版包含這些修訂項目。

新功能

  • 使用 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 版包含這些修訂項目。

新功能

  • 支援 Android 16 API。
  • 在編譯期間更妥善地支援參數化 AppFunctionSerializable(s)。

API 變更

  • 推出 AppFunctionSchemaDefinition API，讓代理程式定義自己的預先定義函式結構定義。

修正錯誤

  • 處理 AppFunctions 缺少執行階段啟用狀態的錯誤。
  • 修正 observeAppFunctions API 中的小錯誤，以觀察 AppFunctionComponentMetadata 的變化。
  • 其他錯誤記錄。

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 版包含這些修訂項目。

新功能

AppFunctions Jetpack 程式庫是以 android.app.appfunctions 平台 API 為基礎建構而成。這個程式庫可簡化向 Google 助理公開應用程式功能的方式，並允許 Google 助理與應用程式公開的功能互動。

  • androidx.appfunctions:appfunctions：用於管理 (啟用/停用) 和與 AppFunctions 互動 (搜尋/執行) 的核心用戶端 API。
  • androidx.appfunctions:appfunctions-service：服務端 API，可輕鬆將應用程式功能公開為 AppFunctions。
  • androidx.appfunctions:appfunctions-compiler：必要 KSP 編譯器，用於產生公開 AppFunctions 的必要程式碼。