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

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

किस वर्शन से लिंक करना है?

• मिशन के लिए महत्वपूर्ण ऐप्लिकेशन के लिए, प्रमुख वर्शन है, जिसका आप इस्तेमाल कर रहे हैं (X.*) और हर साल नए मेजर वर्शन में अपग्रेड करें.

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

  फ़ायदे:

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

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

  फ़ायदे:

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

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

इंस्टॉल करना

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

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

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

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

1. अपने ऐप्लिकेशन में इस्तेमाल की गई एपीआई कुंजी पर, Places API (नया) चालू करें. ज़्यादा जानकारी के लिए, एपीआई कुंजियों का इस्तेमाल करना देखें.

2. आपके मॉड्यूल-लेवल के dependencies सेक्शन में build.gradle फ़ाइल, places डिपेंडेंसी अपडेट करें और kotlin-bom डिपेंडेंसी जोड़ें:

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

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

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

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