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

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

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

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

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

    फ़ायदे:

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

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

    फ़ायदे:

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

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

इंस्टॉल करना

ऐप्लिकेशन लेवल की build.gradle फ़ाइल में, प्रीफ़िक्स की रेंज (+) या latest के बजाय हमेशा कोई वर्शन डालें. इसकी वजह से, ऐसे बिल्ड हो सकते हैं जिनके बारे में अनुमान न लगाया जा सके. साथ ही, इन फ़ाइलों को दोहराया न जा सके. Android के लिए 'जगहें' 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 Cloud के प्रोजेक्ट के मालिकों को पुराने सिस्टम में हुए बदलावों के बारे में ईमेल मिलते हैं. इन बदलावों से उनके प्रोजेक्ट पर असर पड़ सकता है. पुराने सिस्टम में काम न करने वाले बदलावों के बारे में अपने-आप सूचना पाने के लिए, अपने हर प्रोजेक्ट के लिए मॉनिटर किए गए ईमेल पते के साथ मालिक की भूमिका असाइन करें.

अगर आपको Android 3.2.0 या इससे पहले के वर्शन के लिए Places SDK से अपग्रेड करना है, तो

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

  1. अपने ऐप्लिकेशन में इस्तेमाल की गई एपीआई कुंजी पर, Locations API (नया) चालू करें. ज़्यादा जानकारी के लिए, एपीआई पासकोड का इस्तेमाल करना देखें.
  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 टूल की सभी नई सुविधाओं का फ़ायदा लिया जा सकता है.