функции приложения

Позволяет приложениям обмениваться функционалом и данными с ИИ-помощниками, давая им возможность обнаруживать и выполнять задачи непосредственно на устройстве для удовлетворения запросов пользователей.
Последнее обновление Стабильный релиз Предварительная версия релиза Бета-версия Альфа-версия
1 июля 2026 г. - - - 1.0.0-alpha10

Объявление зависимостей

Чтобы добавить зависимость от appfunctions, необходимо добавить репозиторий Google Maven в ваш проект. Для получения дополнительной информации ознакомьтесь с информацией в репозитории Google Maven .

Добавьте зависимости для необходимых артефактов в файл build.gradle вашего приложения или модуля:

классный 

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

Котлин 

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

Для получения дополнительной информации о зависимостях см. раздел «Добавление зависимостей сборки» .

Обратная связь

Ваши отзывы помогают улучшить Jetpack. Сообщите нам, если вы обнаружите новые проблемы или у вас есть идеи по улучшению этой библиотеки. Пожалуйста, ознакомьтесь с существующими проблемами в этой библиотеке, прежде чем создавать новую. Вы можете проголосовать за существующую проблему, нажав кнопку со звездочкой.

Создать новую задачу

Для получения более подробной информации см. документацию по системе отслеживания ошибок .

Для этого артефакта отсутствуют примечания к выпуску.

Версия 1.0

Версия 1.0.0-alpha10

1 июля 2026 г.

Выпущены 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 содержит следующие коммиты .

Изменения в API

  • Added AppFunctionServiceEntryPoint . All AppFunction annotation must be declared within the AppFunctionService that is annotated with AppFunctionServiceEntryPoint ( Idc5d5 , b/463909015 )
  • Перемещены API-интерфейсы AppFunction и AppFunctionConfiguration . AppFunctionConfiguration будет удален в будущих релизах, так как он будет заменен на AppFunctionServiceEntryPoint ( Iaff23 , I4cf3e , b/517876475 ).
  • Обновлен API AppFunctionService для поддержки обратного вызова ( I6e0d7 , b/519880977 )
  • Добавить API searchAppFunctions ( I8c0f9 , I1fa27 , b/494239238 )
  • Added functionNames to AppFunctionSearchSpec ( I95f53 , b/494239238 )
  • Added AppFunctionInstruction annotation ( I21120 , b/488994214 )
  • Добавлена ​​аннотация AppFunctionSignature и соответствующие константы для объявления сигнатур функций приложения, зарегистрированных во время выполнения. ( I82a05 , Ie2361 , Ib6bb2 )

Исправлены ошибки

  • Исключить enabledByDefault из сгенерированного XML для AppFunctionSignatures ( Ie2996 , b/501032667 )

Версия 1.0.0-alpha09

6 мая 2026 г.

Выпущена версия androidx.appfunctions:appfunctions-*:1.0.0-alpha09 . Версия 1.0.0-alpha09 содержит следующие коммиты .

Изменения в API

  • Accept AppInteractionAttribution in ExecuteAppFunctionRequest ( I70ad8 , b/462092640 )

Исправлены ошибки

Версия 1.0.0-alpha08

11 марта 2026 г.

androidx.appfunctions:appfunctions-*:1.0.0-alpha08 is released. Version 1.0.0-alpha08 contains these commits .

Новые функции

  • Добавлена ​​поддержка Parcelable(s) помимо PendingIntent ( I8ab9f )
  • API для преобразования запросов и ответов с/на платформу ( Ifdf20 ),

Изменения в API

  • Соответствие параметров руководству по стилю. ( I69b2d )
  • Добавить API для преобразования запросов и ответов между платформой и данными ( Ifdf20 , b/476047880 )
  • Переименуйте AppFunctionManagerCompat в AppFunctionManager . ( Id9a78 , b/448372122 )
  • Удалить API-интерфейсы get/set для PendingIntent . ( Ic7fd6 , b/447530985 )
  • Add support for Parcelables and migrate PendingIntent to be represented as a Parcelable. ( I8ab9f , b/447530985 )

Исправлены ошибки

  • Moves libraries to use Java 11 target. This means produced bytecode will be Java 11 (class file version 55) and might require desugaring to use the library ( If4c2a , b/457821470 )

Версия 1.0.0-alpha07

19 ноября 2025 г.

Выпущена версия androidx.appfunctions:appfunctions-*:1.0.0-alpha07 . Версия 1.0.0-alpha07 содержит следующие коммиты .

Изменения в API

  • Поддержка устаревания функции AppFunction ( I39229 , b/454661174 )

Исправлены ошибки

  • Исправлена ​​ошибка с ненулевыми обязательными параметрами верхнего уровня ( Ic60fc , b/456717542 )

Версия 1.0.0-alpha06

5 ноября 2025 г.

Выпущена версия androidx.appfunctions:appfunctions-*:1.0.0-alpha06 . Версия 1.0.0-alpha06 содержит следующие коммиты .

Новые функции

  • Поддержка встраивания ресурсов в ответ AppFunction.
  • Разрешить использование FLAG_GRANT_PERSISTABLE_URI_PERMISSION в AppFunctionUriGrant

Изменения в API

Исправлены ошибки

  • Fix the issue that ignoring nullable required field would fail when constructing AppFunctionData ( I52195 )
  • Исправлена ​​ошибка, из-за которой использование List<PendingIntent> с AppFunction приводило к сбою на этапе компиляции ( Iebde7 ).
  • Fix the issue that ByteArray 's metadata was generated incorrectly as List<ByteArray> ( I2e499 )

Версия 1.0.0-alpha05

8 октября 2025 г.

Выпущена версия androidx.appfunctions:appfunctions-*:1.0.0-alpha05 . Версия 1.0.0-alpha05 содержит следующие коммиты .

Новые функции

  • Enforce required fields are provided when constructing AppFunctionData
  • Validating AppFunctionData against constraint values

Изменения в API

  • Добавить совместимые API AppFunctionService . ( I2f1b1 , b/445388953 )

Исправлены ошибки

  • Добавить проверку обязательного поля AppFunctionsData . ( I36b16 , b/394553462 )
  • Исправлена ​​ошибка, из-за которой не учитывалось необязательное состояние параметра при переопределении интерфейса.
  • Даже если в файле отсутствуют AppFunctions , генерируется пустой XML-файл, поскольку AppSearch ожидает соответствующий файл, указанный в манифесте приложения.

Версия 1.0.0-alpha04

10 сентября 2025 г.

androidx.appfunctions:appfunctions-*:1.0.0-alpha04 is released. Version 1.0.0-alpha04 contains these commits .

Исправлены ошибки

  • Исправлены ошибки R8 в релизных сборках.

Версия 1.0.0-alpha03

13 августа 2025 г.

Выпущена версия androidx.appfunctions:appfunctions-*:1.0.0-alpha03 . Версия 1.0.0-alpha03 содержит следующие коммиты .

Новые функции

  • Используйте KDoc(ы) в качестве описаний AppFunction .
  • Ограничьте значения для типов Int и String, используя аннотации AppFunctionIntValueConstraint и AppFunctionStringValueConstraint соответственно.
  • Specify a natural language description for large language models and a user visible description displayed within agent apps.
  • Автоматическое предоставление разрешений URI, возвращаемым функцией приложения, с помощью класса AppFunctionUriGrant .
  • Напишите тесты Robolectric, используя AppFunctionTestRule для проверки настройки функций вашего приложения.

Изменения в API

  • Add AppFunctionStringValueConstraint ( I10e3f )
  • Добавить AppFunctionIntValueConstraint ( Ifda13 )
  • Refactor AppFunctionPrimitiveTypeMetadata to specific data type classes. ( I1a3b2 )
  • Добавить поле описания в AppFunctionResponseMetadata ( I2332b )
  • Удалить требование о наличии разрешений из API setAppFunctionEnabled ( I1b92a )
  • Добавить поле описания в AppFunctionParameterMetadata ( I40a67 )
  • Добавить AppFunctionUriGrant ( I67ca9 )
  • Add resolveAppFunctionAppMetadata API. ( I17408 )
  • Добавьте isDescribedByKdoc в аннотацию @AppFunctionSerializable ( IE14E7 )
  • Добавить поле описания в AppFunctionDataTypeMetadata ( I1bcac )
  • Возвращает AppPackageMetadata из API observeAppFunctions . ( I68c7e )
  • Добавить поле описания в AppFunctionMetadata ( I060e2 )
  • Добавить AppFunctionTestRule ( Id5ed0 )
  • Add isDescribedByKdoc in @AppFunction annotation ( Ia84d2 )

Исправлены ошибки

  • AppFunctionManagerCompat only supports U+ devices ( 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 содержит следующие коммиты .

Новые функции

  • Поддерживаются API Android 16.
  • Better support for parameterized AppFunctionSerializable(s) at compile time.

Изменения в API

  • Представлен API AppFunctionSchemaDefinition , позволяющий агентам определять собственные предопределенные схемы функций.

Исправлены ошибки

  • Обработка ошибок, связанных с отсутствием состояния «включено во время выполнения» для AppFunctions .
  • Minor bugfix in observeAppFunctions API to observe changes in 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 .