Di chuyển sang SDK Logic AI Firebase từ phiên bản GA của SDK Vertex AI trong Firebase

Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.

Swift

1. Trong Xcode, khi dự án ứng dụng đang mở, hãy cập nhật gói Firebase lên phiên bản v11.13.0 trở lên bằng một trong các tuỳ chọn sau:

   • Cách 1: Cập nhật tất cả gói: Chuyển đến File > Packages > Update to Latest Package Versions (Tệp > Gói > Cập nhật lên phiên bản gói mới nhất).

   • Cách 2: Cập nhật Firebase riêng lẻ: Chuyển đến gói Firebase trong mục Package Dependencies (Phần phụ thuộc gói). Nhấp chuột phải vào gói Firebase, sau đó chọn Cập nhật gói.

2. Đảm bảo rằng gói Firebase hiện hiển thị phiên bản 11.13.0 trở lên. Nếu không, hãy xác minh rằng Yêu cầu về gói mà bạn chỉ định cho phép cập nhật lên phiên bản 11.13.0 trở lên.

3. Chọn mục tiêu của ứng dụng trong Project Editor (Trình chỉnh sửa dự án), sau đó chuyển đến phần Khung, Thư viện và Nội dung nhúng.

4. Thêm thư viện mới: Chọn nút +, sau đó thêm FirebaseAI từ gói Firebase.

5. Sau khi bạn hoàn tất quá trình di chuyển ứng dụng (xem các phần còn lại trong hướng dẫn này), hãy nhớ xoá thư viện cũ:
   Chọn FirebaseVertexAI, rồi nhấn nút —.

Kotlin

1. Trong tệp Gradle của mô-đun (cấp ứng dụng) (thường là <project>/<app-module>/build.gradle.kts hoặc <project>/<app-module>/build.gradle), hãy thay thế các phần phụ thuộc cũ (nếu có) bằng các phần phụ thuộc sau.

   Xin lưu ý rằng bạn có thể dễ dàng di chuyển cơ sở mã của ứng dụng (xem các phần còn lại trong hướng dẫn này) trước khi xoá phần phụ thuộc cũ.

   // 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.13.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. Đồng bộ hoá dự án Android với các tệp Gradle.

Xin lưu ý rằng nếu bạn chọn không sử dụng Firebase Android BoM, thì bạn chỉ cần thêm phần phụ thuộc cho thư viện firebase-ai và chấp nhận phiên bản mới nhất do Android Studio đề xuất.

Java

1. Trong tệp Gradle của mô-đun (cấp ứng dụng) (thường là <project>/<app-module>/build.gradle.kts hoặc <project>/<app-module>/build.gradle), hãy thay thế các phần phụ thuộc cũ (nếu có) bằng các phần phụ thuộc sau.

   Xin lưu ý rằng bạn có thể dễ dàng di chuyển cơ sở mã của ứng dụng (xem các phần còn lại trong hướng dẫn này) trước khi xoá phần phụ thuộc cũ.

   // 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.13.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. Đồng bộ hoá dự án Android với các tệp Gradle.

Xin lưu ý rằng nếu bạn chọn không sử dụng Firebase Android BoM, thì bạn chỉ cần thêm phần phụ thuộc cho thư viện firebase-ai và chấp nhận phiên bản mới nhất do Android Studio đề xuất.

Web

1. Tải phiên bản mới nhất của SDK Firebase JS cho web bằng npm:

   npm i firebase@latest

   HOẶC

   yarn add firebase@latest

2. Bất cứ nơi nào bạn đã nhập thư viện, hãy cập nhật câu lệnh nhập để sử dụng firebase/ai.

   Xin lưu ý rằng bạn có thể dễ dàng di chuyển cơ sở mã của ứng dụng (xem các phần còn lại trong hướng dẫn này) trước khi xoá các lệnh nhập cũ.

   // 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. Cập nhật để sử dụng gói firebase_ai trong tệp pubspec.yaml bằng cách chạy lệnh sau trong thư mục dự án Flutter:

   flutter pub add firebase_ai

2. Tạo lại dự án Flutter:

   flutter run

3. Sau khi bạn di chuyển xong ứng dụng (xem các phần còn lại trong hướng dẫn này), hãy nhớ xoá gói cũ:

   flutter pub remove firebase_vertexai

Unity

"Vertex AI in Firebase" không hỗ trợ Unity.

Tìm hiểu cách bắt đầu sử dụng SDK Firebase AI Logic cho Unity.

Swift

import FirebaseAI

// Initialize the Vertex AI Gemini API backend service
let ai = FirebaseAI.firebaseAI(backend: .vertexAI())

// Create a `GenerativeModel` instance with a model that supports your use case
let model = ai.generativeModel(modelName: "gemini-2.0-flash")

Kotlin

// Initialize the Vertex AI Gemini API backend service
// Create a `GenerativeModel` instance with a model that supports your use case
val model = Firebase.ai(backend = GenerativeBackend.vertexAI())
                        .generativeModel("gemini-2.0-flash")

Java

// Initialize the Vertex AI Gemini API backend service
// Create a `GenerativeModel` instance with a model that supports your use case
GenerativeModel ai = FirebaseAI.getInstance(GenerativeBackend.vertexAI())
        .generativeModel("gemini-2.0-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, VertexAIBackend } 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 Vertex AI Gemini API backend service
const ai = getAI(firebaseApp, { backend: new VertexAIBackend() });

// Create a `GenerativeModel` instance with a model that supports your use case
const model = getGenerativeModel(ai, { model: "gemini-2.0-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 Vertex AI Gemini API backend service
// Create a `GenerativeModel` instance with a model that supports your use case
final model =
      FirebaseAI.vertexAI().generativeModel(model: 'gemini-2.0-flash');

Unity

"Vertex AI in Firebase" không hỗ trợ Unity.

Tìm hiểu cách bắt đầu sử dụng SDK Firebase AI Logic cho Unity.

Swift

Không có thay đổi nào khác.

Kotlin

• Live API

  • Xoá giá trị UNSPECIFIED cho lớp enum ResponseModality. Thay vào đó, hãy sử dụng null.

Java

• Live API

  • Xoá giá trị UNSPECIFIED cho lớp enum ResponseModality. Thay vào đó, hãy sử dụng null.

• Thay đổi nhiều phương thức trình tạo Java để hiện trả về chính xác thực thể của lớp, thay vì void.

Web

Bạn chỉ cần thực hiện các thay đổi nếu bắt đầu sử dụng Gemini Developer API (thay vì Vertex AI Gemini API):

• Chế độ cài đặt an toàn

  • Xoá các cách sử dụng SafetySetting.method không được hỗ trợ.

• Dữ liệu cùng dòng

  • Xoá các cách sử dụng InlineDataPart.videoMetadata không được hỗ trợ.

Dart

Không có thay đổi nào khác.

Unity

Không hỗ trợ Unity từ "Vertex AI in Firebase".

Tìm hiểu cách bắt đầu sử dụng SDK Firebase AI Logic cho Unity.