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 প্রোজেক্ট মালিকরা ব্যাকওয়ার্ড ইনকমপ্যাটিবল পরিবর্তন সম্পর্কে ইমেল পান যা তাদের প্রোজেক্টকে প্রভাবিত করতে পারে। ব্যাকওয়ার্ড ইনকম্প্যাটিবল পরিবর্তন সম্পর্কে আগে থেকেই বিজ্ঞপ্তি পেতে, আপনার প্রতিটি প্রোজেক্টের জন্য মনিটর করা ইমেল আইডির সাথে মালিকের ভূমিকা অ্যাসাইন করুন।

আপনি যদি Places SDK for Android ভার্সন 3.2.0 বা এর আগের কোনও ভার্সন থেকে আপগ্রেড করে থাকেন

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

  1. আপনার অ্যাপে ব্যবহৃত API key-তে Places API (নতুন) চালু করুন। আরও তথ্যের জন্য, API key ব্যবহার করা দেখুন।
  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 ফিচারের সুবিধা নিতে পারবেন।