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

Swift

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

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

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

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

3. اختَر هدف تطبيقك في "محرّر المشاريع"، ثم انتقِل إلى قسم الأطر والمكتبات والمحتوى المضمّن.

4. أضِف المكتبة الجديدة: انقر على الزر +، ثم أضِف FirebaseAILogic من حزمة Firebase.

5. بعد الانتهاء من نقل تطبيقك (راجِع الأقسام المتبقية في هذا الدليل)، احرص على إزالة المكتبة القديمة:
   اختَر FirebaseVertexAI-Preview، ثم اضغط على الزر —.

Kotlin

1. في ملف Gradle للوحدة (على مستوى التطبيق) (عادةً <project>/<app-module>/build.gradle.kts أو <project>/<app-module>/build.gradle)، استبدِل الاعتماديات القديمة (حسب الاقتضاء) بما يلي.

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

   // BEFORE
   dependencies {
     implementation("com.google.firebase:firebase-vertexai:16.0.0-betaXX")
   }
   
   
   // 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("com.google.firebase:firebase-vertexai:16.0.0-betaXX")
   }
   
   
   // 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-preview";
   
   
   // 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

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

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

Swift

import FirebaseAILogic

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

Unity

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

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

Swift

• التعدادات

  • تم استبدال معظم أنواع enum بـ struct مع متغيّرات ثابتة. يتيح هذا التغيير مزيدًا من المرونة لتطوير واجهة برمجة التطبيقات بطريقة متوافقة مع الأنظمة القديمة. عند استخدام عبارات switch، يجب الآن تضمين حالة default: لتغطية القيم غير المعروفة أو غير المعالَجة، بما في ذلك القيم الجديدة التي تتم إضافتها إلى حزمة تطوير البرامج (SDK) في المستقبل.

  • تمت إعادة تسمية التعداد BlockThreshold إلى HarmBlockThreshold، وأصبح هذا النوع الآن struct.

  • تمت إزالة الحالتَين unknown وunspecified من التعدادات التالية (أصبحت الآن struct): HarmCategory وHarmBlockThreshold وHarmProbability وBlockReason وFinishReason.

  • تم استبدال التعداد ModelContent.Part ببروتوكول اسمه Part للسماح بإضافة أنواع جديدة بطريقة متوافقة مع الإصدارات السابقة. يتم شرح هذا التغيير بمزيد من التفصيل في قسم أجزاء المحتوى.

• أجزاء المحتوى

  • تمت إزالة البروتوكول ThrowingPartsRepresentable، وتم تبسيط أدوات التهيئة الخاصة بـ ModelContent لتجنُّب أخطاء المترجم البرمجي العرضية. ستستمر الصور التي لا يتم ترميزها بشكل صحيح في عرض الأخطاء عند استخدامها في generateContent.

  • تم استبدال حالات ModelContent.Part بأنواع struct التالية المتوافقة مع بروتوكول Part:

    • من .text إلى TextPart
    • من .data إلى InlineDataPart
    • من .fileData إلى FileDataPart
    • من .functionCall إلى FunctionCallPart
    • من .functionResponse إلى FunctionResponsePart

• فئة الضرر

  • تم تغيير HarmCategory لكي لا يكون مضمّنًا في النوع SafetySetting. إذا كنت تشير إليه باسم SafetySetting.HarmCategory، يمكن استبداله بـ HarmCategory.

• ملاحظات حول الأمان

  • تمت إزالة النوع SafetyFeedback لأنّه لم يتم استخدامه في أي من الردود.

• البيانات الوصفية للاقتباسات

  • تمت إعادة تسمية السمة citationSources إلى citations في CitationMetadata.

• إجمالي عدد الأحرف التي تتم فوترتها

  • تم تغيير السمة totalBillableCharacters في CountTokensResponse لتصبح اختيارية من أجل مراعاة الحالات التي لا يتم فيها إرسال أي أحرف.

• ردّ المرشّح

  • تمت إعادة تسمية CandidateResponse إلى Candidate لتتطابق مع المنصات الأخرى.

• إعدادات الإنشاء

  • تم تغيير الخصائص العامة لـ GenerationConfig إلى internal. ويمكن ضبطها جميعًا في أداة التهيئة.

Kotlin

• التعدادات

  • تم استبدال فئات "enum" وفئات "sealed" بفئات عادية. يتيح هذا التغيير مزيدًا من المرونة لتطوير واجهة برمجة التطبيقات بطريقة متوافقة مع الإصدارات السابقة.

  • تمت إعادة تسمية التعداد BlockThreshold إلى HarmBlockThreshold.

  • تمت إزالة القيم من التعدادات التالية: HarmBlockThreshold وHarmProbability وHarmSeverity وBlockReason وFinishReason.

• طُرق Blob

  • تمت إعادة تسمية جميع الطرق التي تتضمّن Blob كجزء من اسمها لاستخدام InlineData بدلاً من ذلك.

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

  • تم تغيير الحقل method ليصبح قابلاً للإلغاء.

• فئة المدة

  • تمت إزالة جميع استخدامات فئة Duration في Kotlin، واستبدالها بـ long. يوفّر هذا التغيير إمكانية تشغيل متبادل أفضل مع Java.

• البيانات الوصفية لمعلومات المقالة

  • تم تضمين جميع الحقول التي تم تعريفها سابقًا في CitationMetadata ضمن فئة جديدة باسم Citation. يمكن العثور على الاقتباسات في القائمة التي تحمل الاسم citations في CitationMetadata. يتيح هذا التغيير توافقًا أفضل بين أنواع البيانات على المنصات المختلفة.

• احتساب الرموز المميّزة

  • تم تغيير الحقل totalBillableCharacters ليقبل القيم الخالية.

• إجمالي عدد الأحرف التي تتم فوترتها

  • تم تغيير السمة totalBillableCharacters في CountTokensResponse لتصبح اختيارية من أجل مراعاة الحالات التي لا يتم فيها إرسال أي أحرف.

• إنشاء مثيل من نموذج

  • تم نقل المَعلمة requestOptions إلى نهاية قائمة المَعلمات لتتطابق مع المنصات الأخرى.

• Live API

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

  • تمت إعادة تسمية LiveGenerationConfig.setResponseModalities إلى LiveGenerationConfig.setResponseModality.

  • تمت إزالة الفئة LiveContentResponse.Status، وتم بدلاً من ذلك دمج حقول الحالة كسمات لـ LiveContentResponse.

  • تمت إزالة الفئة LiveContentResponse، وتم توفير فئات فرعية من LiveServerMessage تتطابق مع الردود من النموذج.

  • تم تغيير LiveModelFutures.connect لعرض ListenableFuture<LiveSessionFutures> بدلاً من ListenableFuture<LiveSession>.

Java

• التعدادات

  • تم استبدال فئات "enum" وفئات "sealed" بفئات عادية. يتيح هذا التغيير مزيدًا من المرونة لتطوير واجهة برمجة التطبيقات بطريقة متوافقة مع الإصدارات السابقة.

  • تمت إعادة تسمية التعداد BlockThreshold إلى HarmBlockThreshold.

  • تمت إزالة القيم من التعدادات التالية: HarmBlockThreshold وHarmProbability وHarmSeverity وBlockReason وFinishReason.

• طُرق Blob

  • تمت إعادة تسمية جميع الطرق التي تتضمّن Blob كجزء من اسمها لاستخدام InlineData بدلاً من ذلك.

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

  • تم تغيير الحقل method ليصبح قابلاً للإلغاء.

• فئة المدة

  • تمت إزالة جميع استخدامات فئة Duration في Kotlin، واستبدالها بـ long. يوفّر هذا التغيير إمكانية تشغيل متبادل أفضل مع Java.

• البيانات الوصفية لمعلومات المقالة

  • تم تضمين جميع الحقول التي تم تعريفها سابقًا في CitationMetadata ضمن فئة جديدة باسم Citation. يمكن العثور على الاقتباسات في القائمة التي تحمل الاسم citations في CitationMetadata. يتيح هذا التغيير توافقًا أفضل بين أنواع البيانات على المنصات المختلفة.

• احتساب الرموز المميّزة

  • تم تغيير الحقل totalBillableCharacters ليقبل القيم الخالية.

• إجمالي عدد الأحرف التي تتم فوترتها

  • تم تغيير السمة totalBillableCharacters في CountTokensResponse لتصبح اختيارية من أجل مراعاة الحالات التي لا يتم فيها إرسال أي أحرف.

• إنشاء مثيل من نموذج

  • تم نقل المَعلمة requestOptions إلى نهاية قائمة المَعلمات لتتطابق مع المنصات الأخرى.

• Live API

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

  • تمت إعادة تسمية LiveGenerationConfig.setResponseModalities إلى LiveGenerationConfig.setResponseModality.

  • تمت إزالة الفئة LiveContentResponse.Status، وتم بدلاً من ذلك دمج حقول الحالة كسمات لـ LiveContentResponse.

  • تمت إزالة الفئة LiveContentResponse، وتم توفير فئات فرعية من LiveServerMessage تتطابق مع الردود من النموذج.

  • تم تغيير LiveModelFutures.connect لإرجاع ListenableFuture<LiveSessionFutures> بدلاً من ListenableFuture<LiveSession>.

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

Web

• التعدادات

  • تمت إزالة القيم من التعدادات التالية: HarmCategory وBlockThreshold وHarmProbability وHarmSeverity وBlockReason وFinishReason.

• سبب الحظر

  • تم تغيير "blockReason" في "PromptFeedback" ليصبح اختياريًا.

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

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

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

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

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

Dart

• التعدادات

  • تمت إزالة القيم من التعدادات التالية: HarmCategory وHarmProbability وBlockReason وFinishReason.

• Data part

  • تمت إعادة تسمية DataPart إلى InlineDataPart، والدالة static data إلى inlineData لتتوافق مع المنصات الأخرى.

• خيارات الطلب

  • تمت إزالة "RequestOptions" لأنّ "timeout" لم يكن يعمل. ستتم إعادة إضافتها في المستقبل القريب، ولكن سيتم نقلها إلى النوع GenerativeModel لتتطابق مع المنصات الأخرى.

• إيقاف التسلسلات

  • تم تغيير المَعلمة stopSequences في GenerationConfig لتصبح اختيارية وتكون قيمتها التلقائية null بدلاً من مصفوفة فارغة.

• الاقتباسات

  • تمت إعادة تسمية السمة citationSources إلى citations في CitationMetadata. تمت إعادة تسمية النوع CitationSource إلى Citation ليتطابق مع المنصات الأخرى.

• الأنواع والطرق والسمات العامة غير الضرورية

  • أزلنا الأنواع والطرق والسمات التالية التي تم عرضها عن غير قصد: defaultTimeout وCountTokensResponseFields وparseCountTokensResponse وparseEmbedContentResponse وparseGenerateContentResponse وparseContent وBatchEmbedContentsResponse وContentEmbedding وEmbedContentRequest وEmbedContentResponse.

• احتساب الرموز المميزة

  • تمت إزالة الحقول الإضافية من دالة countTokens التي لم تعد ضرورية. يجب توفير contents فقط.

• إنشاء مثيل من نموذج

  • تم نقل المَعلمة systemInstruction إلى نهاية قائمة المَعلمات للتوافق مع المنصات الأخرى.

• وظيفة التضمين

  • تمت إزالة وظيفة التضمين غير المتوافقة (embedContent وbatchEmbedContents) من النموذج.

Unity

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

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