Bermigrasi ke Firebase AI Logic SDK dari Vertex AI in Firebase SDK versi GA

Swift

1. Di Xcode, dengan project aplikasi Anda dalam keadaan terbuka, update paket Firebase ke v11.13.0 atau yang lebih baru menggunakan salah satu opsi berikut:

   • Opsi 1: Update semua paket: Buka File > Packages > Update to Latest Package Versions.

   • Opsi 2: Perbarui Firebase satu per satu: Buka paket Firebase di bagian yang disebut Package Dependencies. Klik kanan paket Firebase, lalu pilih Update Package.

2. Pastikan paket Firebase kini menampilkan v11.13.0 atau yang lebih baru. Jika tidak, pastikan Persyaratan Paket yang Anda tentukan mengizinkan update ke v11.13.0 atau yang lebih baru.

3. Pilih target aplikasi Anda di Project Editor, lalu buka bagian Frameworks, Libraries, and Embedded Content.

4. Tambahkan library baru: Pilih tombol +, lalu tambahkan FirebaseAI dari paket Firebase.

5. Setelah Anda selesai memigrasikan aplikasi (lihat bagian yang tersisa dalam panduan ini), pastikan untuk menghapus library lama:
   Pilih FirebaseVertexAI, lalu tekan tombol —.

Kotlin

1. Dalam file Gradle modul (level aplikasi) (biasanya <project>/<app-module>/build.gradle.kts atau <project>/<app-module>/build.gradle), ganti dependensi lama (jika berlaku) dengan yang berikut.

   Perhatikan bahwa mungkin lebih mudah untuk memigrasikan codebase aplikasi Anda (lihat bagian lainnya dalam panduan ini) sebelum menghapus dependensi lama.

   // 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.16.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. Sinkronkan project Android Anda dengan file Gradle.

Perhatikan bahwa jika Anda memilih untuk tidak menggunakan Firebase Android BoM, cukup tambahkan dependensi untuk library firebase-ai dan setujui versi terbaru yang disarankan oleh Android Studio.

Java

1. Dalam file Gradle modul (level aplikasi) (biasanya <project>/<app-module>/build.gradle.kts atau <project>/<app-module>/build.gradle), ganti dependensi lama (jika berlaku) dengan yang berikut.

   Perhatikan bahwa mungkin lebih mudah untuk memigrasikan codebase aplikasi Anda (lihat bagian lainnya dalam panduan ini) sebelum menghapus dependensi lama.

   // 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.16.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. Sinkronkan project Android Anda dengan file Gradle.

Perhatikan bahwa jika Anda memilih untuk tidak menggunakan Firebase Android BoM, cukup tambahkan dependensi untuk library firebase-ai dan setujui versi terbaru yang disarankan oleh Android Studio.

Web

1. Dapatkan Firebase JS SDK untuk Web versi terbaru menggunakan npm:

   npm i firebase@latest

   ATAU

   yarn add firebase@latest

2. Di mana pun Anda mengimpor library, perbarui pernyataan impor untuk menggunakan firebase/ai.

   Perhatikan bahwa mungkin lebih mudah untuk memigrasikan codebase aplikasi Anda (lihat bagian lainnya dalam panduan ini) sebelum menghapus impor lama.

   // 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. Perbarui untuk menggunakan paket firebase_ai dalam file pubspec.yaml Anda dengan menjalankan perintah berikut dari direktori project Flutter Anda:

   flutter pub add firebase_ai

2. Build ulang project Flutter Anda:

   flutter run

3. Setelah Anda selesai memigrasikan aplikasi (lihat bagian yang tersisa dalam panduan ini), pastikan untuk menghapus paket lama:

   flutter pub remove firebase_vertexai

Unity

Dukungan untuk Unity tidak tersedia dari "Vertex AI in Firebase".

Pelajari cara memulai Firebase AI Logic SDK untuk 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.5-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.5-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.5-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.5-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.5-flash');

Unity

Dukungan untuk Unity tidak tersedia sejak "Vertex AI in Firebase".

Pelajari cara memulai Firebase AI Logic SDK untuk Unity.

Swift

Tidak ada perubahan tambahan.

Kotlin

• Live API

  • Menghapus nilai UNSPECIFIED untuk class enum ResponseModality. Sebagai gantinya, gunakan null.

Java

• Live API

  • Menghapus nilai UNSPECIFIED untuk class enum ResponseModality. Sebagai gantinya, gunakan null.

• Mengubah berbagai metode builder Java agar kini menampilkan instance class-nya dengan benar, bukan void.

Web

Perubahan hanya diperlukan jika Anda mulai menggunakan Gemini Developer API (bukan Vertex AI Gemini API):

• Setelan keamanan

  • Menghapus penggunaan SafetySetting.method yang tidak didukung.

• Data inline

  • Menghapus penggunaan InlineDataPart.videoMetadata yang tidak didukung.

Dart

Tidak ada perubahan tambahan.

Unity

Dukungan untuk Unity tidak tersedia sejak "Vertex AI in Firebase".

Pelajari cara memulai Firebase AI Logic SDK untuk Unity.