الانتقال إلى حِزم تطوير البرامج (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 لمنصّة JavaScript على الويب باستخدام 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. عدِّل ملف 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 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.

• جزء البيانات

  • تمت إعادة تسمية 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