מעבר ל-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 מוצגת עכשיו גרסה 12.5.0 ואילך. אם לא, ודאו שדרישות החבילה שציינתם מאפשרות עדכון לגרסה 12.5.0 ואילך.

3. בוחרים את היעד של האפליקציה ב-Project Editor, ואז עוברים לקטע 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.1.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.1.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".

איך מתחילים להשתמש ב-SDK של Firebase AI Logic ל-Unity

Swift

import FirebaseAILogic

// Initialize the Gemini Developer API backend service
let ai = FirebaseAI.firebaseAI(backend: .googleAI())

// Create a `GenerativeModel` instance with a model that supports your use case
let model = ai.generativeModel(modelName: "gemini-3.8-flash")

Kotlin

// Initialize the Gemini Developer API backend service.
// Create a `GenerativeModel` instance with a model that supports your use case.
val model = Firebase.ai(backend = GenerativeBackend.googleAI())
                        .generativeModel("gemini-3.8-flash")

Java

// Initialize the Gemini Developer API backend service.
// Create a `GenerativeModel` instance with a model that supports your use case.
GenerativeModel ai = FirebaseAI.getInstance(GenerativeBackend.googleAI())
        .generativeModel("gemini-3.8-flash");

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

Web

import { initializeApp } from "firebase/app";
import { getAI, getGenerativeModel, GoogleAIBackend } from "firebase/ai";

// TODO(developer): Replace the following with your app's Firebase configuration
// See: https://firebase.google.com/docs/web/learn-more#config-object
const firebaseConfig = {
  // ...
};

// Initialize FirebaseApp
const firebaseApp = initializeApp(firebaseConfig);

// Initialize the Gemini Developer API backend service.
const ai = getAI(firebaseApp, { backend: new GoogleAIBackend() });

// Create a `GenerativeModel` instance with a model that supports your use case.
const model = getGenerativeModel(ai, { model: "gemini-3.8-flash" });

Dart

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

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

// Initialize the Gemini Developer API backend service
// Create a `GenerativeModel` instance with a model that supports your use case
final model =
      FirebaseAI.googleAI().generativeModel(model: 'gemini-3.8-flash');

Unity

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

איך מתחילים להשתמש ב-SDK של Firebase AI Logic ל-Unity

Swift

• ספירות

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

Kotlin

• ספירות

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

  • השם של המאפיין BlockThreshold שונה ל-HarmBlockThreshold.

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

• שיטות Blob

  • שינינו את השמות של כל השיטות שכללו את 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

• ספירות

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

  • השם של המאפיין BlockThreshold שונה ל-HarmBlockThreshold.

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

• שיטות Blob

  • שינינו את השמות של כל השיטות שכללו את 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

• ספירות

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

• סיבת החסימה

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

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

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

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

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

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

Dart

• ספירות

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

• חלק הנתונים

  • שינינו את השם של DataPart ל-InlineDataPart, ואת השם של הפונקציה static data ל-inlineData כדי להתאים לפלטפורמות אחרות.

• אפשרויות לבקשות

  • הסרנו את RequestOptions כי timeout לא פעל. הוא יתווסף מחדש בעתיד הקרוב, אבל יועבר לסוג GenerativeModel כדי להתאים לפלטפורמות אחרות.

• הפסקת רצפים

  • הפרמטר stopSequences ב-GenerationConfig השתנה, ועכשיו הוא אופציונלי ומוגדר כברירת מחדל ל-null במקום למערך ריק.

• ציטוטים

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

• סוגים, שיטות ומאפיינים ציבוריים מיותרים

  • הסרנו את הסוגים, השיטות והמאפיינים הבאים שנחשפו בטעות: defaultTimeout,‏ CountTokensResponseFields,‏ parseCountTokensResponse,‏ parseEmbedContentResponse,‏ parseGenerateContentResponse,‏ parseContent,‏ BatchEmbedContentsResponse,‏ ContentEmbedding,‏ EmbedContentRequest ו-EmbedContentResponse.

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

  • הסרנו שדות מיותרים מהפונקציה countTokens. צריך רק contents.

• יצירת מופע של מודל

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

• פונקציונליות של הטמעה

  • הסרנו מהמודל פונקציונליות הטמעה שלא נתמכת (embedContent ו-batchEmbedContents).

Unity

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

איך מתחילים להשתמש ב-SDK של Firebase AI Logic ל-Unity