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 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 den Abschnitt Frameworks, Libraries, and Embedded Content (Frameworks, Bibliotheken und eingebettete Inhalte) 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:

   Es ist möglicherweise einfacher, den Code 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.16.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.

Wenn Sie das Firebase Android BoM nicht verwenden möchten, fügen Sie einfach die Abhängigkeit für die firebase-ai Bibliothek hinzu und akzeptieren Sie die neueste Version 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:

   Es ist möglicherweise einfacher, den Code 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.16.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.

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

Web

1. Rufen Sie die neueste Version des Firebase JS SDK für das 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.

   Es ist möglicherweise einfacher, den Code 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

Unity

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 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-3.6-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-3.6-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-3.6-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-3.6-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-3.6-flash');

Unity

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 (anstatt der Agent Platform Gemini API (formerly Vertex AI)):

• Sicherheitseinstellungen

  • Verwendungen der nicht unterstützten SafetySetting.method wurden entfernt.

• Inlinedaten

  • Verwendungen der nicht unterstützten InlineDataPart.videoMetadata wurden entfernt.

Dart

Keine zusätzlichen Änderungen.

Unity

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.