Di chuyển sang SDK Logic AI Firebase từ SDK ứng dụng Google AI

Swift

Sử dụng Trình quản lý gói Swift để cài đặt và quản lý các phần phụ thuộc Firebase.

Thư viện Firebase AI Logic cung cấp quyền truy cập vào các API để tương tác với các mô hình Gemini và Imagen. Thư viện này được đưa vào trong SDK Firebase cho các nền tảng Apple (firebase-ios-sdk).

Nếu bạn đã sử dụng Firebase, hãy đảm bảo gói Firebase của bạn là phiên bản v11.13.0 trở lên.

1. Trong Xcode, khi dự án ứng dụng đang mở, hãy chuyển đến File > Add Package Dependencies (Tệp > Thêm phần phụ thuộc gói).

2. Khi được nhắc, hãy thêm kho lưu trữ SDK của các nền tảng Apple của Firebase:

   https://github.com/firebase/firebase-ios-sdk
   

3. Chọn phiên bản SDK mới nhất.

4. Chọn thư viện FirebaseAI.

Khi hoàn tất, Xcode sẽ tự động bắt đầu phân giải và tải các phần phụ thuộc xuống ở chế độ nền.

Kotlin

SDK Firebase AI Logic cho Android (firebase-ai) cung cấp quyền truy cập vào các API để tương tác với các mô hình Gemini và Imagen.

Trong tệp Gradle (ở cấp ứng dụng) của mô-đun (chẳng hạn như <project>/<app-module>/build.gradle.kts), hãy thêm phần phụ thuộc cho thư viện Firebase AI Logic dành cho Android. Bạn nên sử dụng Firebase Android BoM để kiểm soát việc tạo phiên bản thư viện.

dependencies {
  // ... other androidx dependencies

  // Import the BoM for the Firebase platform
  implementation(platform("com.google.firebase:firebase-bom:33.15.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")
}

Bằng cách sử dụng Firebase Android BoM, ứng dụng của bạn sẽ luôn sử dụng những phiên bản tương thích của thư viện Android trên Firebase.

dependencies {
  // Add the dependency for the Firebase AI Logic library
  // When NOT using the BoM, you must specify versions in Firebase library dependencies
  implementation("com.google.firebase:firebase-ai:16.1.0")
}

Java

SDK Firebase AI Logic cho Android (firebase-ai) cung cấp quyền truy cập vào các API để tương tác với các mô hình Gemini và Imagen.

Trong tệp Gradle (ở cấp ứng dụng) của mô-đun (chẳng hạn như <project>/<app-module>/build.gradle.kts), hãy thêm phần phụ thuộc cho thư viện Firebase AI Logic dành cho Android. Bạn nên sử dụng Firebase Android BoM để kiểm soát việc tạo phiên bản thư viện.

Đối với Java, bạn cần thêm hai thư viện bổ sung.

dependencies {
  // ... other androidx dependencies

  // Import the BoM for the Firebase platform
  implementation(platform("com.google.firebase:firebase-bom:33.15.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")

  // Required for one-shot operations (to use `ListenableFuture` from Guava Android)
  implementation("com.google.guava:guava:31.0.1-android")

  // Required for streaming operations (to use `Publisher` from Reactive Streams)
  implementation("org.reactivestreams:reactive-streams:1.0.4")
}

Bằng cách sử dụng Firebase Android BoM, ứng dụng của bạn sẽ luôn sử dụng những phiên bản tương thích của thư viện Android trên Firebase.

dependencies {
  // Add the dependency for the Firebase AI Logic library
  // When NOT using the BoM, you must specify versions in Firebase library dependencies
  implementation("com.google.firebase:firebase-ai:16.1.0")
}

Web

Thư viện Firebase AI Logic cung cấp quyền truy cập vào các API để tương tác với các mô hình Gemini và Imagen. Thư viện này được đưa vào là một phần của SDK JavaScript Firebase cho Web.

1. Cài đặt SDK JS Firebase cho web bằng npm:

   npm install firebase
   

2. Khởi động Firebase trong ứng dụng:

   import { initializeApp } from "firebase/app";
   
   // 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);
   

Dart

Trình bổ trợ Firebase AI Logic cho Flutter (firebase_ai) cung cấp quyền truy cập vào các API để tương tác với các mô hình Gemini và Imagen.

1. Từ thư mục dự án Flutter, hãy chạy lệnh sau để cài đặt trình bổ trợ cốt lõi và trình bổ trợ Firebase AI Logic:

   flutter pub add firebase_core && flutter pub add firebase_ai
   

2. Trong tệp lib/main.dart, hãy nhập trình bổ trợ lõi Firebase, trình bổ trợ Firebase AI Logic và tệp cấu hình mà bạn đã tạo trước đó:

   import 'package:firebase_core/firebase_core.dart';
   import 'package:firebase_ai/firebase_ai.dart';
   import 'firebase_options.dart';
   

3. Ngoài ra, trong tệp lib/main.dart, hãy khởi chạy Firebase bằng đối tượng DefaultFirebaseOptions do tệp cấu hình xuất:

   await Firebase.initializeApp(
     options: DefaultFirebaseOptions.currentPlatform,
   );
   

4. Tạo lại ứng dụng Flutter:

   flutter run
   

Unity

SDK ứng dụng Google AI không hỗ trợ Unity.

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

Swift

Xoá thư viện cũ:

1. Trong Xcode, khi dự án ứng dụng của bạn đang mở, hãy chuyển đến ngăn Packages Dependencies (Phần phụ thuộc gói).

2. Chọn gói generative-ai-swift trong danh sách các phần phụ thuộc gói.

3. Nhấp vào nút - ở cuối danh sách rồi nhấp vào Xoá để xác nhận.

Kotlin

dependencies {
    implementation("com.google.ai.client.generativeai:generativeai:VERSION")
}

Java

dependencies {
    implementation("com.google.ai.client.generativeai:generativeai:VERSION")
}

Web

// BEFORE
import { initializeApp } from "firebase/app";
import { GoogleGenerativeAI } from "@google/generative-ai";

Dart

Xoá gói cũ:
flutter pub remove google_generative_ai

Unity

SDK ứng dụng Google AI không hỗ trợ Unity.

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

Swift

// BEFORE
import GoogleGenerativeAI

let model = GenerativeModel(name: "MODEL_NAME", apiKey: APIKey.default)

// AFTER
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

// BEFORE
import com.google.ai.client.generativeai.Chat
import com.google.ai.client.generativeai.type.Content
import com.google.ai.client.generativeai.java.GenerativeModuleFutures

...

val generativeModel = GenerativeModel(modelName = "MODEL_NAME",
  // Access your API key as a Build Configuration variable
  apiKey = BuildConfig.apiKey
)

// AFTER
import com.google.firebase.Firebase
import com.google.firebase.ai.ai
import com.google.firebase.ai.type.GenerativeBackend

...

// 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

// BEFORE
import com.google.ai.client.generativeai.Chat;
import com.google.ai.client.generativeai.type.Content;
import com.google.ai.client.generativeai.java.GenerativeModuleFutures;

...

GenerativeModel gm = new GenerativeModel("MODEL_NAME",
  // Access your API key as a Build Configuration variable
  BuildConfig.apiKey
);

GenerativeModelFutures model = GenerativeModelFutures.from(gm);

// AFTER
import com.google.firebase.ai.FirebaseAI;
import com.google.firebase.ai.GenerativeModel;
import com.google.firebase.ai.java.GenerativeModelFutures;
import com.google.firebase.ai.type.GenerativeBackend;

...

// 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

// BEFORE
import { GoogleGenerativeAI } from "@google/generative-ai";

// Fetch your API_KEY and access your API
const API_KEY = "...";
const genAI = new GoogleGenerativeAI(API_KEY);

...

const model = genAI.getGenerativeModel({ model: "MODEL_NAME"});

// AFTER
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

// BEFORE
import 'package:google_generative_ai/google_generative_ai.dart';

final apiKey = Platform.environment['API_KEY'];
if (apiKey == null) {
print('No \$API_KEY environment variable');
exit(1);
}

final model = GenerativeModel(model: 'MODEL_NAME', apiKey: apiKey);

// AFTER
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');

Unity

SDK ứng dụng Google AI không hỗ trợ Unity.

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

Swift

• Danh sách liệt kê

  • Thay thế hầu hết các loại enum bằng struct có biến tĩnh. Thay đổi này cho phép linh hoạt hơn trong việc phát triển API theo cách tương thích ngược. Khi sử dụng câu lệnh switch, giờ đây, bạn phải đưa vào một trường hợp default: để bao gồm các giá trị không xác định hoặc chưa được xử lý, bao gồm cả các giá trị mới được thêm vào SDK trong tương lai.

  • Đổi tên enum BlockThreshold thành HarmBlockThreshold; loại này hiện là struct.

  • Xoá các trường hợp unknown và unspecified khỏi các giá trị liệt kê sau (hiện là struct): HarmCategory, HarmBlockThreshold, HarmProbability, BlockReason và FinishReason.

  • Thay thế enum ModelContent.Part bằng một giao thức có tên Part để cho phép thêm các loại mới theo cách tương thích ngược. Thay đổi này được mô tả chi tiết hơn trong phần Phần nội dung.

• Phần nội dung

  • Xoá giao thức ThrowingPartsRepresentable và đơn giản hoá trình khởi chạy cho ModelContent để tránh các lỗi trình biên dịch thỉnh thoảng xảy ra. Những hình ảnh không được mã hoá đúng cách vẫn sẽ gửi lỗi khi được sử dụng trong generateContent.

  • Thay thế các trường hợp ModelContent.Part bằng các loại struct sau đây tuân thủ giao thức Part:

    • .text đến TextPart
    • .data đến InlineDataPart
    • .fileData đến FileDataPart
    • .functionCall đến FunctionCallPart
    • .functionResponse đến FunctionResponsePart

• Danh mục gây hại

  • Thay đổi HarmCategory để không còn lồng trong loại SafetySetting. Nếu bạn đang tham chiếu đến lớp này là SafetySetting.HarmCategory, thì bạn có thể thay thế lớp đó bằng HarmCategory.

• Phản hồi về sự an toàn

  • Xoá loại SafetyFeedback vì loại này không được dùng trong bất kỳ phản hồi nào.

• Siêu dữ liệu trích dẫn

  • Đổi tên thuộc tính citationSources thành citations trong CitationMetadata.

• Tổng số ký tự có thể tính phí

  • Thay đổi thuộc tính totalBillableCharacters trong CountTokensResponse thành không bắt buộc để phản ánh các trường hợp không gửi ký tự nào.

• Phản hồi của đề xuất

  • Đổi tên CandidateResponse thành Candidate để khớp với các nền tảng khác.

• Cấu hình tạo

  • Thay đổi các thuộc tính công khai của GenerationConfig thành internal. Tất cả các thuộc tính này vẫn có thể định cấu hình trong trình khởi tạo.

Kotlin

• Danh sách liệt kê

  • Thay thế các lớp enum và sealed bằng các lớp thông thường. Thay đổi này cho phép linh hoạt hơn trong việc phát triển API theo cách tương thích ngược.

  • Đổi tên enum BlockThreshold thành HarmBlockThreshold.

  • Xoá các giá trị khỏi các enum sau: HarmBlockThreshold, HarmProbability, HarmSeverity, BlockReason và FinishReason.

• Phương thức Blob

  • Đổi tên tất cả các phương thức có tên bao gồm Blob thành InlineData.

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

  • Thay đổi trường method thành có thể nhận giá trị rỗng.

• Lớp thời lượng

  • Xoá tất cả cách sử dụng lớp Duration của Kotlin và thay thế bằng long. Thay đổi này giúp tăng khả năng tương tác với Java.

• Siêu dữ liệu trích dẫn

  • Gói tất cả các trường đã khai báo trước đó trong CitationMetadata vào một lớp mới có tên là Citation. Bạn có thể tìm thấy các trích dẫn trong danh sách có tên citations trong CitationMetadata. Thay đổi này giúp điều chỉnh các loại tốt hơn trên các nền tảng.

• Tính số lượng mã thông báo

  • Thay đổi trường totalBillableCharacters thành có thể nhận giá trị rỗng.

• Tổng số ký tự có thể tính phí

  • Thay đổi thuộc tính totalBillableCharacters trong CountTokensResponse thành không bắt buộc để phản ánh các trường hợp không gửi ký tự nào.

• Tạo bản sao mô hình

  • Chuyển tham số requestOptions vào cuối danh sách tham số để phù hợp với các nền tảng khác.

Java

• Danh sách liệt kê

  • Thay thế các lớp enum và sealed bằng các lớp thông thường. Thay đổi này cho phép linh hoạt hơn trong việc phát triển API theo cách tương thích ngược.

  • Đổi tên enum BlockThreshold thành HarmBlockThreshold.

  • Xoá các giá trị khỏi các enum sau: HarmBlockThreshold, HarmProbability, HarmSeverity, BlockReason và FinishReason.

• Phương thức Blob

  • Đổi tên tất cả các phương thức có tên bao gồm Blob thành InlineData.

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

  • Thay đổi trường method thành có thể nhận giá trị rỗng.

• Lớp thời lượng

  • Xoá tất cả cách sử dụng lớp Duration của Kotlin và thay thế bằng long. Thay đổi này giúp tăng khả năng tương tác với Java.

• Siêu dữ liệu trích dẫn

  • Gói tất cả các trường đã khai báo trước đó trong CitationMetadata vào một lớp mới có tên là Citation. Bạn có thể tìm thấy các trích dẫn trong danh sách có tên citations trong CitationMetadata. Thay đổi này giúp điều chỉnh các loại tốt hơn trên các nền tảng.

• Tính số lượng mã thông báo

  • Thay đổi trường totalBillableCharacters thành có thể nhận giá trị rỗng.

• Tổng số ký tự có thể tính phí

  • Thay đổi thuộc tính totalBillableCharacters trong CountTokensResponse thành không bắt buộc để phản ánh các trường hợp không gửi ký tự nào.

• Tạo bản sao mô hình

  • Chuyển tham số requestOptions vào cuối danh sách tham số để phù hợp với các nền tảng khác.

Web

Xin lưu ý rằng SDK ứng dụng Google AI cho JavaScript đã có nhiều thay đổi kể từ thời điểm SDK ứng dụng Firebase AI Logic phân nhánh từ SDK ứng dụng Google AI. Danh sách sau đây là một số thay đổi tiềm ẩn mà bạn có thể cần cân nhắc khi di chuyển sang SDK ứng dụng Firebase AI Logic.

• Danh sách liệt kê

  • Xoá các giá trị khỏi các enum sau: HarmCategory, BlockThreshold, HarmProbability, HarmSeverity, BlockReason và FinishReason.

• Lý do chặn

  • Thay đổi blockReason trong PromptFeedback thành không bắt buộc.

• Tìm kiếm cơ sở

  • Xoá tất cả các trường hợp sử dụng tính năng này vì tính năng này chưa được hỗ trợ trong SDK Firebase AI Logic.

• Lỗi

  • Xoá tất cả các trường hợp sử dụng GoogleGenerativeAIError và tuỳ ý chuyển sang AIError.

Dart

• Danh sách liệt kê

  • Xoá các giá trị khỏi các enum sau: HarmCategory, HarmProbability, BlockReason và FinishReason.

• Phần dữ liệu

  • Đổi tên DataPart thành InlineDataPart và hàm static data thành inlineData để phù hợp với các nền tảng khác.

• Các lựa chọn yêu cầu

  • Xoá RequestOptions vì timeout không hoạt động. Loại này sẽ được thêm lại trong tương lai gần, nhưng sẽ được chuyển sang loại GenerativeModel để khớp với các nền tảng khác.

• Dừng trình tự

  • Thay đổi tham số stopSequences trong GenerationConfig thành tham số không bắt buộc và mặc định là null thay vì một mảng trống.

• Câu trích dẫn

  • Đổi tên thuộc tính citationSources thành citations trong CitationMetadata. Loại CitationSource được đổi tên thành Citation để khớp với các nền tảng khác.

• Các loại, phương thức và thuộc tính công khai không cần thiết

  • Xoá các loại, phương thức và thuộc tính sau đây bị hiển thị ngoài ý muốn: defaultTimeout, CountTokensResponseFields, parseCountTokensResponse, parseEmbedContentResponse, parseGenerateContentResponse, parseContent, BatchEmbedContentsResponse, ContentEmbedding, EmbedContentRequest và EmbedContentResponse.

• Tính số lượng mã thông báo

  • Xoá các trường bổ sung khỏi hàm countTokens không còn cần thiết nữa. Chỉ cần contents.

• Tạo bản sao mô hình

  • Di chuyển tham số systemInstruction xuống cuối danh sách tham số để phù hợp với các nền tảng khác.

• Nhúng chức năng

  • Xoá chức năng nhúng không được hỗ trợ (embedContent và batchEmbedContents) khỏi mô hình.

Unity

SDK ứng dụng Google AI không hỗ trợ Unity.

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