ย้ายข้อมูลไปยัง Firebase AI Logic SDK จาก Vertex AI ใน Firebase SDK เวอร์ชัน GA

Swift

1. ใน Xcode ให้เปิดโปรเจ็กต์แอป แล้วอัปเดตแพ็กเกจ Firebase เป็น v12.5.0 ขึ้นไปโดยใช้ตัวเลือกใดตัวเลือกหนึ่งต่อไปนี้

   • ตัวเลือกที่ 1: อัปเดตแพ็กเกจทั้งหมด โดยไปที่ ไฟล์ > แพ็กเกจ > อัปเดตเป็นเวอร์ชันแพ็กเกจล่าสุด

   • ตัวเลือกที่ 2 : อัปเดต Firebase ทีละรายการ โดยไปที่แพ็กเกจ Firebase ในส่วนที่ชื่อว่า ทรัพยากร Dependency ของแพ็กเกจ คลิกขวาที่แพ็กเกจ Firebase แล้วเลือกอัปเดตแพ็กเกจ

2. ตรวจสอบว่าแพ็กเกจ Firebase แสดง v12.5.0 ขึ้นไปแล้ว หากไม่เป็นเช่นนั้น ให้ตรวจสอบว่าข้อกำหนดของ แพ็กเกจที่ระบุ อนุญาตให้อัปเดตเป็น v12.5.0 ขึ้นไป

3. เลือกเป้าหมายของแอปในโปรแกรมแก้ไขโปรเจ็กต์ แล้วไปที่ส่วนเฟรมเวิร์ก ไลบรารี และเนื้อหาที่ฝัง

4. เพิ่มไลบรารีใหม่ โดยเลือกปุ่ม + แล้วเพิ่ม FirebaseAILogic จากแพ็กเกจ Firebase

5. หลังจากย้ายข้อมูลแอปเสร็จแล้ว (ดูส่วนที่เหลือใน คู่มือนี้) ให้ตรวจสอบว่าได้นำไลบรารีเก่าออกแล้ว:
   เลือก FirebaseVertexAI, แล้วกดปุ่ม —

Kotlin

1. ในไฟล์ Gradle ของโมดูล (ระดับแอป) (โดยปกติจะเป็น <project>/<app-module>/build.gradle.kts หรือ <project>/<app-module>/build.gradle) ให้แทนที่ทรัพยากร Dependency เก่า (หากมี) ด้วยทรัพยากร Dependency ต่อไปนี้

   โปรดทราบว่าการย้ายข้อมูลฐานของโค้ดแอป (ดูส่วนที่เหลือในคู่มือนี้) ก่อนลบทรัพยากร Dependency เก่าออกอาจทำได้ง่ายกว่า

   // 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.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. ซิงค์โปรเจ็กต์ Android กับไฟล์ Gradle

โปรดทราบว่าหากเลือกที่จะไม่ใช้ Firebase Android BoM ให้เพิ่ม ทรัพยากร Dependency สำหรับไลบรารี firebase-ai และยอมรับเวอร์ชันล่าสุด ที่ Android Studio แนะนำ

Java

1. ในไฟล์ Gradle ของโมดูล (ระดับแอป) (โดยปกติจะเป็น <project>/<app-module>/build.gradle.kts หรือ <project>/<app-module>/build.gradle) ให้แทนที่ทรัพยากร Dependency เก่า (หากมี) ด้วยทรัพยากร Dependency ต่อไปนี้

   โปรดทราบว่าการย้ายข้อมูลฐานของโค้ดแอป (ดูส่วนที่เหลือในคู่มือนี้) ก่อนลบทรัพยากร Dependency เก่าออกอาจทำได้ง่ายกว่า

   // 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.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. ซิงค์โปรเจ็กต์ Android กับไฟล์ Gradle

โปรดทราบว่าหากเลือกที่จะไม่ใช้ Firebase Android BoM ให้เพิ่ม ทรัพยากร Dependency สำหรับไลบรารี firebase-ai และยอมรับเวอร์ชันล่าสุด ที่ Android Studio แนะนำ

Web

1. รับ Firebase JS SDK สำหรับเว็บเวอร์ชันล่าสุดโดยใช้ npm ดังนี้

   npm i firebase@latest

   หรือ

   yarn add firebase@latest

2. อัปเดตคำสั่งนำเข้าให้ใช้ 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. อัปเดตให้ใช้แพ็กเกจ firebase_ai ในไฟล์ pubspec.yaml โดยเรียกใช้คำสั่งต่อไปนี้จากไดเรกทอรีโปรเจ็กต์ Flutter

   flutter pub add firebase_ai

2. สร้างโปรเจ็กต์ Flutter ใหม่

   flutter run

3. หลังจากย้ายข้อมูลแอปเสร็จแล้ว (ดูส่วนที่เหลือในคู่มือนี้) ให้ตรวจสอบว่าได้ลบแพ็กเกจเก่าออกแล้ว

   flutter pub remove firebase_vertexai

Unity

"Vertex AI in Firebase" ไม่รองรับ Unity "Vertex AI in Firebase"

ดูวิธีเริ่มต้นใช้งาน SDK สำหรับ UnityFirebase AI Logic

Swift

import FirebaseAILogic

// Initialize the Agent Platform Gemini API backend service (fomerly Vertex AI).
let ai = FirebaseAI.firebaseAI(backend: .agentPlatform())

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

Kotlin

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

Java

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

// 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 Agent Platform Gemini API backend service (formerly Vertex AI).
// Create a `GenerativeModel` instance with a model that supports your use case.
final model =
      FirebaseAI.agentPlatform().generativeModel(model: 'gemini-3.8-flash');

Unity

"Vertex AI in Firebase" ไม่รองรับ Unity

ดูวิธีเริ่มต้นใช้งาน SDK สำหรับ UnityFirebase AI Logic

Swift

ไม่มีการเปลี่ยนแปลงเพิ่มเติม

Kotlin

• Live API

  • นำค่า UNSPECIFIED สำหรับคลาส enum ResponseModality ออก ให้ใช้ null แทน

Java

• Live API

  • นำค่า UNSPECIFIED สำหรับคลาส enum ResponseModality ออก ให้ใช้ null แทน

• เปลี่ยนเมธอด Java Builder ต่างๆ ให้แสดงอินสแตนซ์ของคลาสอย่างถูกต้องแทนที่จะแสดงค่าว่าง

Web

การเปลี่ยนแปลงที่จำเป็น เฉพาะในกรณีที่คุณเริ่มใช้ Gemini Developer API (แทน Agent Platform Gemini API (formerly Vertex AI))

• การตั้งค่าความปลอดภัย

  • นำการใช้งาน SafetySetting.method ที่ไม่รองรับออก

• ข้อมูลแบบอินไลน์

  • นำการใช้งาน InlineDataPart.videoMetadata ที่ไม่รองรับออก

Dart

ไม่มีการเปลี่ยนแปลงเพิ่มเติม

Unity

"Vertex AI in Firebase" ไม่รองรับ Unity

ดูวิธีเริ่มต้นใช้งาน SDK สำหรับ UnityFirebase AI Logic