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 auf Version 12.5.0 oder höher. Verwenden Sie dazu eine der folgenden Optionen:

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

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

2. Achten Sie darauf, dass für das Firebase-Paket jetzt Version 12.5.0 oder höher angezeigt wird. 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 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: 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), 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) 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("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.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 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) (normalerweise <project>/<app-module>/build.gradle.kts oder <project>/<app-module>/build.gradle) die alten 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("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.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. 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, 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

Der Support für Unity war nicht über „Vertex AI in Firebase“ 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

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 struct-Typen 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 BlockThreshold-Aufzählung 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 ThrowingPartsRepresentable-Protokoll wurde entfernt und die Initialisierer für ModelContent wurden vereinfacht, um gelegentliche Compilerfehler zu vermeiden. Bilder, die nicht richtig codiert sind, führen weiterhin zu Fehlern, wenn sie in generateContent verwendet werden.

  • 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

  • HarmCategory wurde so geändert, dass es nicht mehr im Typ SafetySetting verschachtelt ist. Wenn Sie sich darauf als SafetySetting.HarmCategory beziehen, kann das 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 anderen Plattformen zu entsprechen.

• Konfiguration der Generierung

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

Kotlin

• Aufzählungen

  • Die Klassen enum und sealed 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 sorgt für eine bessere Interoperabilität mit Java.

• Zitat-Metadaten

  • Alle zuvor in CitationMetadata deklarierten Felder wurden in einer neuen Klasse namens Citation zusammengefasst. Zitationen finden Sie in der Liste mit dem Namen 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.

• Abrechnungsfähige Zeichen insgesamt

  • Das Attribut totalBillableCharacters in CountTokensResponse wurde geändert und ist jetzt optional, 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 sind 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 gibt jetzt ListenableFuture<LiveSessionFutures> anstelle von ListenableFuture<LiveSession> zurück.

Java

• Aufzählungen

  • Die Klassen enum und sealed 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 sorgt für eine bessere Interoperabilität mit Java.

• Zitat-Metadaten

  • Alle zuvor in CitationMetadata deklarierten Felder wurden in einer neuen Klasse namens Citation zusammengefasst. Zitationen finden Sie in der Liste mit dem Namen 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.

• Abrechnungsfähige Zeichen insgesamt

  • Das Attribut totalBillableCharacters in CountTokensResponse wurde geändert und ist jetzt optional, 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 sind 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 gibt jetzt ListenableFuture<LiveSessionFutures> anstelle von ListenableFuture<LiveSession> zurück.

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

Web

• Aufzählungen

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

• Grund für die Blockierung

  • blockReason in PromptFeedback wurde als optional gekennzeichnet.

Ä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.

• Inline-Daten

  • Die Verwendung von InlineDataPart.videoMetadata wurde entfernt.

Dart

• Aufzählungen

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

• Datenteil

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

• Anfrageoptionen

  • RequestOptions wurde entfernt, da timeout nicht funktionsfähig war. Die Funktion wird in naher Zukunft wieder hinzugefügt, aber zur Anpassung an andere Plattformen in den Typ GenerativeModel verschoben.

• Stoppsequenzen

  • Der Parameter stopSequences in GenerationConfig wurde in „optional“ geändert und ist standardmäßig auf null statt auf ein leeres Array festgelegt.

• Zitationen

  • 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 Properties

  • 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 aus der Funktion countTokens entfernt, die nicht mehr erforderlich sind. Nur contents ist erforderlich.

• Modell instanziieren

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

• Einbettungsfunktion

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

Einheit

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

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