از نسخه GA Vertex AI در SDKهای Firebase به AI Logic SDKهای Firebase مهاجرت کنید. Vertex AI در SDKهای Firebase

با مجموعه‌ها، منظم بمانید ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.

سویفت

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

   • گزینه 1 : به روز رسانی همه بسته ها: به File > Packages > Update to Latest Package Versions بروید.

   • گزینه 2 : به‌روزرسانی Firebase به صورت جداگانه: به بسته Firebase در قسمتی به نام Package Dependencies بروید. روی بسته Firebase کلیک راست کنید و سپس Update Package را انتخاب کنید.

2. مطمئن شوید که بسته Firebase اکنون نسخه 11.13.0 یا بالاتر را نشان می دهد. اگر اینطور نیست، بررسی کنید که بسته مورد نیاز مشخص شده شما اجازه به روز رسانی به نسخه 11.13.0 یا جدیدتر را می دهد.

3. هدف برنامه خود را در ویرایشگر پروژه انتخاب کنید و سپس به بخش Frameworks، Libraries و Embedded Content بروید.

4. افزودن کتابخانه جدید: دکمه + را انتخاب کنید و سپس FirebaseAI را از بسته 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:33.14.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. پروژه اندروید خود را با فایل های 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:33.14.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. پروژه اندروید خود را با فایل های Gradle همگام سازی کنید.

توجه داشته باشید که اگر تصمیم گرفتید از Firebase Android BoM استفاده نکنید، فقط وابستگی را برای کتابخانه firebase-ai اضافه کنید و آخرین نسخه پیشنهادی Android Studio را بپذیرید.

Web

1. آخرین نسخه Firebase JS SDK for Web را با استفاده از 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. با اجرای دستور زیر از دایرکتوری پروژه Flutter خود، بسته firebase_ai را در فایل pubspec.yaml خود به روز کنید:

   flutter pub add firebase_ai

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

   flutter run

3. پس از اتمام مهاجرت برنامه خود (به بخش های باقی مانده در این راهنما مراجعه کنید)، مطمئن شوید که بسته قدیمی را حذف کرده اید:

   flutter pub remove firebase_vertexai

وحدت

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

یاد بگیرید که چگونه با Firebase AI Logic SDK for Unity شروع کنید .

سویفت

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.0-flash")

Kotlin

// 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.0-flash")

Java

// 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.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, 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.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 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.0-flash');

وحدت

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

یاد بگیرید که چگونه با Firebase AI Logic SDK for Unity شروع کنید .

سویفت

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

Kotlin

• Live API

  • مقدار UNSPECIFIED برای کلاس enum ResponseModality حذف شد. در عوض از null استفاده کنید.

Java

• Live API

  • مقدار UNSPECIFIED برای کلاس enum ResponseModality حذف شد. در عوض از null استفاده کنید.

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

Web

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

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

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

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

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

Dart

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

وحدت

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

یاد بگیرید که چگونه با Firebase AI Logic SDK for Unity شروع کنید .