appfunctions

  
Permet aux applications de partager des fonctionnalités et des données avec les assistants IA, ce qui leur permet de découvrir et d'exécuter des tâches directement sur l'appareil pour répondre aux demandes des utilisateurs.
Dernière mise à jour Version stable Version finale Version bêta Version alpha
23 septembre 2026 - - - 1.0.0-alpha12

Déclarer des dépendances

Pour ajouter une dépendance sur appfunctions, vous devez ajouter le dépôt Maven de Google à votre projet. Pour en savoir plus, consultez la section Dépôt Maven de Google.

Ajoutez les dépendances correspondant aux artefacts dont vous avez besoin dans le fichier build.gradle de votre application ou de votre module :

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")
}

Pour en savoir plus sur les dépendances, consultez Ajouter des dépendances de compilation.

Commentaires

Vos commentaires nous aident à améliorer Jetpack. N'hésitez pas à nous contacter si vous découvrez de nouveaux problèmes ou si vous avez des idées pour améliorer cette bibliothèque. Veuillez consulter les problèmes existants de cette bibliothèque avant d'en signaler un nouveau. Vous pouvez ajouter votre vote à un problème existant en cliquant sur le bouton en forme d'étoile.

Signaler un nouveau problème

Pour en savoir plus, consultez la documentation sur l'outil Issue Tracker.

Aucune note de version pour cet artefact.

Version 1.0

Version 1.0.0-alpha12

23 septembre 2026

Publication d'androidx.appfunctions:appfunctions:1.0.0-alpha12, androidx.appfunctions:appfunctions-compiler:1.0.0-alpha12 et androidx.appfunctions:appfunctions-testing:1.0.0-alpha12. Liste des commits de la version 1.0.0-alpha12

Modifications apportées à l'API

  • Nécessite que l'appelant AppFunctionData#serialize fournisse des métadonnées. (I61eca)
  • Ajoute getHandleAppFunctionRequestAdapter réifié intégré en plus de la surcharge existante basée sur Class. (Ic1b4e)
  • Suppression de AppFunctionContext et AppFunctionConfiguration (I9dd8f)
  • Ajout de activityId à ExecuteAppFunctionRequest (I6ac86).
  • Ajoute registerAppFunction, registerAppFunctions, RegisterAppFunctionRequest et CallbackAppFunction en tant que @ExperimentalAppFunctionsApi. (Idb2ca)
  • Ajoute scope dans AppFunctionMetadata et AppFunctionSearchSpec (I4344c)
  • Ajout de AppFunctionUriValueConstraint en tant qu'API publique. (I75070)
  • Mise à jour du constructeur AppFunctionPackageMetadata (I096f7)

Version 1.0.0-alpha11

26 août 2026

Publication d'androidx.appfunctions:appfunctions:1.0.0-alpha11, androidx.appfunctions:appfunctions-compiler:1.0.0-alpha11 et androidx.appfunctions:appfunctions-testing:1.0.0-alpha11. Liste des commits de la version 1.0.0-alpha11

Modifications apportées à l'API

  • Ajout de @AppFunctionSignature en tant qu'API publique expérimentale. L'API est compatible avec l'enregistrement dynamique d'AppFunction via Jetpack. (I72e23, b/501032667)
  • Ajout de AppFunctionState et de AppFunctionManager#getAppFunctionStates. Cela remplace AppFunctionMetadata#isEnabled. Les métadonnées sont désormais complètement séparées de l'état. (I8e490, b/494238383)
  • Add getAppFunctionActivityStates. (I41093, b/542075714)
  • Ajoutez ExtensionsAppFunctionService pour que les applications fonctionnent avec Sidecar. (I7cf10, b/524941402)
  • Mettez à jour l'API observeAppFunctions pour qu'elle corresponde à l'API de la plate-forme. (Ifa6fb, b/494238381)

Correction de bugs

  • Correction du problème qui pouvait entraîner le plantage de l'application lors de l'appel de setAppFunctionEnabled pendant l'OOBE en raison de métadonnées d'exécution manquantes. (Ibe229, b/536750020)
  • Désactivez temporairement la validation des données lorsque vous utilisez l'API AppFunctionData#serialize jusqu'à ce que les métadonnées proviennent de la même source de vérité. (I6c95, b/545200019)

Version 1.0.0-alpha10

1er juillet 2026

Publication d'androidx.appfunctions:appfunctions:1.0.0-alpha10, androidx.appfunctions:appfunctions-compiler:1.0.0-alpha10 et androidx.appfunctions:appfunctions-testing:1.0.0-alpha10. Liste des commits de la version 1.0.0-alpha10

Modifications apportées à l'API

  • Ajout de AppFunctionServiceEntryPoint Toutes les annotations AppFunction doivent être déclarées dans le AppFunctionService annoté avec AppFunctionServiceEntryPoint. (Idc5d5, b/463909015)
  • Déplacement des API AppFunction et AppFunctionConfiguration . AppFunctionConfiguration sera supprimé dans une prochaine version, car il sera remplacé par AppFunctionServiceEntryPoint. (Iaff23, I4cf3e, b/517876475)
  • Mise à jour de l'API AppFunctionService pour prendre en charge le rappel (I6e0d7, b/519880977)
  • Ajout de l'API searchAppFunctions (I8c0f9, I1fa27, b/494239238)
  • Ajout de functionNames à AppFunctionSearchSpec (I95f53, b/494239238)
  • Ajout de l'annotation AppFunctionInstruction (I21120, b/488994214)
  • Ajout de l'annotation AppFunctionSignature et des constantes associées pour déclarer les signatures de fonction d'application enregistrées au moment de l'exécution. (I82a05, Ie2361, Ib6bb2)

Correction de bugs

  • Omission de enabledByDefault dans le code XML généré pour AppFunctionSignatures (Ie2996, b/501032667)

Version 1.0.0-alpha09

6 mai 2026

Publication d'androidx.appfunctions:appfunctions-*:1.0.0-alpha09. Liste des commits de la version 1.0.0-alpha09

Modifications apportées à l'API

  • Accepter AppInteractionAttribution dans ExecuteAppFunctionRequest (I70ad8, b/462092640)

Correction de bugs

  • Correction du problème de compatibilité de AppFunctionUriGrant sur le SDK 37 (I21110, b/485613578)

Version 1.0.0-alpha08

11 mars 2026

Publication d'androidx.appfunctions:appfunctions-*:1.0.0-alpha08. Liste des commits de la version 1.0.0-alpha08

Nouvelles fonctionnalités

  • Ajout de la prise en charge des Parcelable en plus de PendingIntent (I8ab9f)
  • API permettant de convertir les requêtes et les réponses de la plate-forme (Ifdf20).

Modifications apportées à l'API

  • Conformité des paramètres avec le guide de style. (I69b2d)
  • Ajout d'API pour convertir les requêtes et les réponses de la plate-forme (Ifdf20, b/476047880)
  • AppFunctionManagerCompat a été renommé AppFunctionManager. (Id9a78, b/448372122)
  • Suppression des API get/set pour PendingIntent. (Ic7fd6, b/447530985)
  • Ajoutez la prise en charge des Parcelables et migrez PendingIntent pour qu'il soit représenté en tant que Parcelable. (I8ab9f, b/447530985)

Correction de bugs

  • Les bibliothèques sont déplacées pour utiliser la cible Java 11. Cela signifie que le bytecode produit sera Java 11 (version 55 du fichier de classe) et pourra nécessiter une désucrage pour utiliser la bibliothèque (If4c2a, b/457821470).

Version 1.0.0-alpha07

19 novembre 2025

Publication d'androidx.appfunctions:appfunctions-*:1.0.0-alpha07. Liste des commits de la version 1.0.0-alpha07

Modifications apportées à l'API

Correction de bugs

  • Correction du problème lié aux paramètres de premier niveau requis non nuls (Ic60fc, b/456717542)

Version 1.0.0-alpha06

5 novembre 2025

Publication d'androidx.appfunctions:appfunctions-*:1.0.0-alpha06. Liste des commits de la version 1.0.0-alpha06

Nouvelles fonctionnalités

  • Prise en charge de l'intégration de ressources dans la réponse AppFunction
  • Autoriser l'utilisation de FLAG_GRANT_PERSISTABLE_URI_PERMISSION dans AppFunctionUriGrant

Modifications apportées à l'API

Correction de bugs

  • Correction du problème qui empêchait d'ignorer un champ obligatoire pouvant être nul lors de la construction de AppFunctionData (I52195).
  • Correction du problème qui entraînait l'échec de l'utilisation de List<PendingIntent> avec AppFunction au temps de compilation (Iebde7).
  • Correction du problème lié à la génération incorrecte des métadonnées de ByteArray en tant que List<ByteArray> (I2e499)

Version 1.0.0-alpha05

8 octobre 2025

Publication d'androidx.appfunctions:appfunctions-*:1.0.0-alpha05. Liste des commits de la version 1.0.0-alpha05

Nouvelles fonctionnalités

  • Appliquer les champs obligatoires fournis lors de la construction de AppFunctionData
  • Valider AppFunctionData par rapport aux valeurs de contrainte

Modifications apportées à l'API

Correction de bugs

  • Ajoutez le champ obligatoire AppFunctionsData. (I36b16, b/394553462)
  • Correction du problème qui empêchait l'état facultatif du paramètre d'être respecté lors du remplacement d'une interface.
  • Générez un fichier XML vide même en l'absence de AppFunctions, car AppSearch attend le fichier correspondant spécifié dans le fichier manifeste de l'application.

Version 1.0.0-alpha04

10 septembre 2025

Publication d'androidx.appfunctions:appfunctions-*:1.0.0-alpha04. Liste des commits de la version 1.0.0-alpha04

Correction de bugs

  • Résolvez les problèmes R8 pour les builds de version.

Version 1.0.0-alpha03

13 août 2025

Publication d'androidx.appfunctions:appfunctions-*:1.0.0-alpha03. Liste des commits de la version 1.0.0-alpha03

Nouvelles fonctionnalités

  • Utiliser les KDocs comme descriptions AppFunction
  • Restreignez les valeurs pour les types Int et String à l'aide des annotations AppFunctionIntValueConstraint et AppFunctionStringValueConstraint, respectivement.
  • Spécifiez une description en langage naturel pour les grands modèles de langage et une description visible par l'utilisateur affichée dans les applications d'agent.
  • Accorder automatiquement des autorisations aux URI renvoyés par une fonction d'application à l'aide de la classe AppFunctionUriGrant.
  • Écrivez des tests Robolectric à l'aide de AppFunctionTestRule pour tester la configuration de la fonction de votre application.

Modifications apportées à l'API

  • Ajout de AppFunctionStringValueConstraint (I10e3f)
  • Ajout de AppFunctionIntValueConstraint (Ifda13)
  • Refactorisez AppFunctionPrimitiveTypeMetadata en classes de types de données spécifiques. (I1a3b2)
  • Ajout d'un champ de description dans AppFunctionResponseMetadata (I2332b)
  • Suppression de l'exigence d'autorisation de l'API setAppFunctionEnabled (I1b92a)
  • Ajout d'un champ de description dans AppFunctionParameterMetadata (I40a67)
  • Ajout de AppFunctionUriGrant (I67ca9)
  • Ajout de l'API resolveAppFunctionAppMetadata. (I17408)
  • Ajout de l'annotation isDescribedByKdoc dans @AppFunctionSerializable (Ie14e7)
  • Ajouter un champ de description dans AppFunctionDataTypeMetadata (I1bcac)
  • Renvoie AppPackageMetadata à partir de l'API observeAppFunctions. (I68c7e)
  • Ajout d'un champ de description dans AppFunctionMetadata (I060e2)
  • Ajout de AppFunctionTestRule (Id5ed0)
  • Ajout de isDescribedByKdoc dans l'annotation @AppFunction (Ia84d2)

Correction de bugs

  • AppFunctionManagerCompat n'est compatible qu'avec les appareils U+ (Ifa8d0)
  • Ajouter des descriptions de propriétés de types sérialisables partagés dans le fichier XML de métadonnées de AppFunction (I2aab2)
  • Ajouter un élément de description dans le fichier XML de métadonnées AppFunction généré (Ie5bf6)

Version 1.0.0-alpha02

4 juin 2025

Publication d'androidx.appfunctions:appfunctions:1.0.0-alpha02, androidx.appfunctions:appfunctions-compiler:1.0.0-alpha02 et androidx.appfunctions:appfunctions-service:1.0.0-alpha02. Liste des commits de la version 1.0.0-alpha02

Nouvelles fonctionnalités

  • Compatibilité avec les API Android 16.
  • Meilleure prise en charge de AppFunctionSerializable(s) paramétré au moment de la compilation.

Modifications apportées à l'API

  • L'API AppFunctionSchemaDefinition a été introduite, permettant aux agents de définir leurs propres schémas de fonctions prédéfinies.

Correction de bugs

  • Gestion des exceptions pour l'état d'exécution manquant de AppFunctions.
  • Correction de bug mineur dans l'API observeAppFunctions pour observer les modifications dans AppFunctionComponentMetadata.
  • Journaux d'erreurs supplémentaires.

Version 1.0.0-alpha01

7 mai 2025

Publication d'androidx.appfunctions:appfunctions:1.0.0-alpha01, androidx.appfunctions:appfunctions-compiler:1.0.0-alpha01 et androidx.appfunctions:appfunctions-service:1.0.0-alpha01. Liste des commits de la version 1.0.0-alpha01

Nouvelles fonctionnalités

La bibliothèque Jetpack AppFunctions est basée sur les API de plate-forme android.app.appfunctions. Cette bibliothèque simplifie l'exposition des fonctionnalités de votre application à l'Assistant et permet à l'Assistant d'interagir avec les fonctions exposées de l'application.

  • androidx.appfunctions:appfunctions : API client principales pour gérer (activer/désactiver) et interagir avec (rechercher/exécuter) AppFunctions.
  • androidx.appfunctions:appfunctions-service : API côté serveur permettant d'exposer facilement les fonctionnalités de votre application en tant que AppFunctions.
  • androidx.appfunctions:appfunctions-compiler : compilateur KSP requis pour générer le code nécessaire à l'exposition de AppFunctions.