Von der GA-Version der Vertex AI in Firebase SDKs zu den Firebase AI Logic SDKs migrieren

Swift

1. Aktualisieren Sie in Xcode, wenn Ihr App-Projekt geöffnet ist, Ihr Firebase-Paket auf Version 11.13.0 oder höher. Verwenden Sie dazu eine der folgenden Optionen:

   • Option 1: Alle Pakete aktualisieren: Rufen Sie File > Packages > Update to Latest Package Versions auf.

   • Option 2: Firebase einzeln aktualisieren: Rufen Sie das Firebase Paket im Abschnitt Package Dependencies (Paketabhängigkeiten) auf. Klicken Sie mit der rechten Maustaste auf das Firebase-Paket und wählen Sie dann Update Package (Paket aktualisieren) aus.

2. Prüfen Sie, ob für das Firebase-Paket jetzt Version 11.13.0 oder höher angezeigt wird. Wenn nicht, prüfen Sie, ob die angegebenen Paketvoraussetzungen die Aktualisierung auf Version 11.13.0 oder höher zulassen.

3. Wählen Sie im Projekt-Editor das Ziel Ihrer App aus und rufen Sie dann den Abschnitt Frameworks, Libraries, and Embedded Content (Frameworks, Bibliotheken und eingebetteter Inhalt) auf.

4. Fügen Sie die neue Bibliothek hinzu: Wählen Sie die Schaltfläche + aus und fügen Sie dann FirebaseAI aus dem Firebase-Paket hinzu.

5. Nachdem Sie die Migration Ihrer App abgeschlossen haben (siehe die restlichen Abschnitte in dieser Anleitung), entfernen Sie die alte Bibliothek:
   Wählen Sie FirebaseVertexAI aus, und drücken Sie dann die Schaltfläche –.

Kotlin

1. Ersetzen Sie in der Gradle-Datei des Moduls (auf Anwendungsebene) (in der Regel <project>/<app-module>/build.gradle.kts oder <project>/<app-module>/build.gradle) die alten Abhängigkeiten (falls zutreffend) durch Folgendes:

   Beachten Sie, dass es einfacher sein könnte, die Codebasis Ihrer App zu migrieren (siehe die restlichen Abschnitte in dieser Anleitung), bevor Sie die alte Abhängigkeit löschen.

   // 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.13.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. Synchronisieren Sie Ihr Android-Projekt mit Gradle-Dateien.

Beachten Sie, dass Sie, wenn Sie das Firebase Android BoM nicht verwenden möchten, einfach die Abhängigkeit für die firebase-ai Bibliothek hinzufügen und die neueste Version akzeptieren, die von Android Studio vorgeschlagen wird.

Java

1. Ersetzen Sie in der Gradle-Datei des Moduls (auf Anwendungsebene) (in der Regel <project>/<app-module>/build.gradle.kts oder <project>/<app-module>/build.gradle) die alten Abhängigkeiten (falls zutreffend) durch Folgendes:

   Beachten Sie, dass es einfacher sein könnte, die Codebasis Ihrer App zu migrieren (siehe die restlichen Abschnitte in dieser Anleitung), bevor Sie die alte Abhängigkeit löschen.

   // 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.13.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. Synchronisieren Sie Ihr Android-Projekt mit Gradle-Dateien.

Beachten Sie, dass Sie, wenn Sie das Firebase Android BoM nicht verwenden möchten, einfach die Abhängigkeit für die firebase-ai Bibliothek hinzufügen und die neueste Version akzeptieren, die von Android Studio vorgeschlagen wird.

Web

1. Rufen Sie die neueste Version des Firebase JS SDK for Web mit npm ab:

   npm i firebase@latest

   ODER

   yarn add firebase@latest

2. Aktualisieren Sie überall, wo Sie die Bibliothek importiert haben, die Importanweisungen, um stattdessen firebase/ai zu verwenden.

   Beachten Sie, dass es einfacher sein könnte, die Codebasis Ihrer App zu migrieren (siehe die restlichen Abschnitte in dieser Anleitung), bevor Sie die alten Importe löschen.

   // 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. Aktualisieren Sie das firebase_ai-Paket in Ihrer pubspec.yaml-Datei. Führen Sie dazu den folgenden Befehl im Flutter-Projektverzeichnis aus:

   flutter pub add firebase_ai

2. Erstellen Sie Ihr Flutter-Projekt neu:

   flutter run

3. Nachdem Sie die Migration Ihrer App abgeschlossen haben (siehe die restlichen Abschnitte in dieser Anleitung), löschen Sie das alte Paket:

   flutter pub remove firebase_vertexai

Einheit

Die Unterstützung für Unity war in „Vertex AI in Firebase“ nicht verfügbar.

Informationen zu den ersten Schritten mit dem Firebase AI Logic SDK für Unity.

Swift

import FirebaseAILogic

// Initialize the Vertex AI Gemini API backend service
let ai = FirebaseAI.firebaseAI(backend: .vertexAI())

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

Kotlin

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

Java

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

// 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, VertexAIBackend } 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 Vertex AI Gemini API backend service
const ai = getAI(firebaseApp, { backend: new VertexAIBackend() });

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

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 Vertex AI Gemini API backend service
// Create a `GenerativeModel` instance with a model that supports your use case
final model =
      FirebaseAI.vertexAI().generativeModel(model: 'gemini-3-flash-preview');

Einheit

Die Unterstützung für Unity war in „Vertex AI in Firebase“ nicht verfügbar.

Informationen zu den ersten Schritten mit dem Firebase AI Logic SDK für Unity.

Swift

Keine zusätzlichen Änderungen.

Kotlin

• Live API

  • Der Wert UNSPECIFIED für die Enum-Klasse ResponseModality wurde entfernt. Verwenden Sie stattdessen null.

Java

• Live API

  • Der Wert UNSPECIFIED für die Enum-Klasse ResponseModality wurde entfernt. Verwenden Sie stattdessen null.

• Verschiedene Java-Builder-Methoden geben jetzt korrekt die Instanz ihrer Klasse zurück, anstatt „void“.

Web

Änderungen sind nur erforderlich, wenn Sie die Gemini Developer API (anstelle der Vertex AI Gemini API):

• Sicherheitseinstellungen

  • Verwendungen von SafetySetting.method wurden entfernt, da diese Methode nicht unterstützt wird.

• Inlinedaten

  • Verwendungen von InlineDataPart.videoMetadata wurden entfernt, da diese Methode nicht unterstützt wird.

Dart

Keine zusätzlichen Änderungen.

Einheit

Die Unterstützung für Unity war in „Vertex AI in Firebase“ nicht verfügbar.

Informationen zu den ersten Schritten mit dem Firebase AI Logic SDK für Unity.