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 या उसके बाद का वर्शन दिख रहा हो. अगर ऐसा नहीं है, तो पुष्टि करें कि आपने पैकेज की जो ज़रूरी शर्तें तय की हैं उनके मुताबिक, 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.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. 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. अपनी pubspec.yaml फ़ाइल में firebase_ai पैकेज का इस्तेमाल करने के लिए, इसे अपडेट करें. इसके लिए, अपने 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 for 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

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

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

Swift

• एन्यूमरेशन

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

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

  • नीचे दिए गए एन्यूमरेशन से unknown और unspecified केस हटा दिए गए हैं. अब ये struct हैं: HarmCategory, HarmBlockThreshold, HarmProbability, BlockReason, और FinishReason.

  • हमने एन्यूमरेशन ModelContent.Part को Part नाम के प्रोटोकॉल से बदल दिया है. इससे पुराने सिस्टम के साथ काम करने की सुविधा के साथ नए टाइप जोड़े जा सकते हैं. इस बदलाव के बारे में ज़्यादा जानकारी, कॉन्टेंट के हिस्से सेक्शन में दी गई है.

• कॉन्टेंट के हिस्से

  • ThrowingPartsRepresentable प्रोटोकॉल को हटा दिया गया है. साथ ही, कंपाइलर से जुड़ी कभी-कभी होने वाली गड़बड़ियों से बचने के लिए, ModelContent के इनिशियलाइज़र को आसान बना दिया गया है. जिन इमेज को ठीक से कोड नहीं किया गया है उनमें generateContent में इस्तेमाल करने पर अब भी गड़बड़ियां दिखेंगी.

  • ModelContent.Part केस को Part प्रोटोकॉल के मुताबिक, इन struct टाइप से बदला गया:

    • .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 फ़ील्ड को शून्य वैल्यू वाला बनाया गया.

• अवधि क्लास

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

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

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

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

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

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

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

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

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

• Live API

  • इनम क्लास 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 फ़ील्ड को शून्य वैल्यू वाला बनाया गया.

• अवधि क्लास

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

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

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

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

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

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

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

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

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

• Live API

  • इनम क्लास 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 पर सेट कर दिया गया है.

• उद्धरण

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

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

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

• टोकन की संख्या गिनना

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

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

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

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

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

Unity

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

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