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
1 lipca 2026 r. - - - 1.0.0-alpha10

Deklarowanie zależności

Aby dodać zależność od funkcji aplikacji, musisz dodać do projektu repozytorium Maven Google. Więcej informacji znajdziesz w artykule 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-alpha10"
    implementation "androidx.appfunctions:appfunctions-service:1.0.0-alpha10"
    // 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-alpha10"
}

Kotlin

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

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.

Nie ma informacji o wersji tego artefaktu.

Wersja 1.0

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ą zwalniane. 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łanie zwrotne (I6e0d7, b/519880977)
  • Dodanie interfejsu API searchAppFunctions (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 zadeklarować sygnatury funkcji aplikacji zarejestrowanych w czasie działania. (I82a05, Ie2361, Ib6bb2)

Poprawki błędów

  • Usuwanie enabledByDefault z wygenerowanego kodu XML w przypadku 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ązanie problemu 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

  • Dodanie obsługi interfejsu Parcelable (s) oprócz interfejsu PendingIntent (I8ab9f)
  • interfejsy API do konwersji z żądania i odpowiedzi platformy na żądanie i odpowiedź w formacie Ifdf20,

Zmiany w interfejsie API

  • Zgodność parametru z poradnikiem dotyczącym stylów. (I69b2d)
  • Dodanie interfejsów API do konwersji z formatu żądania i odpowiedzi platformy na formaty Ifdf20 i b/476047880
  • Zmień nazwę AppFunctionManagerCompat na AppFunctionManager. (Id9a78, b/448372122)
  • Usuń interfejsy API get/set dla 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 zasobów 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 wymaganego pola dopuszczającego wartość null podczas tworzenia AppFunctionData (I52195)
  • Rozwiązaliśmy problem, który powodował, że użycie List<PendingIntent> z AppFunction kończyło się niepowodzeniem w czasie kompilacji (Iebde7).
  • Rozwiązywanie problemu z nieprawidłowym wygenerowaniem metadanych ByteArray 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

  • Wymagaj podawania wymaganych pól 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ą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 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)
  • Zmień strukturę AppFunctionPrimitiveTypeMetadata na klasy konkretnych typów danych. (I1a3b2)
  • Dodaj pole opisu w AppFunctionResponseMetadata (I2332b)
  • Usunięcie wymagania dotyczącego 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 observeAppFunctions API. (I68c7e)
  • Dodaj pole opisu w AppFunctionMetadata (I060e2)
  • Dodaj AppFunctionTestRule (Id5ed0)
  • Dodaj isDescribedByKdoc w adnotacji @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 w wygenerowanym 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ą zwalniane. 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ą zwalniane. Wersja 1.0.0-alpha01 zawiera te zmiany.

Nowe funkcje

Biblioteka AppFunctions Jetpack jest oparta na interfejsach API platformy android.app.appfunctions. 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.