从 Vertex AI in Firebase SDK 的正式版迁移到 Firebase AI Logic SDK

Swift

1. 在 Xcode 中打开您的应用项目，然后使用以下任一选项将 Firebase 软件包更新到 v12.5.0 或更高版本：

   • 方法 1：更新所有软件包：依次前往 File > Packages > Update to Latest Package Versions（文件 > 软件包 > 更新到最新软件包版本）。

   • 方法 2：单独更新 Firebase：前往名为 Package Dependencies 的部分中的 Firebase 软件包。右键点击 Firebase 软件包，然后选择更新软件包。

2. 确保 Firebase 软件包现在显示 v12.5.0 或更高版本。如果没有，请验证您指定的软件包要求是否允许更新到 v12.5.0 或更高版本。

3. 在 Project Editor 中选择应用的目标，然后前往 Frameworks, Libraries, and Embedded Content（框架、库和嵌入式内容）部分。

4. 添加新库：选择 + 按钮，然后从 Firebase 软件包中添加 FirebaseAILogic。

5. 完成应用迁移后（请参阅本指南中的其余部分），请务必移除旧库：
   选择 FirebaseVertexAI，然后按 — 按钮。

Kotlin

1. 在模块（应用级）Gradle 文件（通常是 <project>/<app-module>/build.gradle.kts 或 <project>/<app-module>/build.gradle）中，将旧依赖项（如适用）替换为以下内容。

   请注意，在删除旧依赖项之前，迁移应用的代码库（请参阅本指南中的其余部分）可能会更容易。

   // 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.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. 将您的 Android 项目与 Gradle 文件同步。

请注意，如果您选择不使用 Firebase Android BoM，只需添加 firebase-ai 库的依赖项，并接受 Android Studio 建议的最新版本。

Java

1. 在模块（应用级）Gradle 文件（通常是 <project>/<app-module>/build.gradle.kts 或 <project>/<app-module>/build.gradle）中，将旧依赖项（如适用）替换为以下内容。

   请注意，在删除旧依赖项之前，迁移应用的代码库（请参阅本指南中的其余部分）可能会更容易。

   // 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.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. 将您的 Android 项目与 Gradle 文件同步。

请注意，如果您选择不使用 Firebase Android BoM，只需添加 firebase-ai 库的依赖项，并接受 Android Studio 建议的最新版本。

Web

1. 使用 npm 获取最新版本 Firebase JS SDK for Web：

   npm i firebase@latest

   或

   yarn add firebase@latest

2. 在您导入该库的所有位置，将 import 语句更新为改用 firebase/ai。

   请注意，在删除旧导入之前，迁移应用的代码库（请参阅本指南中的其余部分）可能会更容易。

   // 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. 在 Flutter 项目目录中运行以下命令，更新 pubspec.yaml 文件以使用 firebase_ai 软件包：

   flutter pub add firebase_ai

2. 重新构建您的 Flutter 项目：

   flutter run

3. 完成应用迁移后（请参阅本指南中的其余部分），请务必删除旧软件包：

   flutter pub remove firebase_vertexai

Unity

“Vertex AI in Firebase”不提供对 Unity 的支持。

了解如何开始使用 Firebase AI Logic SDK for 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');

Unity

“Vertex AI in Firebase”不支持 Unity。

了解如何开始使用 Firebase AI Logic SDK for Unity。

Swift

没有其他更改。

Kotlin

• Live API

  • 移除了枚举类 ResponseModality 的 UNSPECIFIED 值。而是改用 null。

Java

• Live API

  • 移除了枚举类 ResponseModality 的 UNSPECIFIED 值。而是改用 null。

• 更改了各种 Java 构建器方法，现在可以正确返回其类的实例，而不是 void。

Web

仅当您开始使用 Gemini Developer API（而非 Agent Platform Gemini API (formerly Vertex AI)）时，才需要进行更改：

• 安全设置

  • 移除了不受支持的 SafetySetting.method 的用法。

• 内嵌数据

  • 移除了不受支持的 InlineDataPart.videoMetadata 的用法。

Dart

没有其他更改。

Unity

“Vertex AI in Firebase”不支持 Unity。

了解如何开始使用 Firebase AI Logic SDK for Unity。