Android ভার্সনের জন্য Places SDK

প্ল্যাটফর্ম বেছে নিন: Android iOS JavaScript

Google Maps Platform টিম নিয়মিতভাবে SDK আপডেট করে নতুন ফিচার, সমস্যার সমাধান ও পারফর্ম্যান্সের উন্নতি করে। মোবাইল SDK-এর উপর আপনার নির্ভরতা কীভাবে ম্যানেজ করবেন সেই বিষয়ে এই পৃষ্ঠায় নির্দেশিকা দেওয়া হয়েছে।

  • মিশন-ক্রিটিক্যাল অ্যাপের জন্য, আপনি যে মেজর ভার্সন (X.*) ব্যবহার করছেন, সেটির লেটেস্ট ডট রিলিজের সাথে লিঙ্ক করুন এবং প্রতি বছর নতুন মেজর ভার্সনে আপগ্রেড করুন।

    সারা বছর ধরে আপনার অ্যাপ্লিকেশনের নতুন ভার্সন রিলিজ করার সাথে সাথে, আপনি Android-এর জন্য Places SDK-এর নতুন ডট ভার্সন ব্যবহার করা শুরু করতে পারেন। নতুন ডট ভার্সন ব্যাকওয়ার্ড কম্প্যাটিবল হওয়ার কারণে আপনার অ্যাপ্লিকেশনে আপডেট করার প্রয়োজন হবে না।

    সুবিধা:

    • Android-এর জন্য Places SDK-তে আপনি কোনও সমস্যা খুঁজে পেলে, মোবাইল সহায়তা নীতি অনুযায়ী, মেজর ভার্সন প্রথমবার রিলিজ হওয়ার পর ১২ মাস পর্যন্ত ব্যাকওয়ার্ড-কম্প্যাটিবল উপায়ে সমাধান প্রদান করা হবে। সমস্যার সমাধান থেকে সুবিধা পেতে আপনাকে জরুরি ভিত্তিতে বেমানান SDK ভার্সনে আপগ্রেড করতে হবে না।
    • আপনার অ্যাপ আগে থেকেই লেটেস্ট ভার্সনে তৈরি করা থাকলে, লেটেস্ট উন্নতি ও ফিচার সহজেই গ্রহণ করা যায়।
    • SDK-এর নতুন মেজর ভার্সনে বার্ষিক ইনক্রিমেন্টাল আপডেট করার জন্য আপনার অ্যাপ্লিকেশন অ্যাডাপ্ট, রিরাইট ও টেস্ট করার জন্য কম কাজ করতে হতে পারে। একাধিক মেজর ভার্সন রিলিজ জুড়ে ব্যাকওয়ার্ড ইনকমপ্যাটিবল পরিবর্তন ম্যানেজ করার তুলনায় এটি অনেক সহজ।
  • গুরুত্বপূর্ণ নয় এমন অ্যাপের জন্য, যেকোনও নির্দিষ্ট ভার্সনে লিঙ্ক করুন। আপনি যখন সেই নির্দিষ্ট ভার্সনের জন্য অবচয় বিজ্ঞপ্তি পাবেন, তখন আপনার ব্যবহারকারীদের জন্য আপনার আপডেট করা অ্যাপ কোড উপলভ্য করার জন্য আপনার কাছে ১২ মাস সময় থাকবে।

    সুবিধা:

    • রক্ষণাবেক্ষণের কাজ কম ঘন ঘন করা হয়।
    • আপনার অ্যাপের নতুন ভার্সন ব্যবহারকারীর ডিভাইসে আরও বেশি সময় ধরে (আপনাকে নতুন SDK ভার্সনে আপগ্রেড করতে না হওয়া পর্যন্ত) পুরনো মোবাইল অপারেটিং সিস্টেম চালাতে সাহায্য করে।

মনিটর করা ইমেল আইডি সহ প্রোজেক্টের মালিকরা এমন পরিবর্তন সম্পর্কে অতিসক্রিয় বিজ্ঞপ্তি পান যা তাদের প্রতিটি প্রোজেক্টকে প্রভাবিত করে। গুরুত্বপূর্ণ আপডেট, বন্ধ হয়ে যাওয়া এবং অন্যান্য পরিবর্তন সম্পর্কে আপডেট থাকুন।

ইনস্টল করা

আপনার অ্যাপ-লেভেল build.gradle.kts বা build.gradle ফাইলে, সবসময় প্রিফিক্স রেঞ্জ (+) বা latest-এর পরিবর্তে একটি ভার্সন উল্লেখ করুন কারণ এগুলি অপ্রত্যাশিত এবং পুনরাবৃত্তি করা যায় না এমন বিল্ডের কারণ হতে পারে। Android-এর জন্য Places SDK সিম্যান্টিক ভার্সনিং মেনে চলে এবং নতুন মেজর ভার্সন রিলিজের মধ্যে ব্রেকিং পরিবর্তন থাকতে পারে। ন্যূনতম API লেভেল ২৪-এ কাজ করে।

dependencies {

    // Places and Maps SDKs
    implementation("com.google.android.libraries.places:places:6.0.2")
}

রক্ষণাবেক্ষণ ও আপগ্রেড

Android Studio অটোমেটিক নতুন উপলভ্য ভার্সন চেক করে এবং ডিপেন্ডেন্সির নতুন ভার্সন উপলভ্য হলে সতর্কতা প্রদান করে। টেকনিক্যাল ডেট কমাতে, যত তাড়াতাড়ি সম্ভব উপলভ্য লেটেস্ট ভার্সনে আপডেট করুন। আপনি যদি নতুন মেজর ভার্সনে আপডেট করেন, তাহলে ব্যাকওয়ার্ড-ইনকমপ্যাটিবল পরিবর্তন এবং আপনার কোড কীভাবে আপডেট করবেন তা জানতে রিলিজ নোট চেক করুন।

নতুন ভার্সনের জন্য পোলিং ছাড়াও, Google Cloud প্রোজেক্টের মালিকরা ব্যাকওয়ার্ড ইনকমপ্যাটিবল পরিবর্তন সম্পর্কে ইমেল পান যা তাদের প্রোজেক্টকে প্রভাবিত করতে পারে। ব্যাকওয়ার্ড ইনকমপ্যাটিবল পরিবর্তন সম্পর্কে প্রোঅ্যাক্টিভ বিজ্ঞপ্তি পেতে, আপনার প্রতিটি প্রোজেক্টের জন্য মনিটর করা ইমেল আইডির সাথে মালিকের ভূমিকা অ্যাসাইন করুন।

আপনি যদি Android ভার্সন ৩.২.০ বা তার আগের ভার্সনের জন্য Places SDK থেকে আপগ্রেড করেন

নতুন SDK-তে সরানোর সময় কোনও মাইগ্রেশনের প্রয়োজন নেই। আপনাকে শুধু:

  1. আপনার অ্যাপে ব্যবহৃত API কী-তে Places API (নতুন) চালু করুন। আরও তথ্যের জন্য, 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.5.0'
      }

    kotlin-bom ডিপেন্ডেন্সি সম্পর্কে আরও তথ্যের জন্য, ট্রানজিটিভ ডিপেন্ডেন্সিতে লেটেস্ট kotlin-stdlib ভার্সনের ব্যবহার দেখুন।

  3. আপনার অ্যাপ চালু করতে নতুন Places.initializeWithNewPlacesApiEnabled() মেথড কল করার জন্য আপনার আগে থেকে থাকা অ্যাপ আপডেট করুন। আরও তথ্যের জন্য, Places API ক্লায়েন্ট চালু করুন দেখুন।

আপনার আগে থেকে থাকা অ্যাপগুলি অপরিবর্তিতভাবে কাজ করতে থাকবে, তবে আপনি এখন সমস্ত নতুন SDK ফিচারের সুবিধা নিতে পারবেন।