Przejście z wersji pakietów SDK Vertex AI w Firebase w GA na pakiety SDK Firebase AI Logic

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 kolejno File > Packages > Update to Latest Package Versions (Plik > Pakiety > Zaktualizuj do najnowszych wersji pakietów).

   • Opcja 2. Zaktualizuj Firebase osobno: otwórz pakiet Firebase w sekcji Package Dependencies (Zależności pakietów). Kliknij prawym przyciskiem myszy pakiet Firebase, a następnie kliknij Update Package (Zaktualizuj pakiet).

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

3. Wybierz docelową aplikację w edytorze projektu, a następnie otwórz sekcję Frameworks, Libraries, and Embedded Content (Frameworki, biblioteki i treści osadzone).

4. Dodaj nową bibliotekę: kliknij przycisk +, a następnie dodaj FirebaseAI z pakietu Firebase.

5. Po zakończeniu migracji aplikacji (patrz pozostałe sekcje w tym przewodniku) usuń starą bibliotekę:
   kliknij FirebaseVertexAI, a następnie 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 stosownych przypadkach) tymi:

   Pamiętaj, że przed usunięciem starej zależności łatwiej może być przeprowadzić migrację kodu aplikacji (patrz pozostałe sekcje tego przewodnika).

   // BEFORE
   dependencies {
     implementation(platform("com.google.firebase:firebase-bom:33.x.y"))
     implementation("com.google.firebase:firebase-vertexai")
     // OR if not using the BoM
     implementation("com.google.firebase:firebase-vertexai:16.x.y")
   }
   
   
   // AFTER
   dependencies {
     // Import the BoM for the Firebase platform
     implementation(platform("com.google.firebase:firebase-bom:34.18.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 aplikacji na Androida z plikami Gradle.

Jeśli nie chcesz używać Firebase Android BoM, dodaj zależność z biblioteką 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 stosownych przypadkach) tymi:

   Pamiętaj, że przed usunięciem starej zależności łatwiej może być przeprowadzić migrację kodu aplikacji (patrz pozostałe sekcje tego przewodnika).

   // BEFORE
   dependencies {
     implementation(platform("com.google.firebase:firebase-bom:33.x.y"))
     implementation("com.google.firebase:firebase-vertexai")
     // OR if not using the BoM
     implementation("com.google.firebase:firebase-vertexai:16.x.y")
   }
   
   
   // AFTER
   dependencies {
     // Import the BoM for the Firebase platform
     implementation(platform("com.google.firebase:firebase-bom:34.18.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 aplikacji na Androida z plikami Gradle.

Jeśli nie chcesz używać Firebase Android BoM, dodaj zależność z biblioteką firebase-ai i zaakceptuj najnowszą wersję sugerowaną przez Android Studio.

Web

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

   npm i firebase@latest

   LUB

   yarn add firebase@latest

2. Wszędzie tam, gdzie zaimportowano bibliotekę, zaktualizuj instrukcje importu, aby używać firebase/ai.

   Pamiętaj, że przed usunięciem starych importów łatwiej może być przeprowadzić migrację kodu aplikacji (patrz pozostałe sekcje tego przewodnika).

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

Dart

1. Zaktualizuj pakiet firebase_ai w pliku pubspec.yaml, uruchamiając to polecenie w katalogu projektu Flutter:

   flutter pub add firebase_ai

2. Przebuduj projekt Flutter:

   flutter run

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

   flutter pub remove firebase_vertexai

Unity

Usługa „Vertex AI in Firebase” nie obsługiwała Unity .

Dowiedz się, jak zacząć korzystać z Firebase AI Logic pakietu SDK na Unity.

Swift

import FirebaseAILogic

// Initialize the Agent Platform Gemini API backend service (fomerly Vertex AI).
let ai = FirebaseAI.firebaseAI(backend: .agentPlatform())

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

Kotlin

// Initialize the Agent Platform Gemini API backend service (formerly Vertex AI).
// Create a `GenerativeModel` instance with a model that supports your use case.
val model = Firebase.ai(backend = GenerativeBackend.agentPlatform())
                        .generativeModel("gemini-3.7-flash")

Java

// Initialize the Agent Platform Gemini API backend service (formerly Vertex AI).
// Create a `GenerativeModel` instance with a model that supports your use case.
GenerativeModel ai = FirebaseAI.getInstance(GenerativeBackend.agentPlatform())
        .generativeModel("gemini-3.7-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, AgentPlatformBackend } 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 Agent Platform Gemini API backend service (formerly Vertex AI).
const ai = getAI(firebaseApp, { backend: new AgentPlatformBackend() });

// Create a `GenerativeModel` instance with a model that supports your use case.
const model = getGenerativeModel(ai, { model: "gemini-3.7-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 Agent Platform Gemini API backend service (formerly Vertex AI).
// Create a `GenerativeModel` instance with a model that supports your use case.
final model =
      FirebaseAI.agentPlatform().generativeModel(model: 'gemini-3.7-flash');

Unity

Usługa „Vertex AI in Firebase” nie obsługiwała Unity.

Dowiedz się, jak zacząć korzystać z Firebase AI Logic pakietu SDK na Unity.

Swift

Nie ma dodatkowych zmian.

Kotlin

• Live API

  • Usunięto wartość UNSPECIFIED w przypadku klasy wyliczeniowej ResponseModality. Zamiast niej użyj null.

Java

• Live API

  • Usunięto wartość UNSPECIFIED w przypadku klasy wyliczeniowej ResponseModality. Zamiast niej użyj null.

• Zmieniono różne metody tworzenia w języku Java, aby teraz prawidłowo zwracały instancję swojej klasy zamiast wartości void.

Web

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

• Ustawienia bezpieczeństwa

  • Usunięto użycie nieobsługiwanej metody SafetySetting.method.

• Dane w treści

  • Usunięto użycie nieobsługiwanej metody InlineDataPart.videoMetadata.

Dart

Nie ma dodatkowych zmian.

Unity

Usługa „Vertex AI in Firebase” nie obsługiwała Unity.

Dowiedz się, jak zacząć korzystać z Firebase AI Logic pakietu SDK na Unity.