از نسخه GA کیت‌های توسعه نرم‌افزار Vertex AI در کیت‌های توسعه نرم‌افزار Firebase به کیت‌های توسعه نرم‌افزار Firebase AI Logic انتقال دهید

Swift

1. در Xcode، با باز بودن پروژه برنامه، بسته Firebase خود را بااستفاده از یکی از گزینه‌های زیر به v12.5.0 یا نسخه‌های جدیدتر به‌روز کنید:

   • گزینه ۱: به‌روزرسانی همه بسته‌ها: به فایل > بسته‌ها > به‌روزرسانی به جدیدترین نسخه‌های بسته پیمایش کنید.

   • گزینه ۲: به‌روزرسانی Firebase به‌صورت جداگانه: به بسته Firebase در بخش وابستگی‌های بسته پیمایش کنید. روی بسته Firebase کلیک راست کنید و سپس به‌روزرسانی بسته را انتخاب کنید.

2. مطمئن شوید که بسته Firebase اکنون نسخه ۱۲.۵.۰ یا بالاتر را نشان می‌دهد. اگر این‌طور نیست، تأیید کنید که ملزومات بسته مشخص‌شده شما اجازه به‌روزرسانی به نسخه ۱۲.۵.۰ یا جدیدتر را می‌دهد.

3. هدف برنامه‌تان را در «ویرایشگر پروژه» انتخاب کنید، و سپس به بخش چارچوب‌ها، کتابخانه‌ها، و محتوای جاسازی‌شده پیمایش کنید.

4. کتابخانه جدید را اضافه کنید: دکمه + را انتخاب کنید، و سپس FirebaseAILogic را از بسته Firebase اضافه کنید.

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.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 استفاده نکنید، کافی است وابستگی را برای کتابخانه 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.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 استفاده نکنید، کافی است وابستگی را برای کتابخانه firebase-ai اضافه کنید و جدیدترین نسخه‌ای را که توسط Android Studio پیشنهاد می‌شود بپذیرید.

Web

1. بااستفاده از npm، جدیدترین نسخه «کیت توسعه نرم‌افزار Firebase JS برای وب» را دریافت کنید:

   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. با اجرای فرمان زیر از دایرکتوری پروژه Flutter، بسته firebase_ai را در فایل pubspec.yaml به‌روز کنید:

   flutter pub add firebase_ai

2. پروژه Flutter خود را بازسازی کنید:

   flutter run

3. پس‌از اینکه انتقال برنامه‌تان را تمام کردید (بخش‌های باقی‌مانده در این راهنما را ببینید)، حتماً بسته قدیمی را حذف کنید:

   flutter pub remove firebase_vertexai

Unity

پشتیبانی از Unity از «Vertex AI in Firebase» دردسترس نبود.

با نحوه شروع به کار با Firebase AI Logic SDK برای Unity آشنا شوید.

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

پشتیبانی از Unity از «Vertex AI in Firebase» دردسترس نبود.

با نحوه شروع به کار با Firebase AI Logic SDK برای Unity آشنا شوید.

Swift

بدون تغییرات اضافی.

Kotlin

• Live API

  • مقدار UNSPECIFIED برای کلاس شمارشی ResponseModality برداشته شد. به‌جای آن از null استفاده کنید.

Java

• Live API

  • مقدار UNSPECIFIED برای کلاس شمارشی ResponseModality برداشته شد. به‌جای آن از null استفاده کنید.

• روش‌های مختلف سازنده Java تغییر کرد تا اکنون به‌جای void، نمونه کلاس خود را به‌درستی برگرداند.

Web

تغییرات فقط درصورتی لازم است که شروع به استفاده از Gemini Developer API (به‌جای Agent Platform Gemini API (formerly Vertex AI)) کرده باشید:

• تنظیمات ایمنی

  • موارد استفاده از SafetySetting.method پشتیبانی‌نشده برداشته شد.

• داده‌های درون‌خطی

  • موارد استفاده از InlineDataPart.videoMetadata پشتیبانی‌نشده برداشته شد.

Dart

بدون تغییرات اضافی.

Unity

پشتیبانی از Unity از «Vertex AI in Firebase» دردسترس نبود.

با نحوه شروع به کار با Firebase AI Logic SDK برای Unity آشنا شوید.