appfunctions

  
Umożliwia aplikacjom udostępnianie funkcji i danych asystentom AI, dzięki czemu mogą oni wykrywać i wykonywać zadania bezpośrednio na urządzeniu, aby spełniać prośby użytkowników.
Najnowsza aktualizacja Wersja stabilna Wersja kandydująca do publikacji Wersja beta Wersja alfa
7 października 2026 r. - - - 1.0.0-alpha13

Deklarowanie zależności

Aby dodać zależność od appfunctions, musisz dodać do projektu repozytorium Maven Google. Więcej informacji znajdziesz w repozytorium Maven Google.

Dodaj zależności dotyczące potrzebnych artefaktów w pliku build.gradle aplikacji lub modułu:

Groovy

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

Więcej informacji o zależnościach znajdziesz w artykule Dodawanie zależności kompilacji.

Prześlij opinię

Twoja opinia pomoże nam ulepszyć Jetpacka. Jeśli odkryjesz nowe problemy lub masz pomysły na ulepszenie tej biblioteki, daj nam znać. Zanim utworzysz nową kartę, zapoznaj się z dotychczasowymi problemami w tej bibliotece. Możesz oddać głos na istniejący problem, klikając przycisk gwiazdki.

Tworzenie nowego problemu

Więcej informacji znajdziesz w dokumentacji narzędzia Issue Tracker.

Brak informacji o wersji tego artefaktu.

Wersja 1.0

Wersja 1.0.0-alpha13

7 października 2026 r.

androidx.appfunctions:appfunctions:1.0.0-alpha13, androidx.appfunctions:appfunctions-compiler:1.0.0-alpha13 i androidx.appfunctions:appfunctions-testing:1.0.0-alpha13 są udostępnione. Wersja 1.0.0-alpha13 zawiera te zmiany.

Zmiany w interfejsie API

  • Dodaj adnotację @AppFunctionAccessLevel, aby obsługiwać ustawienie ograniczenia dostępu. (Id47e1)
  • Zmień nazwę adnotacji AppFunction na AppFunctionDeclaration (I4b15d)
  • Zmień nazwę ObserveAppFunctionsEvent na AppFunctionsChangeEvent (Iec918)
  • Platforma AppFunctionMetadata w usłudze AppFunctionService. (If1117)

Poprawki błędów

  • Obsługa wszystkich wbudowanych typów proxy (LocalDate, LocalTime, Instant, ZoneId) w AppFunctionData. (I61c16)

Wersja 1.0.0-alpha12

23 września 2026 r.

androidx.appfunctions:appfunctions:1.0.0-alpha12, androidx.appfunctions:appfunctions-compiler:1.0.0-alpha12 i androidx.appfunctions:appfunctions-testing:1.0.0-alpha12 są udostępnione. Wersja 1.0.0-alpha12 zawiera te zmiany.

Zmiany w interfejsie API

  • Wymaga podania metadanych przez dzwoniącego w AppFunctionData#serialize. (I61eca)
  • Dodaje wbudowaną wersję getHandleAppFunctionRequestAdapter oprócz istniejącej wersji opartej na Class. (Ic1b4e)
  • Usuwa AppFunctionContext i AppFunctionConfiguration (I9dd8f)
  • Dodaje activityId do ExecuteAppFunctionRequest (I6ac86)
  • Dodaje użytkowników registerAppFunction, registerAppFunctions, RegisterAppFunctionRequest i CallbackAppFunction jako @ExperimentalAppFunctionsApi. (Idb2ca)
  • Dodaje scope w AppFunctionMetadata i AppFunctionSearchSpec (I4344c)
  • Dodaje AppFunctionUriValueConstraint jako publiczny interfejs API. (I75070)
  • Zaktualizuj konstruktor AppFunctionPackageMetadata (I096f7)

Wersja 1.0.0-alpha11

26 sierpnia 2026 r.

androidx.appfunctions:appfunctions:1.0.0-alpha11, androidx.appfunctions:appfunctions-compiler:1.0.0-alpha11 i androidx.appfunctions:appfunctions-testing:1.0.0-alpha11 są udostępnione. Wersja 1.0.0-alpha11 zawiera te zmiany.

Zmiany w interfejsie API

  • Dodano @AppFunctionSignature jako eksperymentalny publiczny interfejs API. Interfejs API obsługuje dynamiczną rejestrację AppFunction za pomocą Jetpacka. (I72e23, b/501032667)
  • Dodaj AppFunctionState i AppFunctionManager#getAppFunctionStates. Zastępuje ona AppFunctionMetadata#isEnabled. Metadane są teraz całkowicie oddzielone od stanu. (I8e490, b/494238383)
  • Add getAppFunctionActivityStates (I41093, b/542075714)
  • Dodaj ExtensionsAppFunctionService, aby obsługiwać aplikacje działające z urządzeniem pomocniczym. (I7cf10, b/524941402)
  • Zaktualizuj interfejs observeAppFunctions API, aby był zgodny z interfejsem API platformy. (Ifa6fb, b/494238381)

Poprawki błędów

  • Rozwiązaliśmy problem polegający na tym, że brakujące metadane środowiska wykonawczego mogły powodować awarię aplikacji podczas wywoływania funkcji setAppFunctionEnabled w trakcie pierwszego uruchomienia. (Ibe229, b/536750020)
  • Tymczasowo wyłącz weryfikację danych podczas korzystania z interfejsu AppFunctionData#serialize API, dopóki metadane nie będą pochodzić z tego samego źródła informacji. (I6c95, b/545200019)

Wersja 1.0.0-alpha10

1 lipca 2026 r.

androidx.appfunctions:appfunctions:1.0.0-alpha10, androidx.appfunctions:appfunctions-compiler:1.0.0-alpha10 i androidx.appfunctions:appfunctions-testing:1.0.0-alpha10 są udostępnione. Wersja 1.0.0-alpha10 zawiera te zmiany.

Zmiany w interfejsie API

  • Dodano: AppFunctionServiceEntryPoint. Wszystkie adnotacje AppFunction muszą być zadeklarowane w AppFunctionService, które jest oznaczone adnotacją AppFunctionServiceEntryPoint (Idc5d5, b/463909015).
  • Przeniesiono interfejsy API AppFunction i AppFunctionConfiguration . AppFunctionConfiguration zostanie usunięty w przyszłej wersji, ponieważ zostanie zastąpiony przez AppFunctionServiceEntryPoint (Iaff23, I4cf3e, b/517876475).
  • Zaktualizowano interfejs AppFunctionService API, aby obsługiwał wywołanie zwrotne (I6e0d7, b/519880977).
  • Dodaj interfejs searchAppFunctions API (I8c0f9, I1fa27, b/494239238)
  • Dodano functionNames do AppFunctionSearchSpec (I95f53, b/494239238)
  • Dodano adnotację AppFunctionInstruction (I21120, b/488994214)
  • Dodaliśmy adnotację AppFunctionSignature i powiązane z nią stałe, aby deklarować sygnatury funkcji aplikacji zarejestrowanych w czasie działania. (I82a05, Ie2361, Ib6bb2)

Poprawki błędów

  • Usuwanie enabledByDefault z wygenerowanego pliku XML dla AppFunctionSignatures (Ie2996, b/501032667)

Wersja 1.0.0-alpha09

6 maja 2026 r.

Publikacja androidx.appfunctions:appfunctions-*:1.0.0-alpha09 Wersja 1.0.0-alpha09 zawiera te zmiany.

Zmiany w interfejsie API

  • Akceptowanie AppInteractionAttribution w ExecuteAppFunctionRequest (I70ad8, b/462092640)

Poprawki błędów

  • Rozwiązano problem ze zgodnością AppFunctionUriGrant w pakiecie SDK37 (I21110, b/485613578)

Wersja 1.0.0-alpha08

11 marca 2026 r.

Publikacja androidx.appfunctions:appfunctions-*:1.0.0-alpha08 Wersja 1.0.0-alpha08 zawiera te zmiany.

Nowe funkcje

  • Dodano obsługę interfejsu Parcelable (s) oprócz interfejsu PendingIntent (I8ab9f)
  • interfejsy API do konwersji z żądania i odpowiedzi platformy na format Ifdf20 i odwrotnie;

Zmiany w interfejsie API

  • Zgodność parametru z poradnikiem dotyczącym stylów. (I69b2d)
  • Dodanie interfejsów API do konwersji z platformy na żądanie i odpowiedź (Ifdf20, b/476047880)
  • Zmień nazwę AppFunctionManagerCompat na AppFunctionManager. (Id9a78, b/448372122)
  • Usuń interfejsy API get/set dla usługi PendingIntent. (Ic7fd6, b/447530985)
  • Dodaj obsługę obiektów Parcelable i przekształć PendingIntent w obiekt Parcelable. (I8ab9f, b/447530985)

Poprawki błędów

  • Przenosi biblioteki do korzystania z Javy 11. Oznacza to, że wygenerowany kod bajtowy będzie zgodny z Java 11 (wersja pliku klasy 55) i może wymagać desugaryzacji, aby można było używać biblioteki (If4c2a, b/457821470).

Wersja 1.0.0-alpha07

19 listopada 2025 r.

Publikacja androidx.appfunctions:appfunctions-*:1.0.0-alpha07 Wersja 1.0.0-alpha07 zawiera te zmiany.

Zmiany w interfejsie API

Poprawki błędów

  • Rozwiązanie problemu z wymaganymi parametrami najwyższego poziomu, które nie mogą mieć wartości null (Ic60fc, b/456717542)

Wersja 1.0.0-alpha06

5 listopada 2025 r.

Publikacja androidx.appfunctions:appfunctions-*:1.0.0-alpha06 Wersja 1.0.0-alpha06 zawiera te zmiany.

Nowe funkcje

  • Obsługa osadzania zasobu w ramach odpowiedzi AppFunction
  • Zezwalaj na korzystanie z usługi FLAG_GRANT_PERSISTABLE_URI_PERMISSION w AppFunctionUriGrant

Zmiany w interfejsie API

Poprawki błędów

  • Rozwiązanie problemu z ignorowaniem pola wymaganego dopuszczającego wartość null podczas tworzenia AppFunctionData (I52195)
  • Naprawiono problem, który powodował, że używanie List<PendingIntent> z AppFunction kończyło się niepowodzeniem w czasie kompilacji (Iebde7).
  • Rozwiązanie problemu polegającego na tym, że metadane ByteArray zostały nieprawidłowo wygenerowane jako List<ByteArray> (I2e499)

Wersja 1.0.0-alpha05

8 października 2025 r.

Publikacja androidx.appfunctions:appfunctions-*:1.0.0-alpha05 Wersja 1.0.0-alpha05 zawiera te zmiany.

Nowe funkcje

  • Wymagane pola są podawane podczas tworzenia AppFunctionData
  • Sprawdzanie wartości AppFunctionData pod kątem wartości ograniczeń

Zmiany w interfejsie API

Poprawki błędów

  • Dodaj wymagane pole AppFunctionsData. (I36b16, b/394553462)
  • Rozwiązaliśmy problem polegający na tym, że podczas zastępowania interfejsu nie był uwzględniany opcjonalny stan parametru.
  • Generuj pusty plik XML nawet wtedy, gdy nie ma żadnych AppFunctions, ponieważ AppSearch oczekuje odpowiedniego pliku określonego w manifeście aplikacji.

Wersja 1.0.0-alpha04

10 września 2025 r.

Publikacja androidx.appfunctions:appfunctions-*:1.0.0-alpha04 Wersja 1.0.0-alpha04 zawiera te zmiany.

Poprawki błędów

  • Rozwiąż problemy z R8 w przypadku wersji do publikacji.

Wersja 1.0.0-alpha03

13 sierpnia 2025 r.

Publikacja androidx.appfunctions:appfunctions-*:1.0.0-alpha03 Wersja 1.0.0-alpha03 zawiera te zmiany.

Nowe funkcje

  • Używanie KDoc jako AppFunction opisów
  • Ogranicz wartości typów Int i String za pomocą odpowiednio adnotacji AppFunctionIntValueConstraint i AppFunctionStringValueConstraint.
  • Określ opis w języku naturalnym dla dużych modeli językowych oraz opis widoczny dla użytkownika, który będzie wyświetlany w aplikacjach agenta.
  • Automatyczne przyznawanie uprawnień do adresów URI zwracanych przez funkcję aplikacji za pomocą klasy AppFunctionUriGrant.
  • Napisz testy Robolectric, używając AppFunctionTestRule, aby przetestować konfigurację funkcji aplikacji.

Zmiany w interfejsie API

  • Dodaj AppFunctionStringValueConstraint (I10e3f)
  • Dodaj AppFunctionIntValueConstraint (Ifda13)
  • Przeprowadź refaktoryzację AppFunctionPrimitiveTypeMetadata do klas konkretnych typów danych. (I1a3b2)
  • Dodaj pole opisu w AppFunctionResponseMetadata (I2332b)
  • Usunięto wymaganie dotyczące uprawnień z interfejsu API setAppFunctionEnabled (I1b92a)
  • Dodaj pole opisu w AppFunctionParameterMetadata (I40a67)
  • Dodaj AppFunctionUriGrant (I67ca9)
  • Dodaj interfejs resolveAppFunctionAppMetadata API. (I17408)
  • Dodawanie adnotacji isDescribedByKdoc w @AppFunctionSerializable (Ie14e7)
  • Dodaj pole opisu w AppFunctionDataTypeMetadata (I1bcac)
  • Zwraca AppPackageMetadata z interfejsu observeAppFunctions API. (I68c7e)
  • Dodaj pole opisu w AppFunctionMetadata (I060e2)
  • Dodaj AppFunctionTestRule (Id5ed0)
  • Dodaj adnotację isDescribedByKdoc w @AppFunction (Ia84d2)

Poprawki błędów

  • AppFunctionManagerCompat obsługuje tylko urządzenia U+ (Ifa8d0)
  • Dodaj opisy właściwości udostępnionych typów serializowalnych w pliku XML metadanych AppFunction (I2aab2)
  • Dodaj element opisu do wygenerowanego pliku XML metadanych AppFunction (Ie5bf6).

Wersja 1.0.0-alpha02

4 czerwca 2025 r.

androidx.appfunctions:appfunctions:1.0.0-alpha02, androidx.appfunctions:appfunctions-compiler:1.0.0-alpha02 i androidx.appfunctions:appfunctions-service:1.0.0-alpha02 są udostępnione. Wersja 1.0.0-alpha02 zawiera te zmiany.

Nowe funkcje

  • Obsługa interfejsów API Androida 16.
  • Lepsza obsługa sparametryzowanych funkcji AppFunctionSerializable(s) w czasie kompilacji.

Zmiany w interfejsie API

  • Wprowadziliśmy interfejs AppFunctionSchemaDefinition API, który umożliwia agentom definiowanie własnych predefiniowanych schematów funkcji.

Poprawki błędów

  • Obsługa błędów w przypadku braku stanu włączenia środowiska wykonawczego w przypadku AppFunctions.
  • Drobna poprawka błędu w interfejsie observeAppFunctions API, aby uwzględniać zmiany w AppFunctionComponentMetadata.
  • Dodatkowe logi błędów.

Wersja 1.0.0-alpha01

7 maja 2025 r.

androidx.appfunctions:appfunctions:1.0.0-alpha01, androidx.appfunctions:appfunctions-compiler:1.0.0-alpha01 i androidx.appfunctions:appfunctions-service:1.0.0-alpha01 są udostępnione. Wersja 1.0.0-alpha01 zawiera te zmiany.

Nowe funkcje

Biblioteka AppFunctionsJetpackandroid.app.appfunctions jest oparta na interfejsach API platformy. Ta biblioteka ułatwia udostępnianie funkcji aplikacji Asystentowi i umożliwia mu interakcję z udostępnionymi funkcjami aplikacji.

  • androidx.appfunctions:appfunctions: podstawowe interfejsy API klienta do zarządzania (włączanie/wyłączanie) i interakcji (wyszukiwanie/wykonywanie) z AppFunctions.
  • androidx.appfunctions:appfunctions-service: interfejsy API po stronie usługi, które umożliwiają łatwe udostępnianie funkcji aplikacji jako AppFunctions.
  • androidx.appfunctions:appfunctions-compiler: wymagany kompilator KSP do wygenerowania kodu niezbędnego do udostępnienia AppFunctions.