Чтобы переводить контент на ваш предпочитаемый язык, Google использует технологии на основе искусственного интеллекта. Переводы от ИИ могут содержать ошибки.

appfunctions

Документация по API
androidx.appfunctions

Позволяет приложениям делиться функциями и данными с ИИ-помощниками, чтобы те могли находить и выполнять задачи непосредственно на устройстве в соответствии с запросами пользователей.

Последнее обновление	Основная версия	Release Candidate	Бета-версия	Альфа-версия
7 октября 2026 г.	-	-	-	1.0.0-alpha13

Как объявлять зависимости

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

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

Яркий

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

Kotlin

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

Подробнее о зависимостях приведено в статье Добавление зависимостей сборки.

Отзыв

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

Как создать новую проблему

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

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

Версия 1.0

Версия 1.0.0-alpha13

7 октября 2026 г.

androidx.appfunctions:appfunctions:1.0.0-alpha13, androidx.appfunctions:appfunctions-compiler:1.0.0-alpha13 и androidx.appfunctions:appfunctions-testing:1.0.0-alpha13. Версия 1.0.0-alpha13 содержит эти коммиты.

Изменения в API

Добавьте аннотацию @AppFunctionAccessLevel, чтобы поддерживать настройку ограничения доступа. (Id47e1)
Переименование аннотации AppFunction в AppFunctionDeclaration (I4b15d)
Переименовать ObserveAppFunctionsEvent в AppFunctionsChangeEvent (Iec918)
Покажи AppFunctionMetadata в AppFunctionService. (If1117)

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

Поддержка всех встроенных типов прокси (LocalDate, LocalTime, Instant, ZoneId) в AppFunctionData. (I61c16)

Версия 1.0.0-alpha12

23 сентября 2026 г.

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 содержит эти коммиты.

Изменения в API

Требуется, чтобы звонящий через AppFunctionData#serialize предоставил метаданные. (I61eca)
Добавляет встроенную реализацию getHandleAppFunctionRequestAdapter в дополнение к существующей перегрузке на основе Class. (Ic1b4e)
Удалены инструменты "AppFunctionContext" и "AppFunctionConfiguration" (I9dd8f)
Добавляет activityId в ExecuteAppFunctionRequest (I6ac86)
Добавляет registerAppFunction, registerAppFunctions, RegisterAppFunctionRequest и CallbackAppFunction как @ExperimentalAppFunctionsApi. (Idb2ca)
Добавлены scope в AppFunctionMetadata и AppFunctionSearchSpec (I4344c)
Добавлен общедоступный API AppFunctionUriValueConstraint. (I75070)
Обновление конструктора AppFunctionPackageMetadata (I096f7)

Версия 1.0.0-alpha11

26 августа 2026 г.

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 содержит эти коммиты.

Изменения в API

Добавлен @AppFunctionSignature как экспериментальный общедоступный API. API поддерживает динамическую регистрацию AppFunction через Jetpack. (I72e23, b/501032667)
Добавьте AppFunctionState и AppFunctionManager#getAppFunctionStates. Это заменяет AppFunctionMetadata#isEnabled. Метаданные теперь полностью отделены от состояния. (I8e490, b/494238383)
Add getAppFunctionActivityStates. (I41093, b/542075714)
Добавьте ExtensionsAppFunctionService, чтобы поддерживать приложения, работающие с Sidecar. (I7cf10, b/524941402)
Обновите API observeAppFunctions, чтобы он соответствовал API платформы. (Ifa6fb, b/494238381)

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

Исправлена ошибка, из-за которой отсутствие метаданных времени выполнения могло приводить к сбою приложения при вызове setAppFunctionEnabled во время первого запуска. (Ibe229, b/536750020)
Временно отключите проверку данных при использовании AppFunctionData#serialize API, пока метаданные не будут поступать из одного источника. (I6c95, b/545200019)

Версия 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

Добавлен AppFunctionServiceEntryPoint. Все аннотации AppFunction должны быть объявлены в элементе AppFunctionService, аннотированном с помощью AppFunctionServiceEntryPoint (Idc5d5, b/463909015).
Перемещены API AppFunction и AppFunctionConfiguration . AppFunctionConfiguration будет удален в будущем выпуске, поскольку будет заменен на AppFunctionServiceEntryPoint (Iaff23, I4cf3e, b/517876475)
Обновлен API AppFunctionService для поддержки обратного вызова (I6e0d7, b/519880977).
Добавление API searchAppFunctions (I8c0f9, I1fa27, b/494239238)
Добавлен functionNames в AppFunctionSearchSpec (I95f53, b/494239238)
Добавлена аннотация AppFunctionInstruction (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

Принять AppInteractionAttribution в ExecuteAppFunctionRequest (I70ad8, b/462092640)

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

Исправлена проблема совместимости AppFunctionUriGrant с SDK37 (I21110, b/485613578)

Версия 1.0.0-alpha08

11 марта 2026 г.

Выход androidx.appfunctions:appfunctions-*:1.0.0-alpha08. Версия 1.0.0-alpha08 содержит эти коммиты.

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

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

Изменения в API

Соответствие параметров руководству по стилю. (I69b2d)
Добавлены API для преобразования запросов и ответов платформы (Ifdf20, b/476047880).
Переименуйте AppFunctionManagerCompat в AppFunctionManager. (Id9a78, b/448372122)
Удалите API get/set для PendingIntent. (Ic7fd6, b/447530985)
Добавьте поддержку объектов Parcelable и перенесите PendingIntent в Parcelable. (I8ab9f, b/447530985)

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

Переход на целевую версию Java 11. Это означает, что сгенерированный байт-код будет соответствовать Java 11 (версия файла класса 55) и для использования библиотеки может потребоваться десахаризация (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

Добавлен API ResourceHolder (I08c1c, b/447530724).
Добавление API AppFunctionTextResource (I7d54f, b/447530724)
Добавление API AppFunctionOneOfTypeMetadata (I12c67, b/449915612)
Удалите суффикс Compat из API сервисов. (Ib9291, b/449797980, b/449797980)
Поддерживаемая сборка AppFunctionData от AllOfType (Ib1176, b/447535093)
Добавлены API get/set Parcelable в AppFunctionData (I3aec7, b/447530985)

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

Исправлена ошибка, из-за которой игнорирование обязательного поля, допускающего значение NULL, приводило к сбою при создании AppFunctionData (I52195)
Исправлена проблема, из-за которой использование List<PendingIntent> с AppFunction приводило к ошибке во время компиляции (Iebde7).
Исправлена проблема, из-за которой метаданные ByteArray были неправильно сгенерированы как List<ByteArray> (I2e499)

Версия 1.0.0-alpha05

8 октября 2025 г.

Выход androidx.appfunctions:appfunctions-*:1.0.0-alpha05. Версия 1.0.0-alpha05 содержит эти коммиты.

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

Обеспечьте заполнение обязательных полей при создании AppFunctionData.
Проверка AppFunctionData на соответствие ограничениям

Изменения в API

Добавьте AppFunctionService Compat API. (I2f1b1, b/445388953)

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

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

Версия 1.0.0-alpha04

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

Выход androidx.appfunctions:appfunctions-*:1.0.0-alpha04. Версия 1.0.0-alpha04 содержит эти коммиты.

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

Исправлять ошибки R8 в сборках для выпуска.

Версия 1.0.0-alpha03

13 августа 2025 г.

Выход androidx.appfunctions:appfunctions-*:1.0.0-alpha03. Версия 1.0.0-alpha03 содержит эти коммиты.

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

Используйте KDoc в качестве описаний AppFunction
Ограничьте значения для типов Int и String, используя аннотации AppFunctionIntValueConstraint и AppFunctionStringValueConstraint соответственно.
Укажите описание на естественном языке для больших языковых моделей и описание, которое будет показываться пользователям в приложениях агентов.
Автоматически предоставлять разрешения для URI, возвращаемых из функции приложения, с помощью класса AppFunctionUriGrant.
Напишите тесты Robolectric, используя AppFunctionTestRule, чтобы проверить настройки функций приложения.

Изменения в API

Добавить AppFunctionStringValueConstraint (I10e3f)
Добавить AppFunctionIntValueConstraint (Ifda13)
Рефакторинг AppFunctionPrimitiveTypeMetadata в классы определенных типов данных. (I1a3b2)
Добавление поля описания в AppFunctionResponseMetadata (I2332b)
Удаление требования к разрешению из API setAppFunctionEnabled (I1b92a)
Добавление поля описания в файл AppFunctionParameterMetadata (I40a67)
Добавить AppFunctionUriGrant (I67ca9)
Добавьте resolveAppFunctionAppMetadata API. (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 содержит эти коммиты.

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

Поддержка API Android 16.
Улучшена поддержка параметризованных типов AppFunctionSerializable(s) во время компиляции.

Изменения в API

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

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

Обработка ошибок для отсутствующего состояния AppFunctions, включенного во время выполнения.
Исправлена незначительная ошибка в observeAppFunctions API, чтобы отслеживать изменения в 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.