מעבר ל-Firebase AI Logic SDKs מגרסת הטרום-השקה של Vertex AI in Firebase SDKs

Swift

1. ב-Xcode, כשהפרויקט של האפליקציה פתוח, מעדכנים את חבילת Firebase לגרסה 12.5.0 ואילך באמצעות אחת מהאפשרויות הבאות:

   • אפשרות 1: עדכון כל החבילות: עוברים אל File (קובץ) > Packages (חבילות) > Update to Latest Package Versions (עדכון לגרסאות החבילות הכי עדכניות).

   • אפשרות 2: עדכון Firebase בנפרד: עוברים לחבילת Firebase בקטע Package Dependencies (יחסי תלות בין חבילות). לוחצים לחיצה ימנית על חבילת Firebase ובוחרים באפשרות Update Package (עדכון החבילה).

2. מוודאים שחבילת Firebase מופיעה עכשיו בגרסה v12.5.0 ואילך. אם לא, צריך לוודא שדרישות החבילה שצוינו מאפשרות עדכון לגרסה 12.5.0 ואילך.

3. בוחרים את יעד האפליקציה בכלי לעריכת פרויקטים ועוברים לקטע Frameworks, Libraries, and Embedded Content (מסגרות, ספריות ותוכן מוטמע).

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 Studio.

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 Studio.

Web

1. כדי לקבל את הגרסה העדכנית של Firebase JS SDK לאינטרנט באמצעות npm:

   npm i firebase@latest

   או

   yarn add firebase@latest

2. בכל מקום שבו ייבאתם את הספרייה, צריך לעדכן את הצהרות הייבוא כדי להשתמש ב-firebase/ai במקום זאת.

   הערה: יכול להיות שיהיה קל יותר להעביר את בסיס הקוד של האפליקציה (כפי שמוסבר בקטעים הבאים במדריך הזה) לפני שמוחקים את הייבוא הישן.

   // BEFORE
   import { initializeApp } from "firebase/app";
   import { getVertexAI, getGenerativeModel } from "firebase/vertexai-preview";
   
   
   // AFTER
   import { initializeApp } from "firebase/app";
   import { getAI, getGenerativeModel } from "firebase/ai";

Dart

1. כדי לעדכן את השימוש בחבילה firebase_ai בקובץ pubspec.yaml, מריצים את הפקודה הבאה מהספרייה של פרויקט Flutter:

   flutter pub add firebase_ai

2. בונים מחדש את פרויקט Flutter:

   flutter run

3. אחרי שמסיימים את העברת האפליקציה (ראו את שאר הקטעים במדריך הזה), חשוב למחוק את החבילה הישנה:

   flutter pub remove firebase_vertexai

Unity

התמיכה ב-Unity לא הייתה זמינה מ-"Vertex AI in Firebase".

איך מתחילים לעבוד עם Firebase AI Logic SDK ל-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'.

איך מתחילים לעבוד עם Firebase AI Logic SDK ל-Unity

Swift

• Enumerations

  • החלפנו את רוב הסוגים של enum ב-struct עם משתנים סטטיים. השינוי הזה מאפשר גמישות רבה יותר בפיתוח ה-API באופן שתואם לאחור. כשמשתמשים בהצהרות 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. אפשר להגדיר את כולם ב-initializer.

Kotlin

• Enumerations

  • החלפנו את הסוגים enum ואת הסוגים sealed בסוגים רגילים. השינוי הזה מאפשר גמישות רבה יותר בפיתוח ה-API באופן שתואם לאחור.

  • השם של ספירת הערכים BlockThreshold שונה ל-HarmBlockThreshold.

  • הוסרו ערכים מהמספורים הבאים: HarmBlockThreshold,‏ HarmProbability,‏ HarmSeverity,‏ BlockReason ו-FinishReason.

• Blob methods

  • שינינו את השם של כל ה-methods שכללו את Blob כחלק מהשם שלהן, כך שישתמשו ב-InlineData במקום זאת.

• הגדרות בטיחות

  • השדה method שונה כך שיכול להיות בו ערך null.

• Duration class

  • הסרנו את כל השימושים במחלקה Duration של Kotlin והחלפנו אותה ב-long. השינוי הזה מאפשר יכולת פעולה הדדית טובה יותר עם Java.

• מטא-נתונים של ציטוטים

  • העברנו את כל השדות שהוצהרו קודם ב-CitationMetadata למחלקה חדשה בשם Citation. אפשר למצוא את הציטוטים ברשימה שנקראת citations ב-CitationMetadata. השינוי הזה מאפשר התאמה טובה יותר של הסוגים בין הפלטפורמות.

• ספירת טוקנים

  • השדה totalBillableCharacters שונה כך שיכול להיות בו ערך null.

• סך התווים לחיוב

  • המאפיין totalBillableCharacters ב-CountTokensResponse שונה לאופציונלי כדי לשקף מצבים שבהם לא נשלחים תווים.

• הפעלת מודל

  • העברנו את הפרמטר requestOptions לסוף רשימת הפרמטרים כדי להתאים לפלטפורמות אחרות.

• Live API

  • הערך UNSPECIFIED הוסר מהסיווג enum‏ ResponseModality. במקום זאת, צריך להשתמש ב-null.

  • השם של LiveGenerationConfig.setResponseModalities שונה ל-LiveGenerationConfig.setResponseModality.

  • הוסר המחלקה LiveContentResponse.Status, ובמקומה שדות הסטטוס מוטמעים כמאפיינים של LiveContentResponse.

  • הוסרה המחלקה LiveContentResponse, ובמקומה סופקו מחלקות משנה של LiveServerMessage שתואמות לתגובות מהמודל.

  • הפונקציה LiveModelFutures.connect שונתה כך שתחזיר את הערך ListenableFuture<LiveSessionFutures> במקום ListenableFuture<LiveSession>.

Java

• Enumerations

  • החלפנו את הסוגים enum ואת הסוגים sealed בסוגים רגילים. השינוי הזה מאפשר גמישות רבה יותר בפיתוח ה-API באופן שתואם לאחור.

  • השם של ספירת הערכים BlockThreshold שונה ל-HarmBlockThreshold.

  • הוסרו ערכים מהמספורים הבאים: HarmBlockThreshold,‏ HarmProbability,‏ HarmSeverity,‏ BlockReason ו-FinishReason.

• Blob methods

  • שינינו את השם של כל ה-methods שכללו את Blob כחלק מהשם שלהן, כך שישתמשו ב-InlineData במקום זאת.

• הגדרות בטיחות

  • השדה method שונה כך שיכול להיות בו ערך null.

• Duration class

  • הסרנו את כל השימושים במחלקה Duration של Kotlin והחלפנו אותה ב-long. השינוי הזה מאפשר יכולת פעולה הדדית טובה יותר עם Java.

• מטא-נתונים של ציטוטים

  • העברנו את כל השדות שהוצהרו קודם ב-CitationMetadata למחלקה חדשה בשם Citation. אפשר למצוא את הציטוטים ברשימה שנקראת citations ב-CitationMetadata. השינוי הזה מאפשר התאמה טובה יותר של הסוגים בין הפלטפורמות.

• ספירת טוקנים

  • השדה totalBillableCharacters שונה כך שיכול להיות בו ערך null.

• סך התווים לחיוב

  • המאפיין totalBillableCharacters ב-CountTokensResponse שונה לאופציונלי כדי לשקף מצבים שבהם לא נשלחים תווים.

• הפעלת מודל

  • העברנו את הפרמטר requestOptions לסוף רשימת הפרמטרים כדי להתאים לפלטפורמות אחרות.

• Live API

  • הערך UNSPECIFIED הוסר מהסיווג enum‏ ResponseModality. במקום זאת, צריך להשתמש ב-null.

  • השם של LiveGenerationConfig.setResponseModalities שונה ל-LiveGenerationConfig.setResponseModality.

  • הוסר המחלקה LiveContentResponse.Status, ובמקומה שדות הסטטוס מוטמעים כמאפיינים של LiveContentResponse.

  • הוסרה המחלקה LiveContentResponse, ובמקומה סופקו מחלקות משנה של LiveServerMessage שתואמות לתגובות מהמודל.

  • הפונקציה LiveModelFutures.connect שונתה כך שתחזיר את הערך ListenableFuture<LiveSessionFutures> במקום ListenableFuture<LiveSession>.

• שינינו שיטות שונות של Java builder כך שיחזירו עכשיו את המופע של המחלקה שלהן בצורה נכונה, במקום void.

Web

• Enumerations

  • הוסרו ערכים מהספירות הבאות: HarmCategory,‏ BlockThreshold,‏ HarmProbability,‏ HarmSeverity,‏ BlockReason ו-FinishReason.

• הסיבה לחסימה

  • השדה blockReason ב-PromptFeedback השתנה לאופציונלי.

השינויים הנדרשים רק אם אתם מתחילים להשתמש ב-Gemini Developer API (במקום ב-Agent Platform Gemini API (formerly Vertex AI)):

• הגדרות בטיחות

  • הסרנו את השימושים ב-SafetySetting.method שלא נתמך.

• נתונים מוטבעים

  • הסרנו את השימושים ב-InlineDataPart.videoMetadata שלא נתמך.

Dart

• Enumerations

  • הוסרו ערכים מהמספורים הבאים: 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".

איך מתחילים לעבוד עם Firebase AI Logic SDK ל-Unity