Android वर्शन के लिए Places SDK टूल

प्लैटफ़ॉर्म चुनें: Android iOS JavaScript

Google Maps Platform की टीम नियमित तौर पर SDK टूल को अपडेट करती है. इसमें नई सुविधाएं जोड़ी जाती हैं और गड़बड़ियां ठीक की जाती हैं. साथ ही, परफ़ॉर्मेंस में सुधार किया जाता है. इस पेज पर बताया गया है कि मोबाइल SDK टूल पर, अपनी डिपेंडेंसी कैसे मैनेज करें.

  • मिशन के लिए अहम ऐप्लिकेशन के लिए, जिस मेजर वर्शन का इस्तेमाल किया जा रहा है (X.*) उसके सबसे नए डॉट रिलीज़ को लिंक करें और हर साल, मेजर वर्शन पर अपग्रेड करें.

    पूरे साल अपने ऐप्लिकेशन के नए वर्शन रिलीज़ करने पर, हो सकता है कि आप Android के लिए जगहें SDK टूल के नए डॉट वर्शन इस्तेमाल करना शुरू कर दें. इसके लिए आपके ऐप्लिकेशन को अपडेट करने की ज़रूरत नहीं होगी, क्योंकि नए डॉट वर्शन पुराने सिस्टम के साथ काम करते हैं.

    फ़ायदे:

    • अगर आपको Android के लिए जगहें SDK टूल में समस्याएं मिलती हैं, तो मोबाइल सहायता से जुड़ी नीति के मुताबिक, मेजर वर्शन के शुरुआती रिलीज़ के 12 महीनों बाद तक, पुराने सिस्टम के साथ काम करने की सुविधा के ज़रिए सुधार किए जाएंगे. समस्याओं को ठीक करने के लिए, आपको SDK टूल के किसी ऐसे वर्शन पर तुरंत अपग्रेड करने की ज़रूरत नहीं है जो incompatible.
    • अगर आपका ऐप्लिकेशन पहले से ही नए वर्शन पर बनाया गया हो, तो नई सुविधाओं और सुधारों को आसानी से इस्तेमाल किया जा सकता है.
    • SDK टूल के सबसे नए मेजर वर्शन में हर साल होने वाले अपडेट को लागू करने, ऐप्लिकेशन के हिसाब से बदलाव करने, उसे फिर से लिखने, और उसकी जांच करने में कम मेहनत करनी पड़ सकती है. हालांकि, मेजर वर्शन की एक से ज़्यादा रिलीज़ में किए गए, पुराने सिस्टम के साथ काम न करने वाले बदलावों को हैंडल करने में, कम मेहनत लगती है.

  • गैर-ज़रूरी ऐप्लिकेशन के लिए, तय किए गए किसी भी वर्शन से लिंक करें. जब आपको उस वर्शन के बंद होने की सूचना मिलती है, तब अपडेट किए गए ऐप्लिकेशन कोड को अपने उपयोगकर्ताओं को उपलब्ध कराने के लिए आपके पास 12 महीने का समय होता है.

    फ़ायदे:

    • रखरखाव का काम बहुत कम होता है.
    • आपके ऐप्लिकेशन के नए वर्शन, उपयोगकर्ताओं के उन डिवाइसों पर लंबे समय तक काम करते हैं जिन पर पुराने मोबाइल ऑपरेटिंग सिस्टम का इस्तेमाल किया जा रहा है. ऐसा तब तक होगा, जब तक आपको SDK टूल के नए वर्शन पर अपग्रेड न करना पड़े.

प्रोजेक्ट के मालिकों को, निगरानी वाले ईमेल पते वाले प्रोजेक्ट के मालिकों को बदलावों के बारे में, अपने-आप सूचनाएं मिलती हैं. इन बदलावों से, उनके हर प्रोजेक्ट पर असर पड़ता है. बड़े अपडेट, किसी सुविधा के बंद होने, और अन्य बदलावों के बारे में सूचना जारी रखें.

इंस्टॉल करना

अपनी ऐप्लिकेशन लेवल की build.gradle फ़ाइल में, प्रीफ़िक्स की रेंज (+) या latest के बजाय हमेशा कोई वर्शन डालें. इससे, ऐसे बिल्ड बन सकते हैं जिनके बारे में अनुमान नहीं लगाया जा सकता और उन्हें दोहराया नहीं जा सकता. Android के लिए Places SDK टूल, सिमैंटिक वर्शन का पालन करता है. साथ ही, नए मुख्य वर्शन की रिलीज़ में नुकसान पहुंचा सकने वाले बदलाव शामिल हो सकते हैं. कम से कम 21 एपीआई लेवल का इस्तेमाल किया जा सकता है.

dependencies {
    // If updating kotlin-bom version number above, also edit project-level build.gradle definition of $kotlin_version variable
    implementation(platform("org.jetbrains.kotlin:kotlin-bom:$kotlin_version"))
    implementation 'com.google.android.libraries.places:places:3.3.0'
}

रखरखाव और अपग्रेड

Android Studio, डिपेंडेंसी का नया वर्शन उपलब्ध होने पर, अपने-आप यह जांच करता है कि नए वर्शन उपलब्ध हैं या नहीं. तकनीकी क़र्ज़ को कम करने के लिए, Google One के सबसे नए वर्शन को जल्द से जल्द अपडेट करें. अगर किसी नए मेजर वर्शन में अपडेट किया जा रहा है, तो पुराने सिस्टम के साथ काम न करने वाले बदलावों और अपने कोड को अपडेट करने के तरीके के बारे में जानने के लिए, प्रॉडक्ट की जानकारी देखें.

नए वर्शन के लिए पोल कराने के अलावा, Google Cloud प्रोजेक्ट के मालिकों को पुराने सिस्टम के साथ काम न करने वाले बदलावों के बारे में ईमेल मिलते हैं. इन बदलावों से उनके प्रोजेक्ट पर असर पड़ सकता है. पुराने सिस्टम के साथ काम न करने वाले बदलावों के बारे में अपने-आप सूचना पाने के लिए, अपने हर प्रोजेक्ट के लिए निगरानी वाले ईमेल पते के साथ मालिक की भूमिका असाइन करें.

अगर आप Android के लिए स्थल SDK टूल 3.2.0 या इससे पहले के वर्शन से अपग्रेड कर रहे हैं

नए SDK टूल का इस्तेमाल करने के लिए, माइग्रेट करने की कोई ज़रूरत नहीं है. आपको सिर्फ़ ये काम करने होंगे:

  1. अपने ऐप्लिकेशन में इस्तेमाल किए गए एपीआई पासकोड पर, Places API (नया) चालू करें. अगर आपके पास Android के लिए जगहें SDK टूल और Android के लिए Places SDK टूल (नया), दोनों का इस्तेमाल करने का विकल्प है, तो हमारा सुझाव है कि हर एपीआई वर्शन के लिए अलग-अलग एपीआई पासकोड बनाएं. ज़्यादा जानकारी के लिए, एपीआई पासकोड का इस्तेमाल करना देखें.
  2. अपनी मॉड्यूल-लेवल की build.gradle फ़ाइल के dependencies सेक्शन में, places डिपेंडेंसी अपडेट करें और kotlin-bom डिपेंडेंसी जोड़ें:

      dependencies {
          implementation(platform("org.jetbrains.kotlin:kotlin-bom:1.8.0"))
          implementation 'com.google.android.libraries.places:places:3.3.0'
      }

    kotlin-bom डिपेंडेंसी के बारे में ज़्यादा जानने के लिए, ट्रांज़िट डिपेंडेंसी में नए kotlin-stdlib वर्शन का इस्तेमाल देखें.

  3. अपने ऐप्लिकेशन को शुरू करने के लिए, Places.initializeWithNewPlacesApiEnabled() नए तरीके को कॉल करने के लिए अपने मौजूदा ऐप्लिकेशन को अपडेट करें. ज़्यादा जानकारी के लिए, Places API क्लाइंट को शुरू करना देखें.

आपके मौजूदा ऐप्लिकेशन में कोई बदलाव नहीं होगा. हालांकि, अब आपको SDK टूल की नई सुविधाओं का फ़ायदा मिल सकता है.