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
23 września 2026 r. - - - 1.0.0-alpha12

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

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-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 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 on 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 dodatkowym. (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, który powodował, ż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 API AppFunctionService, aby obsługiwał wywołania 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)
  • Dodano adnotację AppFunctionSignature i powiązane z nią stałe, aby deklarować zarejestrowane w czasie działania sygnatury funkcji aplikacji. (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 (Ifdf20),

Zmiany w interfejsie API

  • Zgodność parametru z poradnikiem dotyczącym stylów. (I69b2d)
  • Dodanie interfejsów API do konwersji z żądania i odpowiedzi platformy na żądanie i odpowiedź interfejsu API (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 Java 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, które może mieć 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, który powodował, że metadane ByteArray były nieprawidłowo generowane 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 pole wymagane 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ązywanie problemów 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 dokumentów KDoc jako opisów AppFunction
  • 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)
  • Dodaj adnotację isDescribedByKdoc w @AppFunctionSerializable (Ie14e7)
  • Dodaj pole opisu w AppFunctionDataTypeMetadata (I1bcac)
  • Zwraca AppPackageMetadata z interfejsu API observeAppFunctions. (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 serializowanych 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.

  • androidx.appfunctions:appfunctions: podstawowe interfejsy API klienta do zarządzania (włączania i wyłączania) oraz interakcji (wyszukiwania i wykonywania) 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 generowania kodu niezbędnego do udostępniania AppFunctions.