במדריך הזה מוסבר איך להתחיל לבצע קריאות אל Gemini APIישירות מהאפליקציה באמצעות ערכות ה-SDK של הלקוח Firebase AI Logic עבור הפלטפורמה שבחרתם.
דרישות מוקדמות
Swift
במדריך הזה אנחנו מניחים שאתם יודעים להשתמש ב-Xcode כדי לפתח אפליקציות לפלטפורמות של אפל (כמו iOS).
חשוב לוודא שסביבת הפיתוח והאפליקציה לפלטפורמות של אפל עומדות בדרישות הבאות:
- Xcode מגרסה 26.2 ואילך
- האפליקציה מטרגטת ל-iOS מגרסה 15 ומעלה, או ל-macOS מגרסה 12 ומעלה
Kotlin
במדריך הזה אנחנו יוצאים מנקודת הנחה שאתם יודעים איך להשתמש ב-Android Studio כדי לפתח אפליקציות ל-Android.
צריך לוודא שסביבת הפיתוח ואפליקציית Android עומדות בדרישות הבאות:
- Android Studio (הגרסה העדכנית)
- האפליקציה שלך מטרגטת לרמת API 24 (Nougat) ומעלה
Java
במדריך הזה אנחנו מניחים שאתם יודעים איך להשתמש ב-Android Studio כדי לפתח אפליקציות ל-Android.
צריך לוודא שסביבת הפיתוח ואפליקציית Android עומדות בדרישות הבאות:
- Android Studio (הגרסה העדכנית)
- האפליקציה מטרגטת לרמת API 24 (Nougat) ומעלה
Web
המדריך הזה מניח שאתם יודעים איך להשתמש ב-JavaScript כדי לפתח אפליקציות אינטרנט. המדריך הזה לא תלוי במסגרת מסוימת.
חשוב לוודא שסביבת הפיתוח ואפליקציית האינטרנט עומדות בדרישות הבאות:
- (אופציונלי) Node.js
- דפדפן אינטרנט מודרני
Dart
במדריך הזה אנחנו יוצאים מנקודת הנחה שאתם מכירים את פיתוח האפליקציות באמצעות Flutter.
צריך לוודא שסביבת הפיתוח ואפליקציית Flutter עומדות בדרישות הבאות:
- Dart בגרסה 3.2.0 ומעלה
Unity
במדריך הזה אנחנו יוצאים מנקודת הנחה שאתם מכירים את תהליך הפיתוח של משחקים ב-Unity.
חשוב לוודא שסביבת הפיתוח והמשחק ב-Unity עומדים בדרישות הבאות:
- Unity Editor 2021 LTS ואילך
מקורות מידע שימושיים
Swift
ניסיון של אפליקציית המדריך למתחילים
אתם יכולים להשתמש באפליקציה למתחילים כדי לנסות את ה-SDK במהירות ולראות הטמעה מלאה של תרחישים שונים לדוגמה. אפשר גם להשתמש באפליקציית ההפעלה המהירה אם אין לכם אפליקציה משלכם לפלטפורמות של אפל. כדי להשתמש באפליקציית ההפעלה המהירה, צריך לקשר אותה לפרויקט Firebase.
צפייה בסרטון הדרכה
בסרטון הזה מוסבר איך להתחיל לעבוד עם Firebase AI Logic על ידי פיתוח אפליקציה אמיתית מבוססת-AI לתכנון ארוחות, שיוצרת מתכונים לפי פרומפט טקסטואלי.
אתם יכולים גם להוריד את בסיס הקוד של האפליקציה שבסרטון ולעיין בו.
הצגת בסיס הקוד של האפליקציה בסרטון
Kotlin
התנסות באפליקציה למתחילים
אפשר להשתמש באפליקציית המדריך למתחילים כדי לנסות את ה-SDK במהירות ולראות הטמעה מלאה של תרחישי שימוש שונים. אם אין לכם אפליקציה משלכם ל-Android, אתם יכולים להשתמש באפליקציית ההפעלה המהירה. כדי להשתמש באפליקציית ההפעלה המהירה, תצטרכו לקשר אותה לפרויקט Firebase.
צפייה בסרטון הדרכה
בסרטון הזה מוסבר איך להתחיל לעבוד עם Firebase AI Logic על ידי פיתוח אפליקציה אמיתית מבוססת-AI לתכנון ארוחות, שיוצרת מתכונים לפי פרומפט טקסטואלי.
אתם יכולים גם להוריד את בסיס הקוד של האפליקציה שבסרטון ולעיין בו.
הצגת בסיס הקוד של האפליקציה בסרטון
Java
התנסות באפליקציה למתחילים
אפשר להשתמש באפליקציית המדריך למתחילים כדי לנסות את ה-SDK במהירות ולראות הטמעה מלאה של תרחישי שימוש שונים. אם אין לכם אפליקציה משלכם ל-Android, אתם יכולים להשתמש באפליקציית ההפעלה המהירה. כדי להשתמש באפליקציית ההפעלה המהירה, תצטרכו לקשר אותה לפרויקט Firebase.
לצפייה בסרטון הדרכה
בסרטון הזה מוסבר איך להתחיל לעבוד עם Firebase AI Logic על ידי פיתוח אפליקציה אמיתית לתכנון ארוחות שמבוססת-AI ויוצרת מתכונים לפי פרומפט טקסטואלי.*
אפשר גם להוריד את בסיס הקוד של האפליקציה שמוצגת בסרטון ולעיין בו.
צפייה בבסיס הקוד של האפליקציה של הסרטון
* הסרטון הזה והאפליקציה שמוצגת בו הם ב-Kotlin, אבל הם עדיין יכולים לעזור למפתחים ב-Java להבין את העקרונות הבסיסיים של תחילת העבודה עם Firebase AI Logic.
Web
התנסות באפליקציה למתחילים
אפשר להשתמש באפליקציית המדריך למתחילים כדי לנסות את ה-SDK במהירות ולראות הטמעה מלאה של תרחישי שימוש שונים. אפשר גם להשתמש באפליקציית ההפעלה המהירה אם אין לכם אפליקציית אינטרנט משלכם. כדי להשתמש באפליקציית ההפעלה המהירה, צריך לקשר אותה לפרויקט Firebase.
Dart
ניסיון של אפליקציית המדריך למתחילים
אתם יכולים להשתמש באפליקציה למתחילים כדי לנסות את ה-SDK במהירות ולראות הטמעה מלאה של תרחישים שונים לדוגמה. אפשר גם להשתמש באפליקציית ההפעלה המהירה אם אין לכם אפליקציית Flutter משלכם. כדי להשתמש באפליקציית ההפעלה המהירה, צריך לקשר אותה לפרויקט Firebase.
צפייה בסרטון הדרכה
בסרטון הזה מוסבר איך להתחיל לעבוד עם Firebase AI Logic על ידי פיתוח אפליקציה אמיתית מבוססת-AI לתכנון ארוחות, שיוצרת מתכונים לפי פרומפט טקסטואלי.
אפשר גם להוריד את בסיס הקוד של האפליקציה שמוצגת בסרטון ולעיין בו.
צפייה בבסיס הקוד של האפליקציה של הסרטון
Unity
ניסיון של אפליקציית המדריך למתחילים
אתם יכולים להשתמש באפליקציה למתחילים כדי לנסות את ה-SDK במהירות ולראות הטמעה מלאה של תרחישים שונים לדוגמה. או משתמשים באפליקציית ההפעלה המהירה אם אין לכם משחק Unity משלכם. כדי להשתמש באפליקציית ההפעלה המהירה, צריך לקשר אותה לפרויקט Firebase.
שלב 1: מגדירים פרויקט ב-Firebase ומפעילים ממשקי API
נכנסים למסוף Firebase ובוחרים את הפרויקט ב-Firebase.
במסוף Firebase, נכנסים אל AI Services (שירותי AI) > AI Logic (לוגיקת AI).
לוחצים על Get started (תחילת העבודה) כדי להפעיל תהליך עבודה מודרך שיעזור לכם להגדיר את ממשקי ה-API והמשאבים הנדרשים לפרויקט.
אם מוצגת בקשה, פועלים לפי ההוראות במסך כדי לרשום את האפליקציה ולהוסיף לה את הגדרות Firebase.
כשמתבקשים לבחור "ספק Gemini API", מומלץ לבחור באפשרות Gemini Developer API, שמאפשרת להתחיל במהירות ובחינם.
בכל שלב בהמשך, תמיד תוכלו להגדיר את Agent Platform Gemini API (formerly Vertex AI) (ואת הדרישה שלו לחיוב).
ממשיכים בתהליך העבודה כדי להגדיר את ממשקי ה-API הנדרשים ואת השירותים המשויכים ל-Firebase AI Logic.
החל מתחילת יולי 2026, בשלב הזה של תהליך העבודה, תופעל Firebase App Check באופן אוטומטי עבור AI Logic, שהוא שירות חיוני שעוזר להגן על Gemini API כשניגשים אליו ישירות מהאפליקציה. כדי להתחיל (ראו את השלבים בהמשך המדריך), תצטרכו להגדיר את App Check ספק ניפוי הבאגים לפיתוח מקומי כשApp Check מופעל.
כדי להוסיף את ערכות ה-SDK הנדרשות לאפליקציה, צריך להמשיך לשלב הבא במדריך הזה.
שלב 2: הוספת ערכות ה-SDK הנדרשות
אחרי שמגדירים את הפרויקט ב-Firebase ומפעילים את ממשקי ה-API הנדרשים (כמו שמוסבר בשלב הקודם), אפשר להוסיף לאפליקציה את ערכות ה-SDK הנדרשות.
Swift
משתמשים ב-Swift Package Manager כדי להתקין ולנהל את יחסי התלות של Firebase. במקרה הצורך, אפשר לעיין באפשרויות התקנה אחרות.
הספרייה Firebase AI Logic מספקת גישה לממשקי ה-API לאינטראקציה עם מודלים של Gemini. הספרייה כלולה כחלק מ-Firebase SDK לפלטפורמות של אפל (firebase-ios-sdk).
אם אתם כבר משתמשים ב-Firebase, ודאו שחבילת Firebase היא מגרסה 12.5.0 ואילך.
ב-Xcode, כשהפרויקט של האפליקציה פתוח, עוברים אל File > Add Package Dependencies (קובץ > הוספת תלות בחבילה).
כשמוצגת בקשה, מוסיפים את מאגר ה-SDK של Firebase לפלטפורמות של אפל:
https://github.com/firebase/firebase-ios-sdkבוחרים את גרסת ה-SDK העדכנית ביותר.
בוחרים בספרייה
FirebaseAILogicובספרייהFirebaseAppCheck.
אחרי שתסיימו, פלטפורמת Xcode תתחיל לטפל ביחסי התלות ולהוריד אותם ברקע באופן אוטומטי.
Kotlin
Firebase AI Logic SDK ל-Android (firebase-ai) מספק גישה לממשקי ה-API לאינטראקציה עם מודלים של Gemini.
בקובץ 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:35.0.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
Firebase AI Logic SDK ל-Android (firebase-ai) מספק גישה לממשקי ה-API לאינטראקציה עם מודלים של Gemini.
בקובץ 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:35.0.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 מספקת גישה לממשקי ה-API לאינטראקציה עם מודלים של Gemini. הספרייה כלולה ב-Firebase JavaScript SDK לאינטרנט.
מתקינים את Firebase JS SDK לאינטרנט באמצעות npm:
npm install firebaseמפעילים את 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) מספק גישה לממשקי ה-API לאינטראקציה עם מודלים של Gemini.
בספריית הפרויקט ב-Flutter, מריצים את הפקודה הבאה כדי להתקין את הפלאגינים Firebase AI Logic ו-App Check:
flutter pub add firebase_ai firebase_app_checkבקובץ
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';בנוסף, בקובץ
lib/main.dart, מוודאים שהפעלתם את Firebase באמצעות האובייקטDefaultFirebaseOptionsשיוצא מקובץ ההגדרות:await Firebase.initializeApp( options: DefaultFirebaseOptions.currentPlatform, );בונים מחדש את אפליקציית Flutter:
flutter run
Unity
מורידים את Firebase Unity SDK ומחלצים את ה-SDK למיקום נוח.
Firebase Unity SDK לא ספציפי לפלטפורמה.
בפרויקט Unity הפתוח, עוברים אל Assets (נכסים) > Import Package (ייבוא חבילה) > Custom Package (חבילה בהתאמה אישית).
מתוך ה-SDK שחולץ, בוחרים את חבילות
FirebaseAIו-FirebaseAppCheck.בחלון Import Unity Package, לוחצים על Import.
שלב 3: הגדרת ספק אימות לצורכי ניפוי באגים של App Check לפיתוח מקומי
החל מתחילת יולי 2026, במהלך תהליך ההגדרה המודרך במסוף Firebase, Firebase תאכוף באופן אוטומטי את Firebase App Check עבור Firebase AI Logic כדי לעזור להגן על Gemini API.
בפיתוח מקומי, אפשר להגדיר את App Check ספק אימות לצורכי ניפוי באגים ועדיין להשאיר את App Check נאכף עבור Firebase AI Logic.
Swift
כך משתמשים בספק לצורכי ניפוי באגים כשמריצים את האפליקציה בסימולטור באופן אינטראקטיבי (לדוגמה, במהלך פיתוח מקומי):
בפרויקט 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() } } } }איך מקבלים טוקן לניפוי באגים:
מפעילים את האפליקציה בסימולטור או במכשיר הבדיקה.
פותחים את מסוף Xcode ומחפשים את אסימון ניפוי הבאגים של App Check. לדוגמה:
<Warning> [AppCheckCore][I-GAC004001] App Check debug token: '123a4567-b89c-12d3-e456-789012345678'.מעתיקים את הטוקן (לדוגמה,
123a4567-b89c-12d3-e456-789012345678).
רושמים את אסימון ניפוי הבאגים ב-App Check:
במסוף Firebase, עוברים אל Security (אבטחה) > App Check (בדיקת אפליקציות) > הכרטיסייה Apps (אפליקציות).
מוצאים את האפליקציה, לוחצים על סמל האפשרויות הנוספות () ובוחרים באפשרות ניהול אסימוני ניפוי באגים.
פועלים לפי ההוראות במסך כדי לרשום את אסימון ניפוי הבאגים.
פרטים על ספק אימות לצורכי ניפוי באגים (כולל איך מקבלים אסימון ניפוי באגים חדש) זמינים במסמכי App Check הרשמיים.
Kotlin
כך משתמשים בספק ניפוי הבאגים בזמן הפעלת האפליקציה באימולטור באופן אינטראקטיבי (לדוגמה, במהלך פיתוח מקומי):
בגרסת build לניפוי באגים, מגדירים את App Check כך שישתמש ב-factory של ספק אימות לצורכי ניפוי באגים:
Firebase.initialize(context = this) Firebase.appCheck.installAppCheckProviderFactory( DebugAppCheckProviderFactory.getInstance(), )
איך מקבלים טוקן לניפוי באגים:
מפעילים את האפליקציה באמולטור או במכשיר הבדיקה.
מחפשים את אסימון הניפוי באגים App Check ביומנים. לדוגמה:
D DebugAppCheckProvider: Enter this debug secret into the allow list in the Firebase Console for your project: 123a4567-b89c-12d3-e456-789012345678מעתיקים את הטוקן (לדוגמה,
123a4567-b89c-12d3-e456-789012345678).
רושמים את אסימון ניפוי הבאגים ב-App Check:
במסוף Firebase, עוברים אל Security (אבטחה) > App Check (בדיקת אפליקציות) > הכרטיסייה Apps (אפליקציות).
מוצאים את האפליקציה, לוחצים על סמל האפשרויות הנוספות () ובוחרים באפשרות ניהול אסימוני ניפוי באגים.
פועלים לפי ההוראות במסך כדי לרשום את אסימון ניפוי הבאגים.
פרטים על ספק האימות לצורכי ניפוי באגים (כולל איך לקבל אסימון חדש לניפוי באגים) זמינים במסמכי התיעוד הרשמיים של App Check.
Java
כך משתמשים בספק ניפוי הבאגים בזמן הפעלת האפליקציה באימולטור באופן אינטראקטיבי (לדוגמה, במהלך פיתוח מקומי):
בגרסת build לניפוי באגים, מגדירים את App Check כך שישתמש ב-factory של ספק אימות לצורכי ניפוי באגים:
FirebaseApp.initializeApp(/*context=*/ this); FirebaseAppCheck firebaseAppCheck = FirebaseAppCheck.getInstance(); firebaseAppCheck.installAppCheckProviderFactory( DebugAppCheckProviderFactory.getInstance());
איך מקבלים טוקן לניפוי באגים:
מפעילים את האפליקציה באמולטור או במכשיר הבדיקה.
מחפשים את אסימון הניפוי באגים App Check ביומנים. לדוגמה:
D DebugAppCheckProvider: Enter this debug secret into the allow list in the Firebase Console for your project: 123a4567-b89c-12d3-e456-789012345678מעתיקים את הטוקן (לדוגמה,
123a4567-b89c-12d3-e456-789012345678).
רושמים את אסימון ניפוי הבאגים ב-App Check:
במסוף Firebase, נכנסים לכרטיסייה Security > App Check > Apps.
מוצאים את האפליקציה, לוחצים על תפריט האפשרויות הנוספות () ובוחרים באפשרות ניהול אסימוני ניפוי באגים.
פועלים לפי ההוראות במסך כדי לרשום את אסימון הניפוי באגים.
פרטים על ספק האימות לצורכי ניפוי באגים (כולל איך לקבל אסימון חדש לניפוי באגים) זמינים במסמכי התיעוד הרשמיים של App Check.
Web
כך משתמשים בספק האימות לצורכי ניפוי באגים כשמפעילים את האפליקציה מ-localhost באופן אינטראקטיבי (לדוגמה, במהלך פיתוח מקומי):
בגרסת ה-build לניפוי באגים, מפעילים את מצב ניפוי הבאגים על ידי הגדרת
self.FIREBASE_APPCHECK_DEBUG_TOKENל-trueלפני שמפעילים את App Check. לדוגמה:self.FIREBASE_APPCHECK_DEBUG_TOKEN = true; initializeAppCheck(app, { /* App Check options */ });נכנסים לאפליקציית האינטרנט באופן מקומי ופותחים את הכלים למפתחים בדפדפן. במסוף ניפוי הבאגים יופיע אסימון ניפוי באגים:
AppCheck debug token: "123a4567-b89c-12d3-e456-789012345678". You will need to safelist it in the Firebase console for it to work.רושמים את אסימון ניפוי הבאגים ב-App Check:
במסוף Firebase, עוברים אל Security (אבטחה) > App Check (בדיקת אפליקציות) > הכרטיסייה Apps (אפליקציות).
מוצאים את האפליקציה, לוחצים על תפריט האפשרויות הנוספות () ובוחרים באפשרות ניהול אסימוני ניפוי באגים.
פועלים לפי ההוראות במסך כדי לרשום את אסימון ניפוי הבאגים.
פרטים על ספק האימות לצורכי ניפוי באגים (כולל איך לקבל אסימון חדש לניפוי באגים) זמינים במסמכי התיעוד הרשמיים של App Check.
Dart
iOS+
כך משתמשים בספק לצורכי ניפוי באגים כשמריצים את האפליקציה בסימולטור באופן אינטראקטיבי (לדוגמה, במהלך פיתוח מקומי):
מפעילים את 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()); }מפעילים את הרישום ביומן של ניפוי הבאגים בפרויקט Xcode:
- פותחים את Product (מוצר) > Scheme (סכימה) > Edit scheme (עריכת הסכימה).
- בתפריט השמאלי, לוחצים על Run (הפעלה) ואז על הכרטיסייה Arguments (ארגומנטים).
- בקטע Arguments Passed on Launch (ארגומנטים שהערך שלהם נקבע בהפעלה) מוסיפים את הערך
-FIRDebugEnabled.
איך מקבלים טוקן לניפוי באגים:
פותחים את
ios/Runner.xcworkspaceבאמצעות Xcode ומפעילים את האפליקציה בסימולטור או במכשיר הבדיקה.פותחים את מסוף Xcode ומחפשים את אסימון הניפוי באגים App Check. לדוגמה:
<Warning> [AppCheckCore][I-GAC004001] App Check debug token: '123a4567-b89c-12d3-e456-789012345678'.מעתיקים את הטוקן (לדוגמה,
123a4567-b89c-12d3-e456-789012345678).
רושמים את אסימון ניפוי הבאגים ב-App Check:
במסוף Firebase, נכנסים לכרטיסייה Security > App Check > Apps.
מוצאים את האפליקציה, לוחצים על סמל האפשרויות הנוספות () ובוחרים באפשרות ניהול אסימוני ניפוי באגים.
פועלים לפי ההוראות במסך כדי לרשום את אסימון ניפוי הבאגים.
Android
כך משתמשים בספק ניפוי הבאגים בזמן הפעלת האפליקציה באימולטור באופן אינטראקטיבי (לדוגמה, במהלך פיתוח מקומי):
מפעילים את 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()); }איך מקבלים טוקן לניפוי באגים:
מפעילים את האפליקציה באמולטור או במכשיר הבדיקה.
מחפשים את אסימון ניפוי הבאגים App Check ביומנים. לדוגמה:
D DebugAppCheckProvider: Enter this debug secret into the allow list in the Firebase Console for your project: 123a4567-b89c-12d3-e456-789012345678מעתיקים את הטוקן (לדוגמה,
123a4567-b89c-12d3-e456-789012345678).
רושמים את אסימון ניפוי הבאגים ב-App Check:
במסוף Firebase, עוברים אל Security (אבטחה) > App Check (בדיקת אפליקציות) > הכרטיסייה Apps (אפליקציות).
מוצאים את האפליקציה, לוחצים על סמל האפשרויות הנוספות () ובוחרים באפשרות ניהול אסימוני ניפוי באגים.
פועלים לפי ההוראות במסך כדי לרשום את אסימון ניפוי הבאגים.
אינטרנט
כך משתמשים בספק האימות לצורכי ניפוי באגים כשמפעילים את האפליקציה מ-localhost באופן אינטראקטיבי (לדוגמה, במהלך פיתוח מקומי):
בקובץ
web/index.html, מפעילים את מצב ניפוי הבאגים על ידי הגדרתself.FIREBASE_APPCHECK_DEBUG_TOKENל-true:<body> <script> self.FIREBASE_APPCHECK_DEBUG_TOKEN = true; </script> ... </body>מריצים את אפליקציית האינטרנט באופן מקומי ופותחים את הכלים למפתחים בדפדפן. במסוף ניפוי הבאגים יופיע אסימון ניפוי באגים:
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.רושמים את אסימון ניפוי הבאגים ב-App Check:
במסוף Firebase, עוברים אל Security (אבטחה) > App Check (בדיקת אפליקציות) > הכרטיסייה Apps (אפליקציות).
מוצאים את האפליקציה, לוחצים על תפריט האפשרויות הנוספות () ובוחרים באפשרות ניהול אסימוני ניפוי באגים.
פועלים לפי ההוראות במסך כדי לרשום את אסימון הניפוי באגים.
פרטים על ספק האימות לצורכי ניפוי באגים (כולל איך לקבל אסימון חדש לניפוי באגים) זמינים במסמכי התיעוד הרשמיים של App Check.
Unity
כך משתמשים בספק ניפוי הבאגים בזמן הפעלת האפליקציה באימולטור באופן אינטראקטיבי (לדוגמה, במהלך פיתוח מקומי):
במסוף Firebase, יוצרים אסימון לניפוי באגים:
במסוף Firebase, עוברים אל Security (אבטחה) > App Check (בדיקת אפליקציות) > הכרטיסייה Apps (אפליקציות).
מוצאים את האפליקציה, לוחצים על סמל האפשרויות הנוספות () ובוחרים באפשרות ניהול אסימוני ניפוי באגים.
פועלים לפי ההוראות במסך כדי ליצור אסימון ניפוי באגים חדש.
מוסיפים את השורה הבאה לקוד האתחול של האפליקציה:
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, צריך להפעיל את השירות של ספק ה-API שבחרתם וליצור מכונה של 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.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
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.8-flash");
שימו לב: בהתאם ליכולת שבה אתם משתמשים, יכול להיות שלא תמיד תצטרכו ליצור מכונה של GenerativeModel. כדי להעביר קלט ופלט בסטרימינג באמצעות Gemini Live API, צריך ליצור מכונה של LiveModel.
בנוסף, אחרי שתסיימו את המדריך הזה למתחילים, תוכלו ללמוד איך לבחור מודל לתרחיש השימוש ולאפליקציה שלכם.
שלב 5: שליחת בקשה למודל
עכשיו אתם יכולים לשלוח בקשה למודל Gemini.
אתם יכולים להשתמש ב-generateContent() כדי ליצור טקסט דינמי מבוסס-AI מהנחיה שמכילה טקסט:
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")
// 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, השיטות ב-SDK הזה הן פונקציות השהיה וצריך לקרוא להן מהיקף 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.8-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.8-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.8-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.8-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.8-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.");
מה עוד אפשר לעשות?
מידע נוסף על המודלים הנתמכים
מידע ולמידה על המודלים שזמינים לתרחישי שימוש שונים, המכסות והתמחור שלהם.
לנסות יכולות אחרות
- מידע נוסף על יצירת טקסט מהנחיות טקסט בלבד, כולל איך להזרים את התשובה
- ליצור טקסט באמצעות הנחיות עם סוגי קבצים שונים, כמו תמונות, קובצי PDF, סרטונים ואודיו.
- פיתוח שיחות רב-שלביות (צ'אט).
- ליצור פלט מובנה (כמו JSON) גם מהנחיות טקסט וגם מהנחיות מולטי-מודאליות.
- ליצור ולערוך תמונות באמצעות פרומפטים טקסטואליים ומולטי-מודאליים.
- קלט ופלט של סטרימינג (כולל אודיו) באמצעות Gemini Live API.
-
להשתמש בכלים (כמו קריאה להפעלת פונקציות וביסוס באמצעות
Google Search אוGoogle Maps ) כדי לקשר מודל Gemini לחלקים אחרים באפליקציה ולמערכות ולמידע חיצוניים.
איך לשלוט ביצירת התוכן
- הסבר על עיצוב הנחיות, כולל שיטות מומלצות, אסטרטגיות ודוגמאות להנחיות.
- להגדיר פרמטרים של המודל, כמו המספר המקסימלי של טוקנים בפלט, הסבירות של טוקנים חוזרים בפלט וכו'.
- הגדרות הבטיחות מאפשרות לשנות את הסבירות לקבלת תשובות שעלולות להיחשב מזיקות.
שליחת משוב על חוויית השימוש ב-Firebase AI Logic