במדריך הזה מוסבר איך להתחיל לבצע קריאות אל Gemini APIישירות מהאפליקציה באמצעות ערכות ה-SDK של הלקוח Firebase AI Logicלפלטפורמה שבחרתם.
דרישות מוקדמות
Swift
במדריך הזה אנחנו מניחים שאתם יודעים איך להשתמש ב-Xcode כדי לפתח אפליקציות לפלטפורמות של Apple (כמו iOS).
חשוב לוודא שסביבת הפיתוח והאפליקציה לפלטפורמות של אפל עומדות בדרישות הבאות:
- Xcode מגרסה 26.2 ואילך
- האפליקציה מטרגטת ל-iOS מגרסה 15 ומעלה, או ל-macOS מגרסה 12 ומעלה
Kotlin
במדריך הזה אנחנו מניחים שאתם יודעים איך להשתמש ב-Android Studio כדי לפתח אפליקציות ל-Android.
צריך לוודא שסביבת הפיתוח ואפליקציית Android עומדות בדרישות הבאות:
- Android Studio (הגרסה האחרונה)
- האפליקציה שלך מטרגטת לרמת API 21 ומעלה
Java
במדריך הזה אנחנו מניחים שאתם יודעים איך להשתמש ב-Android Studio כדי לפתח אפליקציות ל-Android.
צריך לוודא שסביבת הפיתוח ואפליקציית Android עומדות בדרישות הבאות:
- Android Studio (הגרסה האחרונה)
- האפליקציה שלך מטרגטת לרמת API 21 ומעלה
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. כדי להמחיש את השימוש ב-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, שמאפשרת להתחיל במהירות ללא עלות.
בכל שלב מאוחר יותר, תמיד אפשר להגדיר את Vertex AI Gemini API (ואת הדרישה שלו לחיוב).
ממשיכים בתהליך העבודה כדי להגדיר את ממשקי ה-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 (קובץ > הוספת תלות בחבילה).
כשמוצגת בקשה, מוסיפים את מאגר Firebase Apple platforms SDK:
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 ל-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
Firebase AI Logic SDK ל-Android (firebase-ai) מספק גישה לממשקי ה-API לאינטראקציה עם מודלים של Gemini.
בקובץ Gradle של המודול (ברמת האפליקציה) (למשל <project>/<app-module>/build.gradle.kts), מוסיפים את התלות בספרייה Firebase AI Logic ל-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 מספקת גישה לממשקי ה-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:
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.בחלון ייבוא חבילת Unity, לוחצים על ייבוא.
שלב 3: הגדרת ספק ניפוי הבאגים App Check לפיתוח מקומי
החל מתחילת יולי 2026, כחלק מתהליך העבודה המודרך להגדרה של AI Logic ב-Play Console, Firebase App Check ייאכף באופן אוטומטי כדי להגן על Gemini API. לפיתוח מקומי, צריך להגדיר את App Check ספק ניפוי הבאגים כדי לעקוף את האימות, ועדיין לשמור על האכיפה של App Check.
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
כך משתמשים בספק ניפוי הבאגים בזמן הפעלת האפליקציה באמולטור באופן אינטראקטיבי (לדוגמה, במהלך פיתוח מקומי):
בגרסת הניפוי באגים, מגדירים את App Check כך שישתמש במפעל של ספק ניפוי הבאגים:
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
כך משתמשים בספק ניפוי הבאגים בזמן הפעלת האפליקציה באמולטור באופן אינטראקטיבי (לדוגמה, במהלך פיתוח מקומי):
בגרסת הניפוי באגים, מגדירים את App Check כך שישתמש במפעל של ספק ניפוי הבאגים:
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
באופן אינטראקטיבי (לדוגמה, במהלך פיתוח מקומי):
בגרסת ניפוי הבאגים, מפעילים את מצב ניפוי הבאגים על ידי הגדרת
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.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, המתודות ב-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.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.");
מה עוד אפשר לעשות?
מידע נוסף על המודלים הנתמכים
מידע על המודלים שזמינים לתרחישי שימוש שונים, על המיכסות ועל התמחור.
כדאי לנסות יכולות אחרות
- מידע נוסף על יצירת טקסט מהנחיות שמכילות טקסט בלבד, כולל איך להזרים את התשובה
- יצירת טקסט באמצעות הנחיות עם סוגים שונים של קבצים, כמו תמונות, קובצי PDF, סרטונים ואודיו.
- פיתוח שיחות רב-שלביות (צ'אט).
- Generate structured output (like JSON) from both text and multimodal prompts.
- יצירה ועריכה של תמונות מתוך הנחיות טקסט והנחיות מולטימודאליות.
- קלט ופלט של שידורים (כולל אודיו) באמצעות Gemini Live API.
- שימוש בכלים (כמו קריאה לפונקציה והצמדה לקרקע באמצעות חיפוש Google) כדי לקשר מודל Gemini לחלקים אחרים באפליקציה ולמערכות ולמידע חיצוניים.
איך שולטים ביצירת תוכן
- הסבר על תכנון הנחיות, כולל שיטות מומלצות, אסטרטגיות והנחיות לדוגמה.
- הגדרת פרמטרים של המודל כמו מספר מקסימלי של טוקנים בפלט, ההסתברות לטוקנים חוזרים בפלט וכו'.
- שימוש בהגדרות בטיחות כדי לשנות את הסבירות לקבלת תשובות שעלולות להיחשב מזיקות.
רוצה לתת משוב על חוויית השימוש ב-Firebase AI Logic?