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

Swift

1. Aktualisieren Sie in Xcode Ihr Firebase-Paket auf Version 12.5.0 oder höher. Gehen Sie dazu so vor:

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

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

2. Prüfen Sie, ob das Firebase-Paket jetzt Version 12.5.0 oder höher anzeigt. Wenn nicht, prüfen Sie, ob die von Ihnen angegebenen Paketanforderungen ein Update auf Version 12.5.0 oder höher zulassen.

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

4. Fügen Sie die neue Bibliothek hinzu: Klicken Sie auf das Pluszeichen + und fügen Sie dann FirebaseAILogic aus dem Firebase-Paket hinzu.

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

Kotlin

1. Ersetzen Sie in der Gradle-Datei Ihres Moduls (auf App-Ebene) (in der Regel <project>/<app-module>/build.gradle.kts oder <project>/<app-module>/build.gradle) alte Abhängigkeiten (falls zutreffend) durch die folgenden.

   Es kann einfacher sein, den Code Ihrer App zu migrieren (siehe die verbleibenden Abschnitte in diesem Leitfaden), 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:35.0.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 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 Ihres Moduls (auf App-Ebene) (in der Regel <project>/<app-module>/build.gradle.kts oder <project>/<app-module>/build.gradle) alte Abhängigkeiten (falls zutreffend) durch die folgenden.

   Es kann einfacher sein, den Code Ihrer App zu migrieren (siehe die verbleibenden Abschnitte in diesem Leitfaden), 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:35.0.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 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. So erhalten Sie die aktuelle Version des Firebase JS SDK für Web über npm:

   npm i firebase@latest

   ODER

   yarn add firebase@latest

2. Aktualisieren Sie überall, wo Sie die Bibliothek importiert haben, die Importanweisungen, sodass stattdessen firebase/ai verwendet wird.

   Es kann einfacher sein, den Code Ihrer App zu migrieren (siehe die verbleibenden Abschnitte in diesem Leitfaden), 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 die Datei pubspec.yaml, damit das Paket firebase_ai verwendet wird. Führen Sie dazu den folgenden Befehl in Ihrem 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 verbleibenden Abschnitte in diesem Leitfaden), müssen Sie das alte Paket löschen:

   flutter pub remove firebase_vertexai

Einheit

Support für Unity war ab „Vertex AI in Firebase“ nicht verfügbar.

Erste Schritte mit dem Firebase AI Logic SDK für 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.8-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.8-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.8-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.8-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.8-flash');

Einheit

Support für Unity war ab „Vertex AI in Firebase“ nicht verfügbar.

Erste Schritte mit dem Firebase AI Logic SDK für Unity

Swift

Keine zusätzlichen Änderungen.

Kotlin

• Live API

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

Java

• Live API

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

• Verschiedene Java-Buildermethoden wurden geändert, sodass sie jetzt korrekt die Instanz ihrer Klasse anstelle von „void“ zurückgeben.

Web

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

• Sicherheits­einstellungen

  • Die Verwendung von SafetySetting.method wurde entfernt.

• Inlinedaten

  • Die Verwendung von InlineDataPart.videoMetadata wurde entfernt.

Dart

Keine zusätzlichen Änderungen.

Einheit

Support für Unity war ab „Vertex AI in Firebase“ nicht verfügbar.

Erste Schritte mit dem Firebase AI Logic SDK für Unity