نقل البيانات إلى حِزم تطوير البرامج (SDK) الخاصة بـ Firebase AI Logic من إصدار "إحصاءات Google" من حِزم تطوير البرامج (SDK) الخاصة بـ Vertex AI في Firebase

Swift

1. في Xcode، بعد فتح مشروع تطبيقك، حدِّث حزمة Firebase إلى الإصدار 12.5.0 أو إصدار أحدث باستخدام أحد الخيارات التالية:

   • الخيار 1: تحديث جميع الحِزم: انتقِل إلى الملف (File) > الحِزم (Packages) > التحديث إلى آخر إصدارات الحِزم (Update to Latest Package Versions).

   • الخيار 2: تحديث Firebase بشكل فردي: انتقِل إلى حزمة Firebase في القسم الذي يحمل اسم تبعيّات الحزمة. انقر بزر الماوس الأيمن على حزمة Firebase، ثم اختَر تحديث الحزمة.

2. تأكَّد من أنّ حزمة Firebase تعرض الآن الإصدار 12.5.0 أو إصدارًا أحدث. وإذا لم يتم ذلك، يُرجى التأكّد من أنّ متطلبات الحزمة المحدّدة تسمح بالتحديث إلى الإصدار 12.5.0 أو إصدار أحدث.

3. اختَر هدف تطبيقك في "محرِّر المشاريع" (Project Editor)، ثم انتقِل إلى قسم الأُطر والمكتبات والمحتوى المضمّن (Frameworks, Libraries, and Embedded Content).

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".

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".

Web

1. احصل على أحدث إصدار من حزمة تطوير البرامج (SDK) لبرنامج Firebase JS للويب باستخدام 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. عدِّل ملف pubspec.yaml لاستخدام حزمة firebase_ai من خلال تنفيذ الأمر التالي من دليل مشروع Flutter:

   flutter pub add firebase_ai

2. أعِد إنشاء مشروع Flutter:

   flutter run

3. بعد الانتهاء من نقل تطبيقك (راجِع الأقسام المتبقية في هذا الدليل)، احرص على حذف الحزمة القديمة باتّباع الخطوات التالية:

   flutter pub remove firebase_vertexai

Unity

لم يكن تطبيق Unity متاحًا من "Vertex AI in Firebase".

تعرَّف على كيفية بدء استخدام حزمة تطوير البرامج (SDK) الخاصة بـ "Firebase AI Logic" لمنصة 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".

تعرَّف على كيفية بدء استخدام حزمة تطوير البرامج (SDK) الخاصة بـ "Firebase AI Logic" لمنصة Unity.

Swift

لن يتم إجراء أي تغييرات إضافية.

Kotlin

• Live API

  • تمت إزالة القيمة UNSPECIFIED لفئة التعداد ResponseModality. بدلاً من ذلك، استخدِم null.

Java

• Live API

  • تمت إزالة القيمة UNSPECIFIED لفئة التعداد ResponseModality. بدلاً من ذلك، استخدِم null.

• تم تغيير العديد من طرق Java builder لتعرض الآن مثيل فئتها بشكل صحيح، بدلاً من void.

Web

يجب إجراء تغييرات فقط إذا كنت ستستخدم Gemini Developer API (بدلاً من Agent Platform Gemini API (formerly Vertex AI)):

• إعدادات الأمان

  • تمت إزالة استخدامات SafetySetting.method غير المتوافقة.

• البيانات المضمّنة

  • تمت إزالة استخدامات InlineDataPart.videoMetadata غير المتوافقة.

Dart

لن يتم إجراء أي تغييرات إضافية.

Unity

لم يكن الدعم متاحًا لـ Unity من "Vertex AI in Firebase".

كيفية بدء استخدام حزمة تطوير البرامج (SDK) الخاصة بـ Firebase AI Logic لمشاريع Unity