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

Swift

1. Öffnen Sie Ihr App-Projekt in Xcode und aktualisieren Sie Ihr Firebase-Paket auf Version 11.13.0 oder höher. Verwenden Sie dazu eine der folgenden Optionen:

   • Option 1: Alle Pakete aktualisieren: Gehen Sie zu Datei > Pakete > Auf die neuesten Paketversionen aktualisieren.

   • 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 Paket aktualisieren aus.

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

3. Wähle im Projekt-Editor das Ziel deiner App aus und rufe dann den Bereich Frameworks, Libraries, and Embedded Content auf.

4. Fügen Sie die neue Bibliothek hinzu: Klicken Sie auf das Pluszeichen + und fügen Sie dann FirebaseAI 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:33.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 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:33.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 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 rufen Sie die aktuelle Version des Firebase JS SDK für Web über npm ab:

   npm i firebase@latest

   ODER

   yarn add firebase@latest

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

   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 Verwendung des firebase_ai-Pakets in Ihrer pubspec.yaml-Datei, indem Sie den folgenden Befehl in Ihrem Flutter-Projektverzeichnis ausführen:

   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 dem Vertex AI in Firebase nicht mehr verfügbar.

Informationen zu den ersten Schritten mit dem Firebase AI Logic SDK for 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.5-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.5-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.5-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.5-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.5-flash');

Einheit

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

Informationen zu den ersten Schritten mit dem Firebase AI Logic SDK for 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-Builder-Methoden geben jetzt korrekt die Instanz ihrer Klasse zurück, anstatt „void“.

Web

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

• Sicherheitseinstellungen

  • Die Verwendung des nicht unterstützten SafetySetting.method wurde entfernt.

• Inlinedaten

  • Die Verwendung des nicht unterstützten InlineDataPart.videoMetadata wurde entfernt.

Dart

Keine zusätzlichen Änderungen.

Einheit

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

Informationen zu den ersten Schritten mit dem Firebase AI Logic SDK for Unity