Von der Vorschauversion des Vertex AI in Firebase SDK zu den Firebase AI Logic SDKs migrieren

Swift

1. Öffnen Sie Ihr App-Projekt in Xcode und aktualisieren Sie Ihr Firebase-Paket mit einer der folgenden Optionen auf Version 12.5.0 oder höher:

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

   • Option 2: Firebase einzeln aktualisieren: Gehen Sie im Abschnitt Package Dependencies zum Firebase-Paket. Rechtsklicken Sie auf das Firebase-Paket und wählen Sie Update Package (Paket aktualisieren) aus.

2. Achten Sie darauf, dass für das Firebase-Paket jetzt Version 12.5.0 oder höher angezeigt wird. Wenn dies nicht der Fall ist, prüfen Sie, ob die angegebenen Paketanforderungen eine Aktualisierung auf Version 12.5.0 oder höher zulassen.

3. Wählen Sie im Projekteditor das Ziel Ihrer App aus und rufen Sie dann den Bereich Frameworks, Libraries, and Embedded Content auf.

4. Fügen Sie die neue Bibliothek hinzu: Wählen Sie den Button + aus 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), entfernen Sie die alte Bibliothek:
   Wählen Sie FirebaseVertexAI-Preview aus und drücken Sie dann die Taste —.

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) die alten Abhängigkeiten (falls zutreffend) durch die folgenden.

   Möglicherweise ist es einfacher, die Codebasis Ihrer App zu migrieren (siehe die verbleibenden Abschnitte in diesem Leitfaden), bevor Sie die alte Abhängigkeit löschen.

   // BEFORE
   dependencies {
     implementation("com.google.firebase:firebase-vertexai:16.0.0-betaXX")
   }
   
   
   // AFTER
   dependencies {
     // Import the BoM for the Firebase platform
     implementation(platform("com.google.firebase:firebase-bom:35.1.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 die 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 aktuelle 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) die alten Abhängigkeiten (falls zutreffend) durch die folgenden.

   Möglicherweise ist es einfacher, die Codebasis Ihrer App zu migrieren (siehe die verbleibenden Abschnitte in diesem Leitfaden), bevor Sie die alte Abhängigkeit löschen.

   // BEFORE
   dependencies {
     implementation("com.google.firebase:firebase-vertexai:16.0.0-betaXX")
   }
   
   
   // AFTER
   dependencies {
     // Import the BoM for the Firebase platform
     implementation(platform("com.google.firebase:firebase-bom:35.1.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 die 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 aktuelle Version, die von Android Studio vorgeschlagen wird.

Web

1. Rufen Sie die aktuelle 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 dort, wo Sie die Bibliothek importiert haben, Ihre Importanweisungen, um stattdessen firebase/ai zu verwenden.

   Es ist möglicherweise einfacher, die Codebasis 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-preview";
   
   
   // AFTER
   import { initializeApp } from "firebase/app";
   import { getAI, getGenerativeModel } from "firebase/ai";

Dart

1. Aktualisieren Sie die Datei pubspec.yaml, um das Paket firebase_ai zu verwenden. 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 verbleibenden Abschnitte in diesem Leitfaden), müssen Sie das alte Paket löschen:

   flutter pub remove firebase_vertexai

Einheit

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

Erste Schritte 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.8-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.8-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.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, 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.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 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.8-flash');

Einheit

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

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

Swift

• Aufzählungen

  • Die meisten enum-Typen wurden durch structs mit statischen Variablen ersetzt. Diese Änderung ermöglicht mehr Flexibilität bei der Weiterentwicklung der API auf abwärtskompatible Weise. Wenn Sie switch-Anweisungen verwenden, müssen Sie jetzt einen default:-Fall einfügen, um unbekannte oder nicht verarbeitete Werte abzudecken, einschließlich neuer Werte, die dem SDK in Zukunft hinzugefügt werden.

  • Die Aufzählung BlockThreshold wurde in HarmBlockThreshold umbenannt. Dieser Typ ist jetzt ein struct.

  • Die Fälle unknown und unspecified wurden aus den folgenden Aufzählungen entfernt (jetzt structs): HarmCategory, HarmBlockThreshold, HarmProbability, BlockReason und FinishReason.

  • Die Aufzählung ModelContent.Part wurde durch ein Protokoll namens Part ersetzt, damit neue Typen abwärtskompatibel hinzugefügt werden können. Diese Änderung wird im Abschnitt Inhaltsteile ausführlicher beschrieben.

• Inhaltsteile

  • Das Protokoll ThrowingPartsRepresentable wurde entfernt und die Initialisierer für ModelContent wurden vereinfacht, um gelegentliche Compilerfehler zu vermeiden. Bilder, die nicht richtig codiert sind, führen bei der Verwendung in generateContent weiterhin zu Fehlern.

  • Die ModelContent.Part-Fälle wurden durch die folgenden struct-Typen ersetzt, die dem Part-Protokoll entsprechen:

    • .text bis TextPart
    • .data nach InlineDataPart
    • .fileData nach FileDataPart
    • .functionCall nach FunctionCallPart
    • .functionResponse bis FunctionResponsePart

• Schadenskategorie

  • Der HarmCategory wurde so geändert, dass er nicht mehr im Typ SafetySetting verschachtelt ist. Wenn Sie es als SafetySetting.HarmCategory bezeichnen, kann es durch HarmCategory ersetzt werden.

• Feedback zur Sicherheit

  • Der Typ SafetyFeedback wurde entfernt, da er in keiner der Antworten verwendet wurde.

• Zitat-Metadaten

  • Das Attribut citationSources wurde in CitationMetadata in citations umbenannt.

• Abrechenbare Zeichen insgesamt

  • Das Attribut totalBillableCharacters in CountTokensResponse wurde in „optional“ geändert, um Situationen zu berücksichtigen, in denen keine Zeichen gesendet werden.

• Antwort des Kandidaten

  • CandidateResponse wurde in Candidate umbenannt, um die Bezeichnung an andere Plattformen anzupassen.

• Generierungskonfiguration

  • Die öffentlichen Attribute von GenerationConfig wurden in internal geändert. Sie können alle im Initialisierer konfiguriert werden.

Kotlin

• Aufzählungen

  • enum- und sealed-Klassen wurden durch reguläre Klassen ersetzt. Diese Änderung ermöglicht mehr Flexibilität bei der Weiterentwicklung der API auf abwärtskompatible Weise.

  • Die Aufzählung BlockThreshold wurde in HarmBlockThreshold umbenannt.

  • Werte aus den folgenden Aufzählungen entfernt: HarmBlockThreshold, HarmProbability, HarmSeverity, BlockReason und FinishReason.

• Blob-Methoden

  • Alle Methoden, die Blob als Teil ihres Namens enthielten, wurden umbenannt, sodass stattdessen InlineData verwendet wird.

• Sicherheits­einstellungen

  • Das Feld method wurde so geändert, dass Nullwerte zulässig sind.

• Dauerklasse

  • Alle Verwendungen der Kotlin-Klasse Duration wurden entfernt und durch long ersetzt. Diese Änderung ermöglicht eine bessere Interoperabilität mit Java.

• Zitat-Metadaten

  • Alle zuvor in CitationMetadata deklarierten Felder wurden in einer neuen Klasse namens Citation zusammengefasst. Zitate finden Sie in der Liste citations in CitationMetadata. Diese Änderung ermöglicht eine bessere Abstimmung der Typen auf allen Plattformen.

• Tokens zählen

  • Das Feld totalBillableCharacters wurde so geändert, dass Nullwerte zulässig sind.

• Abrechenbare Zeichen insgesamt

  • Das Attribut totalBillableCharacters in CountTokensResponse wurde in „optional“ geändert, um Situationen zu berücksichtigen, in denen keine Zeichen gesendet werden.

• Modell instanziieren

  • Der Parameter requestOptions wurde an das Ende der Parameterliste verschoben, um ihn an andere Plattformen anzupassen.

• Live API

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

  • LiveGenerationConfig.setResponseModalities wurde in LiveGenerationConfig.setResponseModality umbenannt.

  • Die Klasse LiveContentResponse.Status wurde entfernt. Stattdessen wurden die Statusfelder als Attribute von LiveContentResponse verschachtelt.

  • Die Klasse LiveContentResponse wurde entfernt. Stattdessen wurden Unterklassen von LiveServerMessage bereitgestellt, die den Antworten des Modells entsprechen.

  • LiveModelFutures.connect wurde so geändert, dass ListenableFuture<LiveSessionFutures> anstelle von ListenableFuture<LiveSession> zurückgegeben wird.

Java

• Aufzählungen

  • enum- und sealed-Klassen wurden durch reguläre Klassen ersetzt. Diese Änderung ermöglicht mehr Flexibilität bei der Weiterentwicklung der API auf abwärtskompatible Weise.

  • Die Aufzählung BlockThreshold wurde in HarmBlockThreshold umbenannt.

  • Werte aus den folgenden Aufzählungen entfernt: HarmBlockThreshold, HarmProbability, HarmSeverity, BlockReason und FinishReason.

• Blob-Methoden

  • Alle Methoden, die Blob als Teil ihres Namens enthielten, wurden umbenannt, sodass stattdessen InlineData verwendet wird.

• Sicherheits­einstellungen

  • Das Feld method wurde so geändert, dass Nullwerte zulässig sind.

• Dauerklasse

  • Alle Verwendungen der Kotlin-Klasse Duration wurden entfernt und durch long ersetzt. Diese Änderung ermöglicht eine bessere Interoperabilität mit Java.

• Zitat-Metadaten

  • Alle zuvor in CitationMetadata deklarierten Felder wurden in einer neuen Klasse namens Citation zusammengefasst. Zitate finden Sie in der Liste citations in CitationMetadata. Diese Änderung ermöglicht eine bessere Abstimmung der Typen auf allen Plattformen.

• Tokens zählen

  • Das Feld totalBillableCharacters wurde so geändert, dass Nullwerte zulässig sind.

• Abrechenbare Zeichen insgesamt

  • Das Attribut totalBillableCharacters in CountTokensResponse wurde in „optional“ geändert, um Situationen zu berücksichtigen, in denen keine Zeichen gesendet werden.

• Modell instanziieren

  • Der Parameter requestOptions wurde an das Ende der Parameterliste verschoben, um ihn an andere Plattformen anzupassen.

• Live API

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

  • LiveGenerationConfig.setResponseModalities wurde in LiveGenerationConfig.setResponseModality umbenannt.

  • Die Klasse LiveContentResponse.Status wurde entfernt. Stattdessen wurden die Statusfelder als Attribute von LiveContentResponse verschachtelt.

  • Die Klasse LiveContentResponse wurde entfernt. Stattdessen wurden Unterklassen von LiveServerMessage bereitgestellt, die den Antworten des Modells entsprechen.

  • LiveModelFutures.connect wurde so geändert, dass ListenableFuture<LiveSessionFutures> anstelle von ListenableFuture<LiveSession> zurückgegeben wird.

• Verschiedene Java-Builder-Methoden wurden geändert, sodass sie jetzt die Instanz ihrer Klasse anstelle von void zurückgeben.

Web

• Aufzählungen

  • Werte aus den folgenden Aufzählungen entfernt: HarmCategory, BlockThreshold, HarmProbability, HarmSeverity, BlockReason und FinishReason.

• Grund für die Blockierung

  • blockReason in PromptFeedback wurde in „optional“ geändert.

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

• Sicherheits­einstellungen

  • Nicht unterstützte Verwendungen von SafetySetting.method wurden entfernt.

• Inline-Daten

  • Nicht unterstützte Verwendungen von InlineDataPart.videoMetadata wurden entfernt.

Dart

• Aufzählungen

  • Werte aus den folgenden Aufzählungen entfernt: HarmCategory, HarmProbability, BlockReason und FinishReason.

• Datenteil

  • DataPart wurde in InlineDataPart und die data-Funktion static in inlineData umbenannt, um sie an andere Plattformen anzupassen.

• Anfrageoptionen

  • RequestOptions wurde entfernt, da timeout nicht funktionsfähig war. Sie wird in naher Zukunft wieder hinzugefügt, aber in den Typ GenerativeModel verschoben, um sie an andere Plattformen anzupassen.

• Stoppsequenzen

  • Der Parameter stopSequences in GenerationConfig wurde so geändert, dass er optional ist und standardmäßig auf null statt auf ein leeres Array gesetzt wird.

• Zitate

  • Das Attribut citationSources wurde in CitationMetadata in citations umbenannt. Der Typ CitationSource wurde in Citation umbenannt, um ihn an andere Plattformen anzupassen.

• Unnötige öffentliche Typen, Methoden und Attribute

  • Die folgenden Typen, Methoden und Eigenschaften, die unbeabsichtigt verfügbar gemacht wurden, wurden entfernt: defaultTimeout, CountTokensResponseFields, parseCountTokensResponse, parseEmbedContentResponse, parseGenerateContentResponse, parseContent, BatchEmbedContentsResponse, ContentEmbedding, EmbedContentRequest und EmbedContentResponse.

• Tokens zählen

  • Zusätzliche Felder, die nicht mehr erforderlich sind, wurden aus der Funktion countTokens entfernt. Es ist nur contents erforderlich.

• Modell instanziieren

  • Der Parameter systemInstruction wurde an das Ende der Parameterliste verschoben, um ihn an andere Plattformen anzupassen.

• Einbettungsfunktion

  • Nicht unterstützte Einbettungsfunktionen (embedContent und batchEmbedContents) wurden aus dem Modell entfernt.

Einheit

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

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