بدء استخدام Gemini API باستخدام حِزم تطوير البرامج (SDK) الخاصة بمنطق الذكاء الاصطناعي من Firebase

يوضّح لك هذا الدليل كيفية البدء في إجراء طلبات إلى Gemini API مباشرةً من تطبيقك باستخدام حِزم تطوير البرامج (SDK) الخاصة ببرنامج Firebase AI Logic على النظام الأساسي الذي اخترته.

المتطلبات الأساسية

Swift

يفترض هذا الدليل أنّك على دراية باستخدام Xcode لتطوير تطبيقات لمنصات Apple (مثل iOS).

تأكَّد من أنّ بيئة التطوير وتطبيق منصات Apple يستوفيان المتطلبات التالية:

  • الإصدار 26.2 من Xcode أو إصدار أحدث
  • يستهدف تطبيقك الإصدار iOS 15 أو إصدارًا أحدث، أو الإصدار macOS 12 أو إصدارًا أحدث

Kotlin

يفترض هذا الدليل أنّك على دراية بكيفية استخدام "استوديو Android" لتطوير تطبيقات Android.

يجب التأكّد من أنّ بيئة التطوير وتطبيق Android يستوفيان المتطلبات التالية:

  • "استوديو Android" (أحدث إصدار)
  • يستهدف تطبيقك المستوى 21 من واجهة برمجة التطبيقات أو المستويات الأحدث

Java

يفترض هذا الدليل أنّك على دراية بكيفية استخدام "استوديو Android" لتطوير تطبيقات Android.

يجب التأكّد من أنّ بيئة التطوير وتطبيق Android يستوفيان المتطلبات التالية:

  • "استوديو Android" (أحدث إصدار)
  • يستهدف تطبيقك المستوى 21 من واجهة برمجة التطبيقات أو المستويات الأحدث

Web

يفترض هذا الدليل أنّك على دراية باستخدام JavaScript لتطوير تطبيقات الويب. هذا الدليل مستقل عن أي إطار عمل.

يجب التأكّد من أنّ بيئة التطوير وتطبيق الويب يستوفيان المتطلبات التالية:

  • (اختياري) Node.js
  • متصفّح ويب حديث

Dart

يفترض هذا الدليل أنّك على دراية بتطوير التطبيقات باستخدام Flutter.

تأكَّد من أنّ بيئة التطوير وتطبيق Flutter يستوفيان المتطلبات التالية:

  • ‫Dart 3.2.0 أو إصدار أحدث

Unity

يفترض هذا الدليل أنّك على دراية بتطوير الألعاب باستخدام Unity.

يجب التأكّد من أنّ بيئة التطوير ولعبة Unity تستوفيان المتطلبات التالية:

  • Unity Editor 2021 LTS أو الإصدارات الأحدث

الاطّلاع على مَراجع مفيدة

Swift

تجربة تطبيق البدء السريع

استخدِم تطبيق التشغيل السريع لتجربة حزمة SDK بسرعة والاطّلاع على عملية تنفيذ كاملة لمختلف حالات الاستخدام. يمكنك أيضًا استخدام تطبيق التشغيل السريع إذا لم يكن لديك تطبيق خاص بمنصات Apple. لاستخدام تطبيق التشغيل السريع، عليك ربطه بمشروع على Firebase.

الانتقال إلى تطبيق "البدء السريع"

مشاهدة فيديو تعليمي

يوضّح هذا الفيديو كيفية بدء استخدام Firebase AI Logic من خلال إنشاء تطبيق واقعي لتخطيط الوجبات يستند إلى الذكاء الاصطناعي وينشئ وصفات من طلب نصي.

يمكنك أيضًا تنزيل قاعدة الرموز للتطبيق في الفيديو واستكشافها.

عرض قاعدة الرموز البرمجية لتطبيق الفيديو



Kotlin

تجربة تطبيق البدء السريع

استخدِم تطبيق التشغيل السريع لتجربة حزمة SDK بسرعة والاطّلاع على عملية تنفيذ كاملة لمختلف حالات الاستخدام. يمكنك أيضًا استخدام تطبيق التشغيل السريع إذا لم يكن لديك تطبيق Android خاص بك. لاستخدام تطبيق التشغيل السريع، عليك ربطه بمشروع على Firebase.

الانتقال إلى تطبيق "البدء السريع"

مشاهدة فيديو تعليمي

يوضّح هذا الفيديو كيفية بدء استخدام Firebase AI Logic من خلال إنشاء تطبيق واقعي لتخطيط الوجبات يستند إلى الذكاء الاصطناعي وينشئ وصفات من طلب نصي.

يمكنك أيضًا تنزيل قاعدة الرموز للتطبيق في الفيديو واستكشافها.

عرض قاعدة الرموز البرمجية لتطبيق الفيديو



Java

تجربة تطبيق البدء السريع

استخدِم تطبيق التشغيل السريع لتجربة حزمة SDK بسرعة والاطّلاع على عملية تنفيذ كاملة لمختلف حالات الاستخدام. يمكنك أيضًا استخدام تطبيق التشغيل السريع إذا لم يكن لديك تطبيق Android خاص بك. لاستخدام تطبيق التشغيل السريع، عليك ربطه بمشروع على Firebase.

الانتقال إلى تطبيق "البدء السريع"

مشاهدة فيديو تعليمي

يوضّح هذا الفيديو كيفية البدء باستخدام Firebase AI Logic من خلال إنشاء تطبيق حقيقي لتخطيط الوجبات يستند إلى الذكاء الاصطناعي وينشئ وصفات من طلب نصي.*

يمكنك أيضًا تنزيل قاعدة الرموز للتطبيق في الفيديو واستكشافها.

عرض قاعدة الرموز البرمجية لتطبيق الفيديو

* هذا الفيديو والتطبيق المرفق به مكتوبان بلغة Kotlin، ولكن يمكنهما مساعدة مطوّري Java في فهم الأساسيات حول كيفية بدء استخدام Firebase AI Logic.

Web

تجربة تطبيق البدء السريع

استخدِم تطبيق التشغيل السريع لتجربة حزمة SDK بسرعة والاطّلاع على عملية تنفيذ كاملة لمختلف حالات الاستخدام. يمكنك أيضًا استخدام تطبيق التشغيل السريع إذا لم يكن لديك تطبيق ويب خاص بك. لاستخدام تطبيق التشغيل السريع، عليك ربطه بمشروع على Firebase.

الانتقال إلى تطبيق "البدء السريع"

Dart

تجربة تطبيق البدء السريع

استخدِم تطبيق التشغيل السريع لتجربة حزمة SDK بسرعة والاطّلاع على عملية تنفيذ كاملة لمختلف حالات الاستخدام. يمكنك أيضًا استخدام تطبيق التشغيل السريع إذا لم يكن لديك تطبيق Flutter. لاستخدام تطبيق التشغيل السريع، عليك ربطه بمشروع على Firebase.

الانتقال إلى تطبيق "البدء السريع"

مشاهدة فيديو تعليمي

يوضّح هذا الفيديو كيفية بدء استخدام Firebase AI Logic من خلال إنشاء تطبيق واقعي لتخطيط الوجبات يستند إلى الذكاء الاصطناعي وينشئ وصفات من طلب نصي.

يمكنك أيضًا تنزيل قاعدة الرموز للتطبيق في الفيديو واستكشافها.

عرض قاعدة الرموز البرمجية لتطبيق الفيديو



Unity

تجربة تطبيق البدء السريع

استخدِم تطبيق التشغيل السريع لتجربة حزمة SDK بسرعة والاطّلاع على عملية تنفيذ كاملة لمختلف حالات الاستخدام. أو يمكنك استخدام تطبيق Quickstart إذا لم تكن لديك لعبة Unity. لاستخدام تطبيق التشغيل السريع، عليك ربطه بمشروع Firebase.

الانتقال إلى تطبيق "البدء السريع"

الخطوة 1: إعداد مشروع على Firebase وتفعيل واجهات برمجة التطبيقات

  1. سجِّل الدخول إلى Firebase وحدة التحكّم، ثم اختَر مشروعك على Firebase.

  2. في وحدة تحكّم Firebase، انتقِل إلى خدمات الذكاء الاصطناعي > منطق الذكاء الاصطناعي.

  3. انقر على Get started (البدء) لتشغيل سير عمل موجّه يساعدك في إعداد واجهات برمجة التطبيقات المطلوبة والموارد لمشروعك.

  4. إذا طُلب منك ذلك، اتّبِع التعليمات الظاهرة على الشاشة لتسجيل تطبيقك وإضافة إعدادات Firebase إليه.

  5. عندما يُطلب منك اختيار "مقدّم خدمة Gemini API"، ننصحك باختيار Gemini Developer API، ما يتيح لك البدء بسرعة بدون أي تكلفة.

    في أي وقت لاحق، يمكنك إعداد Vertex AI Gemini API (ومتطلباته المتعلقة بالفوترة).

  6. واصِل العمل في سير العمل لإعداد واجهات برمجة التطبيقات والخدمات المرتبطة المطلوبة لتطبيق Firebase AI Logic.

    اعتبارًا من أوائل يوليو 2026، ستفرض هذه المرحلة من سير العمل تلقائيًا استخدام Firebase App Check مع AI Logic، وهي خدمة مهمة تساعد في حماية Gemini API عند الوصول إليه مباشرةً من تطبيقك. وكجزء من خطوات البدء (راجِع الخطوات لاحقًا في هذا الدليل)، عليك ضبط App Check موفر تصحيح الأخطاء لتطوير التطبيق محليًا عند فرض استخدام App Check.

  7. انتقِل إلى الخطوة التالية في هذا الدليل لإضافة حِزم SDK المطلوبة إلى تطبيقك.

الخطوة 2: إضافة حِزم تطوير البرامج (SDK) المطلوبة

بعد إعداد مشروعك على Firebase وتفعيل واجهات برمجة التطبيقات المطلوبة (راجِع الخطوة السابقة)، يمكنك الآن إضافة حِزم تطوير البرامج المطلوبة إلى تطبيقك.

Swift

استخدِم Swift Package Manager لتثبيت ملحقات Firebase وإدارتها. يمكنك الاطّلاع على خيارات التثبيت الأخرى إذا لزم الأمر.

تتيح مكتبة Firebase AI Logic الوصول إلى واجهات برمجة التطبيقات للتفاعل مع نماذج Gemini. يتم تضمين المكتبة كجزء من حزمة تطوير البرامج (SDK) لمنصات Apple في Firebase (firebase-ios-sdk).

إذا كنت تستخدم Firebase حاليًا، تأكَّد من أنّ حزمة Firebase هي الإصدار 12.5.0 أو إصدار أحدث.

  1. في Xcode، بعد فتح مشروع تطبيقك، انتقِل إلى ملف > إضافة موارد الاعتمادية للحزمة (File > Add Package Dependencies).

  2. عندما يُطلب منك ذلك، أضِف مستودع حزمة تطوير البرامج (SDK) لمنصة Firebase Apple:

    https://github.com/firebase/firebase-ios-sdk

  3. اختَر أحدث إصدار من حزمة SDK.

  4. اختَر مكتبة FirebaseAILogic ومكتبة FirebaseAppCheck.

عند الانتهاء، سيبدأ Xcode تلقائيًا في حلّ التبعيات وتنزيلها في الخلفية.

Kotlin

توفّر حزمة تطوير البرامج (SDK) لنظام التشغيل Android (firebase-ai) إمكانية الوصول إلى واجهات برمجة التطبيقات للتفاعل مع نماذج Gemini.Firebase AI Logic

في ملف Gradle الخاص بالوحدة (على مستوى التطبيق) (مثل <project>/<app-module>/build.gradle.kts)، أضِف الاعتمادات الخاصة بمكتبتَي Firebase AI Logic وApp Check لنظام التشغيل Android. ننصحك باستخدام Firebase Android BoM للتحكّم في إصدارات المكتبة.

dependencies {
  // ... other androidx dependencies

  // Import the BoM for the Firebase platform
  implementation(platform("com.google.firebase:firebase-bom:34.15.0"))

  // Add the dependencies for the Firebase AI Logic and App Check libraries
  // When using the BoM, you don't specify versions in Firebase library dependencies
  implementation("com.google.firebase:firebase-ai")
  implementation("com.google.firebase:firebase-appcheck-debug")
}

باستخدام Firebase Android BoM، سيستخدم تطبيقك دائمًا إصدارات متوافقة من مكتبات Firebase Android.

Java

توفّر حزمة تطوير البرامج (SDK) لنظام التشغيل Android (firebase-ai) إمكانية الوصول إلى واجهات برمجة التطبيقات للتفاعل مع نماذج Gemini.Firebase AI Logic

في ملف Gradle الخاص بالوحدة (على مستوى التطبيق) (مثل <project>/<app-module>/build.gradle.kts)، أضِف الاعتمادات الخاصة بمكتبتَي Firebase AI Logic وApp Check لنظام التشغيل Android. ننصحك باستخدام Firebase Android BoM للتحكّم في إصدارات المكتبة.

بالنسبة إلى Java، عليك إضافة مكتبتَين إضافيتَين.

dependencies {
  // ... other androidx dependencies

  // Import the BoM for the Firebase platform
  implementation(platform("com.google.firebase:firebase-bom:34.15.0"))

  // Add the dependencies for the Firebase AI Logic and App Check libraries
  // When using the BoM, you don't specify versions in Firebase library dependencies
  implementation("com.google.firebase:firebase-ai")
  implementation("com.google.firebase:firebase-appcheck-debug")

  // Required for one-shot operations (to use `ListenableFuture` from Guava Android)
  implementation("com.google.guava:guava:31.0.1-android")

  // Required for streaming operations (to use `Publisher` from Reactive Streams)
  implementation("org.reactivestreams:reactive-streams:1.0.4")
}

باستخدام Firebase Android BoM، سيستخدم تطبيقك دائمًا إصدارات متوافقة من مكتبات Firebase Android.

Web

تتيح مكتبة Firebase AI Logic الوصول إلى واجهات برمجة التطبيقات للتفاعل مع نماذج Gemini. يتم تضمين المكتبة كجزء من حزمة تطوير البرامج (SDK) على JavaScript لبرنامج Firebase على الويب.

  1. ثبِّت حزمة تطوير البرامج (SDK) على الإنترنت من Firebase JS باستخدام npm:

    npm install firebase

  2. إعداد Firebase في تطبيقك:

    import { initializeApp } from "firebase/app";
import { initializeAppCheck, DebugProvider } from "firebase/app-check";

// 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);

Dart

توفّر إضافة Firebase AI Logic في Flutter (firebase_ai) إمكانية الوصول إلى واجهات برمجة التطبيقات للتفاعل مع نماذج Gemini.

  1. من دليل مشروع Flutter، شغِّل الأمر التالي لتثبيت المكوّنين الإضافيين Firebase AI Logic وApp Check:

    flutter pub add firebase_ai firebase_app_check

  2. في ملف lib/main.dart، استورِد المكوّنين الإضافيَين Firebase AI Logic وApp Check:

    import 'package:firebase_core/firebase_core.dart';
import 'package:firebase_ai/firebase_ai.dart';
import 'package:firebase_app_check/firebase_app_check.dart';
import 'firebase_options.dart';

  3. في ملف lib/main.dart أيضًا، تأكَّد من أنّك قد بدأت Firebase باستخدام عنصر DefaultFirebaseOptions الذي تم تصديره من خلال ملف الإعداد:

    await Firebase.initializeApp(
  options: DefaultFirebaseOptions.currentPlatform,
);

  4. أعِد إنشاء تطبيق Flutter:

    flutter run

Unity

  1. نزِّل حزمة تطوير البرامج (SDK) Firebase Unity، ثم استخرِجها في مكان مناسب.

    حزمة تطوير البرامج (SDK) الخاصة بـ Firebase Unity ليست خاصة بنظام أساسي معيّن.

  2. في مشروع Unity المفتوح، انتقِل إلى Assets (الأصول) > Import Package (استيراد حزمة) > Custom Package (حزمة مخصّصة).

  3. من حزمة تطوير البرامج (SDK) التي تم استخراجها، اختَر الحزمتَين FirebaseAI وFirebaseAppCheck.

  4. في نافذة استيراد حزمة Unity، انقر على استيراد.

الخطوة 3: ضبط موفّر تصحيح الأخطاء App Check للتطوير المحلي

اعتبارًا من أوائل يوليو 2026، وفي إطار سير عمل الإعداد الموجّه لميزة AI Logic في Play Console، سيتم فرض استخدام Firebase App Check تلقائيًا لحماية Gemini API. للتطوير على الجهاز، عليك ضبط App Check موفّر تصحيح الأخطاء لتجاوز عملية التصديق مع الحفاظ على فرض App Check.

Swift

في ما يلي كيفية استخدام موفّر تصحيح الأخطاء أثناء تشغيل تطبيقك في محاكي بشكل تفاعلي (على سبيل المثال، أثناء التطوير المحلي):

  1. في مشروع Xcode، استورِد FirebaseAppCheck وأعِد ضبط App Check باستخدام أداة إنشاء موفّر تصحيح الأخطاء قبل ضبط Firebase.

    import SwiftUI
import FirebaseCore
import FirebaseAppCheck

@main
struct YourApp: App {
  init() {
    let providerFactory = AppCheckDebugProviderFactory()
    AppCheck.setAppCheckProviderFactory(providerFactory)
    FirebaseApp.configure()
  }

  var body: some Scene {
    WindowGroup {
      NavigationView {
        ContentView()
      }
    }
  }
}

  2. احصل على رمز تصحيح الأخطاء باتّباع الخطوات التالية:

    1. شغِّل تطبيقك في المحاكي أو على جهاز الاختبار.

    2. افتح وحدة تحكّم Xcode وابحث عن رمز تصحيح الأخطاء App Check. على سبيل المثال:

      <Warning> [AppCheckCore][I-GAC004001] App Check debug token: '123a4567-b89c-12d3-e456-789012345678'.

    3. انسخ الرمز المميّز (مثلاً، 123a4567-b89c-12d3-e456-789012345678).

  3. سجِّل رمز تصحيح الأخطاء في App Check باتّباع الخطوات التالية:

    1. في Firebase، انتقِل إلى علامة التبويب الأمان > App Check > التطبيقات.

    2. ابحث عن تطبيقك، وانقر على قائمة الخيارات الإضافية ()، ثم اختَر إدارة رموز تصحيح الأخطاء.

    3. اتّبِع التعليمات الظاهرة على الشاشة لتسجيل رمز تصحيح الأخطاء.

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

Kotlin

في ما يلي كيفية استخدام موفّر تصحيح الأخطاء أثناء تشغيل تطبيقك في محاكي بشكل تفاعلي (على سبيل المثال، أثناء التطوير المحلي):

  1. في إصدار التصحيح، اضبط App Check لاستخدام مصنع موفّر التصحيح:

    Firebase.initialize(context = this)
Firebase.appCheck.installAppCheckProviderFactory(
    DebugAppCheckProviderFactory.getInstance(),
)

  2. احصل على رمز تصحيح الأخطاء باتّباع الخطوات التالية:

    1. شغِّل تطبيقك في المحاكي أو على جهاز الاختبار.

    2. ابحث عن رمز تصحيح الأخطاء App Check في سجلاتك. على سبيل المثال:

      D DebugAppCheckProvider: Enter this debug secret into the allow list
in the Firebase Console for your project: 123a4567-b89c-12d3-e456-789012345678

    3. انسخ الرمز المميّز (مثلاً، 123a4567-b89c-12d3-e456-789012345678).

  3. سجِّل رمز تصحيح الأخطاء في App Check باتّباع الخطوات التالية:

    1. في Firebase، انتقِل إلى علامة التبويب الأمان > App Check > التطبيقات.

    2. ابحث عن تطبيقك، وانقر على قائمة الخيارات الإضافية ()، ثم اختَر إدارة رموز تصحيح الأخطاء.

    3. اتّبِع التعليمات الظاهرة على الشاشة لتسجيل رمز تصحيح الأخطاء.

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

Java

في ما يلي كيفية استخدام موفّر تصحيح الأخطاء أثناء تشغيل تطبيقك في محاكي بشكل تفاعلي (على سبيل المثال، أثناء التطوير المحلي):

  1. في إصدار التصحيح، اضبط App Check لاستخدام مصنع موفّر التصحيح:

    FirebaseApp.initializeApp(/*context=*/ this);
FirebaseAppCheck firebaseAppCheck = FirebaseAppCheck.getInstance();
firebaseAppCheck.installAppCheckProviderFactory(
        DebugAppCheckProviderFactory.getInstance());

  2. احصل على رمز تصحيح الأخطاء باتّباع الخطوات التالية:

    1. شغِّل تطبيقك في المحاكي أو على جهاز الاختبار.

    2. ابحث عن رمز تصحيح الأخطاء App Check في سجلاتك. على سبيل المثال:

      D DebugAppCheckProvider: Enter this debug secret into the allow list
in the Firebase Console for your project: 123a4567-b89c-12d3-e456-789012345678

    3. انسخ الرمز المميّز (مثلاً، 123a4567-b89c-12d3-e456-789012345678).

  3. سجِّل رمز تصحيح الأخطاء في App Check باتّباع الخطوات التالية:

    1. في Firebase، انتقِل إلى علامة التبويب الأمان > App Check > التطبيقات.

    2. ابحث عن تطبيقك، وانقر على قائمة الخيارات الإضافية ()، ثم اختَر إدارة رموز تصحيح الأخطاء.

    3. اتّبِع التعليمات الظاهرة على الشاشة لتسجيل رمز تصحيح الأخطاء.

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

Web

في ما يلي كيفية استخدام موفّر تصحيح الأخطاء أثناء تشغيل تطبيقك من localhost بشكل تفاعلي (على سبيل المثال، أثناء التطوير المحلي):

  1. في إصدار تصحيح الأخطاء، فعِّل وضع تصحيح الأخطاء من خلال ضبط self.FIREBASE_APPCHECK_DEBUG_TOKEN على true قبل بدء App Check. على سبيل المثال:

    self.FIREBASE_APPCHECK_DEBUG_TOKEN = true;
initializeAppCheck(app, { /* App Check options */ });

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

    AppCheck debug token: "123a4567-b89c-12d3-e456-789012345678".
You will need to safelist it in the Firebase console for it to work.

  3. سجِّل رمز تصحيح الأخطاء في App Check باتّباع الخطوات التالية:

    1. في Firebase، انتقِل إلى علامة التبويب الأمان > App Check > التطبيقات.

    2. ابحث عن تطبيقك، وانقر على قائمة الخيارات الإضافية ()، ثم اختَر إدارة رموز تصحيح الأخطاء.

    3. اتّبِع التعليمات الظاهرة على الشاشة لتسجيل رمز تصحيح الأخطاء.

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

Dart

iOS+‎

في ما يلي كيفية استخدام موفّر تصحيح الأخطاء أثناء تشغيل تطبيقك في محاكي بشكل تفاعلي (على سبيل المثال، أثناء التطوير المحلي):

  1. فعِّل App Check باستخدام موفّر تصحيح الأخطاء مباشرةً بعد تهيئة تطبيق Firebase:

    import 'package:flutter/material.dart';
import 'package:firebase_core/firebase_core.dart';

// Import the firebase_app_check plugin
import 'package:firebase_app_check/firebase_app_check.dart';

Future<void> main() async {
  WidgetsFlutterBinding.ensureInitialized();
  await Firebase.initializeApp();
  await FirebaseAppCheck.instance.activate(
    // Set appleProvider to `AppleProvider.debug`
    appleProvider: AppleProvider.debug,
  );
  runApp(App());
}

  2. فعِّل تسجيل معلومات تصحيح الأخطاء في مشروع Xcode باتّباع الخطوات التالية:

    1. افتح المنتج (Product) > المخطّط (Scheme) > تعديل المخطّط (Edit scheme).
    2. انقر على تشغيل (Run) من القائمة اليمنى، ثم انقر على علامة التبويب الوسيطات (Arguments).
    3. في قسم المَعلمات التي تم ضبطها عند الإطلاق (Arguments Passed on Launch)، أضِف -FIRDebugEnabled.

  3. احصل على رمز تصحيح الأخطاء باتّباع الخطوات التالية:

    1. افتح ios/Runner.xcworkspace باستخدام Xcode وشغِّل تطبيقك في المحاكي أو على جهاز الاختبار.

    2. افتح وحدة تحكّم Xcode وابحث عن رمز تصحيح الأخطاء App Check. على سبيل المثال:

      <Warning> [AppCheckCore][I-GAC004001] App Check debug token: '123a4567-b89c-12d3-e456-789012345678'.

    3. انسخ الرمز المميّز (مثلاً، 123a4567-b89c-12d3-e456-789012345678).

  4. سجِّل رمز تصحيح الأخطاء في App Check باتّباع الخطوات التالية:

    1. في Firebase، انتقِل إلى علامة التبويب الأمان > App Check > التطبيقات.

    2. ابحث عن تطبيقك، وانقر على قائمة الخيارات الإضافية ()، ثم اختَر إدارة رموز تصحيح الأخطاء.

    3. اتّبِع التعليمات الظاهرة على الشاشة لتسجيل رمز تصحيح الأخطاء.

Android

في ما يلي كيفية استخدام موفّر تصحيح الأخطاء أثناء تشغيل تطبيقك في محاكي بشكل تفاعلي (على سبيل المثال، أثناء التطوير المحلي):

  1. فعِّل App Check باستخدام موفّر تصحيح الأخطاء مباشرةً بعد تهيئة تطبيق Firebase:

    import 'package:flutter/material.dart';
import 'package:firebase_core/firebase_core.dart';

// Import the firebase_app_check plugin
import 'package:firebase_app_check/firebase_app_check.dart';

Future<void> main() async {
  WidgetsFlutterBinding.ensureInitialized();
  await Firebase.initializeApp();
  await FirebaseAppCheck.instance.activate(
    // Set androidProvider to `AndroidProvider.debug`
    androidProvider: AndroidProvider.debug,
  );
  runApp(App());
}

  2. احصل على رمز تصحيح الأخطاء باتّباع الخطوات التالية:

    1. شغِّل تطبيقك في المحاكي أو على جهاز الاختبار.

    2. ابحث عن رمز تصحيح الأخطاء App Check في سجلاتك. على سبيل المثال:

      D DebugAppCheckProvider: Enter this debug secret into the allow list
in the Firebase Console for your project: 123a4567-b89c-12d3-e456-789012345678

    3. انسخ الرمز المميّز (مثلاً، 123a4567-b89c-12d3-e456-789012345678).

  3. سجِّل رمز تصحيح الأخطاء في App Check باتّباع الخطوات التالية:

    1. في Firebase، انتقِل إلى علامة التبويب الأمان > App Check > التطبيقات.

    2. ابحث عن تطبيقك، وانقر على قائمة الخيارات الإضافية ()، ثم اختَر إدارة رموز تصحيح الأخطاء.

    3. اتّبِع التعليمات الظاهرة على الشاشة لتسجيل رمز تصحيح الأخطاء.

الويب

في ما يلي كيفية استخدام موفّر تصحيح الأخطاء أثناء تشغيل تطبيقك من localhost بشكل تفاعلي (على سبيل المثال، أثناء التطوير المحلي):

  1. في الملف web/index.html، فعِّل وضع تصحيح الأخطاء من خلال ضبط self.FIREBASE_APPCHECK_DEBUG_TOKEN على true:

    <body>
  <script>
    self.FIREBASE_APPCHECK_DEBUG_TOKEN = true;
  </script>

  ...

</body>

  2. شغِّل تطبيق الويب على جهازك وافتح أدوات المطوّرين في المتصفّح. في وحدة تصحيح الأخطاء، سيظهر رمز تصحيح الأخطاء:

    AppCheck debug token: "123a4567-b89c-12d3-e456-789012345678".
You will need to safelist it in the Firebase console for it to work.

    يتم تخزين هذا الرمز المميز محليًا في متصفحك وسيتم استخدامه كلما استخدمت تطبيقك في المتصفح نفسه على الجهاز نفسه. إذا أردت استخدام الرمز المميّز في متصفّح آخر أو على جهاز آخر، اضبط قيمة self.FIREBASE_APPCHECK_DEBUG_TOKEN على سلسلة الرمز المميّز بدلاً من true.

  3. سجِّل رمز تصحيح الأخطاء في App Check باتّباع الخطوات التالية:

    1. في Firebase، انتقِل إلى علامة التبويب الأمان > App Check > التطبيقات.

    2. ابحث عن تطبيقك، وانقر على قائمة الخيارات الإضافية ()، ثم اختَر إدارة رموز تصحيح الأخطاء.

    3. اتّبِع التعليمات الظاهرة على الشاشة لتسجيل رمز تصحيح الأخطاء.

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

Unity

في ما يلي كيفية استخدام موفّر تصحيح الأخطاء أثناء تشغيل تطبيقك في محاكي بشكل تفاعلي (على سبيل المثال، أثناء التطوير المحلي):

  1. في وحدة تحكّم Firebase، أنشئ رمزًا مميّزًا لتصحيح الأخطاء:

    1. في وحدة تحكّم Firebase، انتقِل إلى علامة التبويب الأمان > App Check > التطبيقات.

    2. ابحث عن تطبيقك، وانقر على قائمة الخيارات الإضافية ()، ثم اختَر إدارة رموز تصحيح الأخطاء.

    3. اتّبِع التعليمات الظاهرة على الشاشة لإنشاء رمز تصحيح أخطاء جديد.

  2. في رمز تهيئة تطبيقك، أضِف ما يلي:

    using Firebase.AppCheck;

void InitializeFirebase() {
  // Configure the Debug Provider factory with your debug token.
  DebugAppCheckProviderFactory.Instance.SetDebugToken("YOUR_DEBUG_TOKEN");

  // Set App Check to use the debug provider factory
  FirebaseAppCheck.SetAppCheckProviderFactory(
    DebugAppCheckProviderFactory.Instance);

  // Proceed to initialize Firebase as normal
}

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

الخطوة 4: تهيئة الخدمة وإنشاء مثيل للنموذج

انقر على موفّر Gemini API لعرض المحتوى والرمز الخاصين بموفّر الخدمة على هذه الصفحة.

قبل إرسال طلب إلى نموذج Gemini، يجب تهيئة الخدمة لموفّر واجهة برمجة التطبيقات الذي اخترته وإنشاء مثيل GenerativeModel.

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.5-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.5-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.5-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.5-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.5-flash');

Unity 


using Firebase;
using Firebase.AI;

// Initialize the Gemini Developer API backend service.
var ai = FirebaseAI.GetInstance(FirebaseAI.Backend.GoogleAI());

// Create a `GenerativeModel` instance with a model that supports your use case.
var model = ai.GetGenerativeModel(modelName: "gemini-3.5-flash");

يُرجى العِلم أنّه استنادًا إلى الميزة التي تستخدمها، قد لا تتمكّن دائمًا من إنشاء GenerativeModel. لإجراء بث للإدخال والإخراج باستخدام Gemini Live API، أنشئ مثيلاً من LiveModel.

بعد الانتهاء من دليل البدء هذا، تعرَّف على كيفية اختيار نموذج لحالة الاستخدام والتطبيق.

الخطوة 5: إرسال طلب إلى نموذج

أنت الآن جاهز لإرسال طلب إلى نموذج Gemini.

يمكنك استخدام generateContent() لإنشاء نص من طلب يتضمّن نصًا:

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

// Provide a prompt that contains text
let prompt = "Write a story about a magic backpack."

// To generate text output, call generateContent with the text input
let response = try await model.generateContent(prompt)
print(response.text ?? "No text in response.")

Kotlin

في Kotlin، تكون الطرق في حزمة تطوير البرامج هذه عبارة عن دوال معلّقة ويجب استدعاؤها من نطاق Coroutine. 

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

// Provide a prompt that contains text
val prompt = "Write a story about a magic backpack."

// To generate text output, call generateContent with the text input
val response = model.generateContent(prompt)
print(response.text)

Java

بالنسبة إلى Java، تعرض الطرق في حزمة تطوير البرامج (SDK) هذه ListenableFuture. 

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

// Use the GenerativeModelFutures Java compatibility layer which offers
// support for ListenableFuture and Publisher APIs
GenerativeModelFutures model = GenerativeModelFutures.from(ai);

// Provide a prompt that contains text
Content prompt = new Content.Builder()
    .addText("Write a story about a magic backpack.")
    .build();

// To generate text output, call generateContent with the text input
ListenableFuture<GenerateContentResponse> response = model.generateContent(prompt);
Futures.addCallback(response, new FutureCallback<GenerateContentResponse>() {
    @Override
    public void onSuccess(GenerateContentResponse result) {
        String resultText = result.getText();
        System.out.println(resultText);
    }

    @Override
    public void onFailure(Throwable t) {
        t.printStackTrace();
    }
}, executor);

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.5-flash" });

// Wrap in an async function so you can use await
async function run() {
  // Provide a prompt that contains text
  const prompt = "Write a story about a magic backpack."

  // To generate text output, call generateContent with the text input
  const result = await model.generateContent(prompt);

  const response = result.response;
  const text = response.text();
  console.log(text);
}

run();

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.5-flash');

// Provide a prompt that contains text
final prompt = [Content.text('Write a story about a magic backpack.')];

// To generate text output, call generateContent with the text input
final response = await model.generateContent(prompt);
print(response.text);

Unity 


using Firebase;
using Firebase.AI;

// Initialize the Gemini Developer API backend service.
var ai = FirebaseAI.GetInstance(FirebaseAI.Backend.GoogleAI());

// Create a `GenerativeModel` instance with a model that supports your use case.
var model = ai.GetGenerativeModel(modelName: "gemini-3.5-flash");

// Provide a prompt that contains text
var prompt = "Write a story about a magic backpack.";

// To generate text output, call GenerateContentAsync with the text input
var response = await model.GenerateContentAsync(prompt);
UnityEngine.Debug.Log(response.Text ?? "No text in response.");

ما هي الإجراءات الأخرى التي يمكنك تنفيذها؟

مزيد من المعلومات عن النماذج المتاحة

يمكنك الاطّلاع على النماذج المتاحة لمختلف حالات الاستخدام والحصص والأسعار الخاصة بها.

تجربة إمكانات أخرى

كيفية التحكّم في إنشاء المحتوى

يمكنك أيضًا تجربة الطلبات وإعدادات النماذج، ويمكنك حتى الحصول على مقتطف رمز برمجي من إنشاء الذكاء الاصطناعي باستخدام Google AI Studio.


تقديم ملاحظات حول تجربتك مع Firebase AI Logic