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

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

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

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

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

классный 

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

Котлин 

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

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

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

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

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

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

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

Версия 1.0

Версия 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 )
  • Временно отключить проверку данных при использовании API AppFunctionData#serialize до тех пор, пока метаданные не будут поступать из одного и того же источника достоверной информации. ( 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

  • Accept AppInteractionAttribution in 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

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

  • Исправлена ​​ошибка, из-за которой игнорирование обязательного поля, допускающего значение 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

  • Добавить совместимые 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 . Версия 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 )
  • Добавить API resolveAppFunctionAppMetadata . ( 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 .
  • Исправлена ​​незначительная ошибка в API observeAppFunctions , позволяющая отслеживать изменения в 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 .