Vertex AI in Firebase SDK के प्रीव्यू वर्शन से, Firebase AI Logic SDK पर माइग्रेट करना

Swift

1. Xcode में, अपना ऐप्लिकेशन प्रोजेक्ट खोलें. इसके बाद, इनमें से किसी एक विकल्प का इस्तेमाल करके, अपने Firebase पैकेज को v12.5.0 या इसके बाद के वर्शन पर अपडेट करें:

   • पहला विकल्प: सभी पैकेज अपडेट करें: File > Packages > Update to Latest Package Versions पर जाएं.

   • दूसरा विकल्प: Firebase को अलग से अपडेट करें: Package Dependencies सेक्शन में जाकर, Firebase पैकेज पर जाएं. Firebase पैकेज पर राइट क्लिक करें. इसके बाद, Update Package को चुनें.

2. पक्का करें कि Firebase पैकेज अब v12.5.0 या इसके बाद का वर्शन दिखा रहा हो. अगर ऐसा नहीं है, तो पुष्टि करें कि आपने पैकेज की जो ज़रूरी शर्तें तय की हैं उनके मुताबिक, SDK टूल को v12.5.0 या इसके बाद के वर्शन पर अपडेट किया जा सकता है.

3. प्रोजेक्ट एडिटर में अपने ऐप्लिकेशन का टारगेट चुनें. इसके बाद, फ़्रेमवर्क, लाइब्रेरी, और एम्बेड किया गया कॉन्टेंट सेक्शन पर जाएं.

4. नई लाइब्रेरी जोड़ें: + बटन को चुनें. इसके बाद, Firebase पैकेज से FirebaseAILogic जोड़ें.

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. npm का इस्तेमाल करके, वेब के लिए Firebase JS SDK टूल का नया वर्शन डाउनलोड करें:

   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. अपनी Flutter प्रोजेक्ट डायरेक्ट्री से यह कमांड चलाकर, pubspec.yaml फ़ाइल में firebase_ai पैकेज का इस्तेमाल करने के लिए अपडेट करें:

   flutter pub add firebase_ai

2. अपने Flutter प्रोजेक्ट को फिर से बनाएं:

   flutter run

3. अपने ऐप्लिकेशन को माइग्रेट करने के बाद (इस गाइड में बाकी सेक्शन देखें), पुराने पैकेज को मिटाना न भूलें:

   flutter pub remove firebase_vertexai

Unity

"Vertex AI in Firebase" से Unity के लिए सहायता उपलब्ध नहीं थी.

Unity के लिए Firebase AI Logic SDK टूल का इस्तेमाल शुरू करने का तरीका जानें.

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

"Vertex AI in Firebase" से Unity के लिए सहायता उपलब्ध नहीं थी.

Unity के लिए Firebase AI Logic SDK टूल का इस्तेमाल शुरू करने का तरीका जानें.

Swift

• एन्यूमरेशन

  • ज़्यादातर enum टाइप को स्टैटिक वैरिएबल वाले struct से बदला गया. इस बदलाव से, एपीआई को पुराने सिस्टम के साथ काम करने की सुविधा के साथ डेवलप करने में ज़्यादा आसानी होती है. switch स्टेटमेंट का इस्तेमाल करते समय, अब आपको default: केस शामिल करना होगा. इससे, ऐसी वैल्यू को कवर किया जा सकेगा जिनकी जानकारी नहीं है या जिन्हें मैनेज नहीं किया गया है. इनमें, आने वाले समय में एसडीके में जोड़ी जाने वाली नई वैल्यू भी शामिल हैं.

  • BlockThreshold एन्यूमरेशन का नाम बदलकर HarmBlockThreshold किया गया; यह टाइप अब struct है.

  • इन एन्यूमरेशन से unknown और unspecified केस हटा दिए गए हैं (अब structs): 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 टाइप को हटा दिया गया है, क्योंकि इसका इस्तेमाल किसी भी जवाब में नहीं किया गया था.

• उद्धरण का मेटाडेटा

  • CitationMetadata में citationSources प्रॉपर्टी का नाम बदलकर citations किया गया.

• बिल किए जा सकने वाले कुल वर्ण

  • CountTokensResponse में totalBillableCharacters प्रॉपर्टी को वैकल्पिक बनाया गया, ताकि ऐसी स्थितियों को दिखाया जा सके जहां कोई वर्ण नहीं भेजा जाता.

• उम्मीदवार का जवाब

  • अन्य प्लैटफ़ॉर्म के साथ मैच करने के लिए, CandidateResponse का नाम बदलकर Candidate कर दिया गया है.

• कॉन्टेंट जनरेट करने के लिए कॉन्फ़िगरेशन

  • GenerationConfig की सार्वजनिक प्रॉपर्टी को बदलकर internal किया गया. इन सभी को इनिशलाइज़र में कॉन्फ़िगर किया जा सकता है.

Kotlin

• एन्यूमरेशन

  • enum और sealed क्लास को सामान्य क्लास से बदल दिया गया है. इस बदलाव से, एपीआई को पुराने सिस्टम के साथ काम करने की सुविधा के साथ डेवलप करने में ज़्यादा आसानी होती है.

  • BlockThreshold एन्यूमरेशन का नाम बदलकर HarmBlockThreshold किया गया.

  • इन इनूमरेशन से वैल्यू हटा दी गई हैं: HarmBlockThreshold, HarmProbability, HarmSeverity, BlockReason, और FinishReason.

• Blob के तरीके

  • उन सभी तरीकों का नाम बदल दिया गया है जिनके नाम में Blob शामिल था. अब उनकी जगह InlineData का इस्तेमाल किया जाएगा.

• सुरक्षा सेटिंग

  • method फ़ील्ड को शून्य वैल्यू वाला बनाया गया.

• Duration क्लास

  • Kotlin की Duration क्लास के सभी इस्तेमाल हटा दिए गए हैं और उनकी जगह long का इस्तेमाल किया गया है. इस बदलाव से, Java के साथ बेहतर इंटरऑपरेबिलिटी मिलती है.

• उद्धरण का मेटाडेटा

  • CitationMetadata में पहले से एलान किए गए सभी फ़ील्ड को Citation नाम की नई क्लास में रैप किया गया. उद्धरण, CitationMetadata में citations नाम की सूची में मिल सकते हैं. इस बदलाव से, सभी प्लैटफ़ॉर्म पर एक जैसे टाइप इस्तेमाल किए जा सकेंगे.

• टोकन की गिनती करना

  • totalBillableCharacters फ़ील्ड को शून्य वैल्यू वाला बनाया गया.

• बिल किए जा सकने वाले कुल वर्ण

  • CountTokensResponse में totalBillableCharacters प्रॉपर्टी को वैकल्पिक बनाया गया, ताकि ऐसी स्थितियों को दिखाया जा सके जहां कोई वर्ण नहीं भेजा जाता.

• मॉडल को इंस्टैंशिएट करना

  • requestOptions पैरामीटर को पैरामीटर की सूची के आखिर में ले जाया गया है, ताकि इसे अन्य प्लैटफ़ॉर्म के साथ अलाइन किया जा सके.

• Live API

  • enum क्लास ResponseModality के लिए, UNSPECIFIED वैल्यू को हटा दिया गया है. इसके बजाय, null का इस्तेमाल करें.

  • LiveGenerationConfig.setResponseModalities का नाम बदलकर LiveGenerationConfig.setResponseModality किया गया.

  • LiveContentResponse.Status क्लास को हटा दिया गया है. इसके बजाय, स्टेटस फ़ील्ड को LiveContentResponse की प्रॉपर्टी के तौर पर नेस्ट किया गया है.

  • LiveContentResponse क्लास को हटा दिया गया है. इसके बजाय, LiveServerMessage की ऐसी सबक्लास उपलब्ध कराई गई हैं जो मॉडल से मिले जवाबों से मैच करती हैं.

  • LiveModelFutures.connect को ListenableFuture<LiveSession> के बजाय ListenableFuture<LiveSessionFutures> दिखाने के लिए बदला गया.

Java

• एन्यूमरेशन

  • enum और sealed क्लास को सामान्य क्लास से बदल दिया गया है. इस बदलाव से, एपीआई को पुराने सिस्टम के साथ काम करने की सुविधा के साथ डेवलप करने में ज़्यादा आसानी होती है.

  • BlockThreshold एन्यूमरेशन का नाम बदलकर HarmBlockThreshold किया गया.

  • इन इनूमरेशन से वैल्यू हटा दी गई हैं: HarmBlockThreshold, HarmProbability, HarmSeverity, BlockReason, और FinishReason.

• Blob के तरीके

  • उन सभी तरीकों का नाम बदल दिया गया है जिनके नाम में Blob शामिल था. अब उनकी जगह InlineData का इस्तेमाल किया जाएगा.

• सुरक्षा सेटिंग

  • method फ़ील्ड को शून्य वैल्यू वाला बनाया गया.

• Duration क्लास

  • Kotlin की Duration क्लास के सभी इस्तेमाल हटा दिए गए हैं और उनकी जगह long का इस्तेमाल किया गया है. इस बदलाव से, Java के साथ बेहतर इंटरऑपरेबिलिटी मिलती है.

• उद्धरण का मेटाडेटा

  • CitationMetadata में पहले से एलान किए गए सभी फ़ील्ड को Citation नाम की नई क्लास में रैप किया गया. उद्धरण, CitationMetadata में citations नाम की सूची में मिल सकते हैं. इस बदलाव से, सभी प्लैटफ़ॉर्म पर एक जैसे टाइप इस्तेमाल किए जा सकेंगे.

• टोकन की गिनती करना

  • totalBillableCharacters फ़ील्ड को शून्य वैल्यू वाला बनाया गया.

• बिल किए जा सकने वाले कुल वर्ण

  • CountTokensResponse में totalBillableCharacters प्रॉपर्टी को वैकल्पिक बनाया गया, ताकि ऐसी स्थितियों को दिखाया जा सके जहां कोई वर्ण नहीं भेजा जाता.

• मॉडल को इंस्टैंशिएट करना

  • requestOptions पैरामीटर को पैरामीटर की सूची के आखिर में ले जाया गया है, ताकि इसे अन्य प्लैटफ़ॉर्म के साथ अलाइन किया जा सके.

• Live API

  • enum क्लास ResponseModality के लिए, UNSPECIFIED वैल्यू को हटा दिया गया है. इसके बजाय, null का इस्तेमाल करें.

  • LiveGenerationConfig.setResponseModalities का नाम बदलकर LiveGenerationConfig.setResponseModality किया गया.

  • LiveContentResponse.Status क्लास को हटा दिया गया है. इसके बजाय, स्टेटस फ़ील्ड को LiveContentResponse की प्रॉपर्टी के तौर पर नेस्ट किया गया है.

  • LiveContentResponse क्लास को हटा दिया गया है. इसके बजाय, LiveServerMessage की ऐसी सबक्लास उपलब्ध कराई गई हैं जो मॉडल से मिले जवाबों से मैच करती हैं.

  • LiveModelFutures.connect को ListenableFuture<LiveSession> के बजाय ListenableFuture<LiveSessionFutures> दिखाने के लिए बदला गया.

• Java बिल्डर के अलग-अलग तरीकों में बदलाव किया गया है, ताकि वे void के बजाय, अपनी क्लास के इंस्टेंस को सही तरीके से दिखाएं.

Web

• एन्यूमरेशन

  • इन इनूमरेशन से वैल्यू हटा दी गई हैं: HarmCategory, BlockThreshold, HarmProbability, HarmSeverity, BlockReason, और FinishReason.

• ब्लॉक करने की वजह

  • PromptFeedback में blockReason को वैकल्पिक के तौर पर बदला गया.

बदलावों की ज़रूरत सिर्फ़ तब होती है, जब Agent Platform Gemini API (formerly Vertex AI) के बजाय Gemini Developer API का इस्तेमाल शुरू किया जा रहा हो:

• सुरक्षा सेटिंग

  • इस्तेमाल न किए जा सकने वाले SafetySetting.method के इस्तेमाल को हटाया गया.

• इनलाइन डेटा

  • InlineDataPart.videoMetadata के इस्तेमाल को हटाया गया, जो अब काम नहीं करता.

Dart

• एन्यूमरेशन

  • इन इनूमरेशन से वैल्यू हटा दी गई हैं: HarmCategory, HarmProbability, BlockReason, और FinishReason.

• डेटा पार्ट

  • DataPart का नाम बदलकर InlineDataPart और static data फ़ंक्शन का नाम बदलकर inlineData कर दिया गया है, ताकि अन्य प्लैटफ़ॉर्म के साथ अलाइन किया जा सके.

• अनुरोध करने के विकल्प

  • RequestOptions को हटा दिया गया है, क्योंकि timeout काम नहीं कर रहा था. इसे आने वाले समय में फिर से जोड़ा जाएगा. हालांकि, इसे अन्य प्लैटफ़ॉर्म से मैच करने के लिए, GenerativeModel टाइप में ले जाया जाएगा.

• सीक्वेंस रोकना

  • GenerationConfig में stopSequences पैरामीटर को बदलकर, वैकल्पिक और खाली कलेक्शन के बजाय डिफ़ॉल्ट रूप से null पर सेट किया गया.

• उद्धरण

  • CitationMetadata में citationSources प्रॉपर्टी का नाम बदलकर citations किया गया. CitationSource टाइप का नाम बदलकर Citation कर दिया गया है, ताकि यह अन्य प्लैटफ़ॉर्म से मैच हो सके.

• सार्वजनिक तौर पर उपलब्ध ऐसे टाइप, तरीके, और प्रॉपर्टी जिनकी ज़रूरत नहीं है

  • हमने ये टाइप, तरीके, और प्रॉपर्टी हटा दी हैं, जो अनजाने में दिख रही थीं: defaultTimeout, CountTokensResponseFields, parseCountTokensResponse, parseEmbedContentResponse, parseGenerateContentResponse, parseContent, BatchEmbedContentsResponse, ContentEmbedding, EmbedContentRequest, और EmbedContentResponse.

• टोकन की गिनती करना

  • countTokens फ़ंक्शन से वे अतिरिक्त फ़ील्ड हटा दिए गए हैं जिनकी अब ज़रूरत नहीं है. सिर्फ़ contents की ज़रूरत है.

• मॉडल को इंस्टैंशिएट करना

  • systemInstruction पैरामीटर को पैरामीटर की सूची के आखिर में ले जाया गया है, ताकि इसे अन्य प्लैटफ़ॉर्म के साथ अलाइन किया जा सके.

• एम्बेड करने की सुविधा

  • मॉडल से, काम न करने वाली एंबेडिंग की सुविधा (embedContent और batchEmbedContents) हटा दी गई है.

Unity

"Vertex AI in Firebase" से Unity के लिए सहायता उपलब्ध नहीं थी.

Unity के लिए Firebase AI Logic SDK टूल का इस्तेमाल शुरू करने का तरीका जानें.