Przejście z wersji wstępnej pakietu SDK Vertex AI w Firebase na pakiety SDK Firebase Logic AI

Zadbaj o dobrą organizację dzięki kolekcji Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.

Swift

1. Po otwarciu projektu aplikacji w Xcode zaktualizuj pakiet Firebase do wersji 11.13.0 lub nowszej, korzystając z jednej z tych opcji:

   • Opcja 1: zaktualizuj wszystkie pakiety: kliknij Plik > Pakiety > Zaktualizuj do najnowszych wersji pakietów.

   • Opcja 2. Aktualizuj Firebase osobno: przejdź do pakietu Firebase w sekcji Zależności pakietu. Kliknij prawym przyciskiem myszy pakiet Firebase, a następnie wybierz Zaktualizuj pakiet.

2. Upewnij się, że pakiet Firebase ma teraz wersję 11.13.0 lub nowszą. Jeśli tak nie jest, sprawdź, czy określone wymagania dotyczące pakietu umożliwiają aktualizację do wersji 11.13.0 lub nowszej.

3. W Edytorze projektu wybierz ustawienia docelowe aplikacji, a potem przejdź do sekcji Frameworki, biblioteki i osadzone treści.

4. Dodaj nową bibliotekę: kliknij przycisk + i dodaj FirebaseAI z pakietu Firebase.

5. Po zakończeniu migracji aplikacji (patrz pozostałe sekcje tego przewodnika) usuń starą bibliotekę:
   wybierz FirebaseVertexAI-Preview, a potem naciśnij przycisk —.

Kotlin

1. W pliku Gradle modułu (na poziomie aplikacji) (zwykle <project>/<app-module>/build.gradle.kts lub <project>/<app-module>/build.gradle) zastąp stare zależności (w odpowiednich przypadkach) podanymi niżej.

   Pamiętaj, że przed usunięciem starej zależności może być łatwiej przenieść kod źródłowy aplikacji (patrz pozostałe sekcje tego przewodnika).

   // BEFORE
   dependencies {
     implementation("com.google.firebase:firebase-vertexai:16.0.0-betaXX")
   }
   
   
   // AFTER
   dependencies {
     // Import the BoM for the Firebase platform
     implementation(platform("com.google.firebase:firebase-bom:33.14.0"))
   
     // Add the dependency for the Firebase AI Logic library
     // When using the BoM, you don't specify versions in Firebase library dependencies
     implementation("com.google.firebase:firebase-ai")
   }

2. Zsynchronizuj projekt Androida z plikami Gradle.

Jeśli zdecydujesz się nie używać pakietu Firebase Android BoM, po prostu dodaj zależność do biblioteki firebase-ai i zaakceptuj najnowszą wersję sugerowaną przez Android Studio.

Java

1. W pliku Gradle modułu (na poziomie aplikacji) (zwykle <project>/<app-module>/build.gradle.kts lub <project>/<app-module>/build.gradle) zastąp stare zależności (w odpowiednich przypadkach) podanymi niżej.

   Pamiętaj, że przed usunięciem starej zależności może być łatwiej przenieść kod źródłowy aplikacji (patrz pozostałe sekcje tego przewodnika).

   // BEFORE
   dependencies {
     implementation("com.google.firebase:firebase-vertexai:16.0.0-betaXX")
   }
   
   
   // AFTER
   dependencies {
     // Import the BoM for the Firebase platform
     implementation(platform("com.google.firebase:firebase-bom:33.14.0"))
   
     // Add the dependency for the Firebase AI Logic library
     // When using the BoM, you don't specify versions in Firebase library dependencies
     implementation("com.google.firebase:firebase-ai")
   }

2. Zsynchronizuj projekt Androida z plikami Gradle.

Jeśli zdecydujesz się nie używać pakietu Firebase Android BoM, po prostu dodaj zależność do biblioteki firebase-ai i zaakceptuj najnowszą wersję sugerowaną przez Android Studio.

Web

1. Pobierz najnowszą wersję pakietu Firebase JS SDK na potrzeby internetu za pomocą npm:

   npm i firebase@latest

   LUB

   yarn add firebase@latest

2. W miejscach, w których biblioteka została zaimportowana, zaktualizuj instrukcje importowania, aby zamiast tego używać funkcji firebase/ai.

   Pamiętaj, że przed usunięciem starych importów może być łatwiej przenieść kod źródłowy aplikacji (patrz pozostałe sekcje tego przewodnika).

   // BEFORE
   import { initializeApp } from "firebase/app";
   import { getVertexAI, getGenerativeModel } from "firebase/vertexai-preview";
   
   
   // AFTER
   import { initializeApp } from "firebase/app";
   import { getAI, getGenerativeModel } from "firebase/ai";

Dart

1. Zaktualizuj plik pubspec.yaml, aby używać pakietu firebase_ai, uruchamiając to polecenie w katalogu projektu Flutter:

   flutter pub add firebase_ai

2. Zbuduj ponownie projekt Fluttera:

   flutter run

3. Po zakończeniu migracji aplikacji (patrz pozostałe sekcje tego przewodnika) usuń stary pakiet:

   flutter pub remove firebase_vertexai

Unity

Pomoc dotycząca Unity nie była dostępna w przypadku „Vertex AI in Firebase”.

Dowiedz się, jak rozpocząć korzystanie z pakietu SDK Firebase AI Logic dla Unity.

Swift

import FirebaseAI

// Initialize the Gemini Developer API backend service
let ai = FirebaseAI.firebaseAI(backend: .googleAI())

// Create a `GenerativeModel` instance with a model that supports your use case
let model = ai.generativeModel(modelName: "gemini-2.0-flash")

Kotlin

// Initialize the Gemini Developer API backend service
// Create a `GenerativeModel` instance with a model that supports your use case
val model = Firebase.ai(backend = GenerativeBackend.googleAI())
                        .generativeModel("gemini-2.0-flash")

Java

// Initialize the Gemini Developer API backend service
// Create a `GenerativeModel` instance with a model that supports your use case
GenerativeModel ai = FirebaseAI.getInstance(GenerativeBackend.googleAI())
        .generativeModel("gemini-2.0-flash");

// Use the GenerativeModelFutures Java compatibility layer which offers
// support for ListenableFuture and Publisher APIs
GenerativeModelFutures model = GenerativeModelFutures.from(ai);

Web

import { initializeApp } from "firebase/app";
import { getAI, getGenerativeModel, GoogleAIBackend } from "firebase/ai";

// TODO(developer) Replace the following with your app's Firebase configuration
// See: https://firebase.google.com/docs/web/learn-more#config-object
const firebaseConfig = {
  // ...
};

// Initialize FirebaseApp
const firebaseApp = initializeApp(firebaseConfig);

// Initialize the Gemini Developer API backend service
const ai = getAI(firebaseApp, { backend: new GoogleAIBackend() });

// Create a `GenerativeModel` instance with a model that supports your use case
const model = getGenerativeModel(ai, { model: "gemini-2.0-flash" });

Dart

import 'package:firebase_ai/firebase_ai.dart';
import 'package:firebase_core/firebase_core.dart';
import 'firebase_options.dart';

// Initialize FirebaseApp
await Firebase.initializeApp(
  options: DefaultFirebaseOptions.currentPlatform,
);

// Initialize the Gemini Developer API backend service
// Create a `GenerativeModel` instance with a model that supports your use case
final model =
      FirebaseAI.googleAI().generativeModel(model: 'gemini-2.0-flash');

Unity

Pomoc dotycząca Unity nie była dostępna w ramach „Vertex AI in Firebase”.

Dowiedz się, jak rozpocząć korzystanie z pakietu SDK Firebase AI Logic dla Unity.

Swift

• Wyliczenia

  • Zastąpiliśmy większość typów enum zmiennymi struct ze zmiennymi statycznymi. Ta zmiana daje nam większą elastyczność w rozwijaniu interfejsu API w sposób zapewniający zgodność wsteczną. Jeśli używasz instrukcji switch, musisz uwzględnić przypadek default:, aby uwzględnić nieznane lub nieobsługiwane wartości, w tym nowe wartości dodane do pakietu SDK w przyszłości.

  • Nazwa zbioru BlockThreshold została zmieniona na HarmBlockThreshold. Ten typ jest teraz typem struct.

  • Usunięto przypadki unknown i unspecified z tych zbiorów: HarmCategory, HarmBlockThreshold, HarmProbability, BlockReason i FinishReason.struct

  • Wymieniliśmy enumerację ModelContent.Part na protokół o nazwie Part, aby umożliwić dodawanie nowych typów w sposób zgodny z wstecz. Ta zmiana jest opisana bardziej szczegółowo w sekcji Elementy treści.

• Elementy treści

  • Usunięto protokół ThrowingPartsRepresentable i uproszczono inicjalizatory dla ModelContent, aby uniknąć sporadycznych błędów kompilatora. Obrazy, które nie są prawidłowo zakodowane, będą nadal generować błędy podczas używania w generateContent.

  • Zgodnie z protokołem Part zastąpiono przypadki ModelContent.Part tymi typami struct:

    • .text do TextPart
    • .data do InlineDataPart
    • .fileData do FileDataPart
    • .functionCall do FunctionCallPart
    • .functionResponse do FunctionResponsePart

• Kategoria szkody

  • Element HarmCategory nie jest już zagnieżdżony w elemencie typu SafetySetting. Jeśli używasz nazwy SafetySetting.HarmCategory, możesz ją zastąpić nazwą HarmCategory.

• Informacje dotyczące bezpieczeństwa

  • Usunięto typ SafetyFeedback, ponieważ nie był używany w żadnej z odpowiedzi.

• Metadane cytowania

  • Nazwa właściwości citationSources została zmieniona na citations w pliku CitationMetadata.

• Łączna liczba znaków podlegających rozliczeniu

  • Właściwość totalBillableCharacters w elementach CountTokensResponse została zmieniona na opcjonalną, aby uwzględnić sytuacje, w których nie są wysyłane żadne znaki.

• Odpowiedź kandydata

  • Zmieniliśmy nazwę CandidateResponse na Candidate, aby była zgodna z innymi platformami.

• Konfiguracja generowania

  • Zmieniono publiczne właściwości z GenerationConfig na internal. Wszystkie te parametry pozostają konfigurowalne w inicjalizowanym obiekcie.

Kotlin

• Wyliczenia

  • Zastąpiono zajęcia enum i sealed zwykłymi zajęciami. Ta zmiana daje większą elastyczność w rozwijaniu interfejsu API w sposób zapewniający zgodność wsteczną.

  • Nazwa zbioru BlockThreshold została zmieniona na HarmBlockThreshold.

  • Usunięto wartości z tych typów danych: HarmBlockThreshold, HarmProbability, HarmSeverity, BlockReason i FinishReason.

• Metody obiektów blob

  • W nazwach wszystkich metod, w których nazwie występuje znak Blob, zastąpiliśmy go znakiem InlineData.

• Ustawienia bezpieczeństwa

  • Zmieniono pole method tak, aby mogło być puste.

• Klasa czasu trwania

  • Usunięto wszystkie przypadki użycia klasy Duration w Kotlinie i zastąpiono ją klasą long. Ta zmiana zapewnia lepszą współpracę z językiem Java.

• Metadane cytowania

  • Wszystkie pola zadeklarowane wcześniej w CitationMetadata zostały zapakowane do nowej klasy o nazwie Citation. Odwołania można znaleźć na liście citations w sekcji CitationMetadata. Ta zmiana pozwala lepiej dopasowywać typy na różnych platformach.

• Liczba tokenów

  • Zmieniono pole totalBillableCharacters tak, aby mogło być puste.

• Łączna liczba znaków podlegających rozliczeniu

  • Właściwość totalBillableCharacters w elementach CountTokensResponse została zmieniona na opcjonalną, aby uwzględnić sytuacje, w których nie są wysyłane żadne znaki.

• Tworzenie wystąpienia modelu

  • Parametr requestOptions został przeniesiony na koniec listy parametrów, aby dostosować go do innych platform.

• Live API

  • Usunięto wartość UNSPECIFIED dla klasy wyliczeń ResponseModality. Zamiast tego użyj null.

  • Nazwa LiveGenerationConfig.setResponseModalities została zmieniona na LiveGenerationConfig.setResponseModality.

  • Usunięto klasę LiveContentResponse.Status, a zamiast niej osadzono pola stanu jako właściwości klasy LiveContentResponse.

  • Usunięto klasę LiveContentResponse, a zamiast niej udostępniono podklasy LiveServerMessage, które odpowiadają odpowiedziom z modelu.

  • Zmieniono LiveModelFutures.connect, aby zwracało wartość ListenableFuture<LiveSessionFutures> zamiast ListenableFuture<LiveSession>.

Java

• Wyliczenia

  • Zastąpiono zajęcia enum i sealed zwykłymi zajęciami. Ta zmiana daje większą elastyczność w rozwijaniu interfejsu API w sposób zapewniający zgodność wsteczną.

  • Nazwa zbioru BlockThreshold została zmieniona na HarmBlockThreshold.

  • Usunięto wartości z tych typów danych: HarmBlockThreshold, HarmProbability, HarmSeverity, BlockReason i FinishReason.

• Metody obiektów blob

  • W nazwach wszystkich metod, w których nazwie występuje znak Blob, zastąpiliśmy go znakiem InlineData.

• Ustawienia bezpieczeństwa

  • Zmieniono pole method tak, aby mogło być puste.

• Klasa czasu trwania

  • Usunięto wszystkie przypadki użycia klasy Duration w Kotlinie i zastąpiono ją klasą long. Ta zmiana zapewnia lepszą współpracę z językiem Java.

• Metadane cytowania

  • Wszystkie pola zadeklarowane wcześniej w CitationMetadata zostały zapakowane do nowej klasy o nazwie Citation. Odwołania można znaleźć na liście citations w sekcji CitationMetadata. Ta zmiana pozwala lepiej dopasowywać typy na różnych platformach.

• Liczba tokenów

  • Zmieniono pole totalBillableCharacters tak, aby mogło być puste.

• Łączna liczba znaków podlegających rozliczeniu

  • Właściwość totalBillableCharacters w elementach CountTokensResponse została zmieniona na opcjonalną, aby uwzględnić sytuacje, w których nie są wysyłane żadne znaki.

• Tworzenie wystąpienia modelu

  • Parametr requestOptions został przeniesiony na koniec listy parametrów, aby dostosować go do innych platform.

• Live API

  • Usunięto wartość UNSPECIFIED dla klasy wyliczeń ResponseModality. Zamiast tego użyj null.

  • Nazwa LiveGenerationConfig.setResponseModalities została zmieniona na LiveGenerationConfig.setResponseModality.

  • Usunięto klasę LiveContentResponse.Status, a zamiast niej osadzono pola stanu jako właściwości klasy LiveContentResponse.

  • Usunięto klasę LiveContentResponse, a zamiast niej udostępniono podklasy LiveServerMessage, które odpowiadają odpowiedziom z modelu.

  • Zmieniono LiveModelFutures.connect, aby zwracało wartość ListenableFuture<LiveSessionFutures> zamiast ListenableFuture<LiveSession>.

• Zmieniono różne metody kreatora Java, aby zwracały instancję klasy zamiast void.

Web

• Wyliczenia

  • Usunięto wartości z tych wyliczeń: HarmCategory, BlockThreshold, HarmProbability, HarmSeverity, BlockReason i FinishReason.

• Powód blokady

  • Zmieniono blockReason w PromptFeedback na opcjonalne.

Zmiany wymagane tylko wtedy, gdy zaczynasz używać wersji Gemini Developer API (zamiast wersji Vertex AI Gemini API):

• Ustawienia bezpieczeństwa

  • Usunięto użycie nieobsługiwanego znaku SafetySetting.method.

• Dane w wierszu

  • Usunięto użycie nieobsługiwanego znaku InlineDataPart.videoMetadata.

Dart

• Wyliczenia

  • Usunięto wartości z tych typów enumeracji: HarmCategory, HarmProbability, BlockReason i FinishReason.

• Część dotycząca danych

  • Zmieniliśmy nazwę funkcji DataPart na InlineDataPart, a funkcję static data na inlineData, aby dostosować je do innych platform.

• Opcje żądania

  • Usunięto RequestOptions, ponieważ timeout nie działa. W najbliższej przyszłości zostanie ona ponownie dodana, ale zostanie przeniesiona do typu GenerativeModel, aby była zgodna z innymi platformami.

• sekwencje zatrzymania,

  • Zmieniono parametr stopSequences w pliku GenerationConfig, tak aby był opcjonalny i domyślnie ustawiony na null zamiast pustej tablicy.

• Cytowania

  • Nazwa właściwości citationSources została zmieniona na citations w pliku CitationMetadata. Typ CitationSource został zmieniony na Citation, aby był zgodny z innymi platformami.

• Niepotrzebne publiczne typy, metody i właściwości

  • Usunięto te typy, metody i właściwości, które zostały niezamierzenie udostępnione: defaultTimeout, CountTokensResponseFields, parseCountTokensResponse, parseEmbedContentResponse, parseGenerateContentResponse, parseContent, BatchEmbedContentsResponse, ContentEmbedding, EmbedContentRequest i EmbedContentResponse.

• Liczba tokenów

  • Usunięto z funkcji countTokens dodatkowe pola, które nie są już potrzebne. Wystarczy podać tylko contents.

• Tworzenie wystąpienia modelu

  • Parametr systemInstruction został przeniesiony na koniec listy parametrów, aby dostosować go do innych platform.

• Funkcja umieszczania

  • Usunięto z modelu nieobsługiwaną funkcję umieszczania (embedContent i batchEmbedContents).

Unity

Pomoc dotycząca Unity nie była dostępna w przypadku „Vertex AI in Firebase”.

Dowiedz się, jak rozpocząć korzystanie z pakietu SDK Firebase AI Logic dla Unity.