iOS ভার্সনের জন্য Maps SDK

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

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

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

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

    সুবিধা:

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

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

    সুবিধা:

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

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

ইনস্টল করা

Swift Package Manager

iOS-এর জন্য Maps SDK Swift Package Manager-এর মাধ্যমে ইনস্টল করা যেতে পারে। SDK যোগ করতে, iOS-এর জন্য Maps SDK-এর উপর নির্ভর করে এমন কোনও কিছু আপনি সরিয়ে দিয়েছেন কিনা তা নিশ্চিত করুন।

নতুন বা আগে থেকে থাকা প্রোজেক্টে SDK যোগ করতে, এইসব ধাপ অনুসরণ করুন:

  1. আপনার Xcode project বা workspace খুলুন, তারপর ফাইল > প্যাকেজ ডিপেন্ডেন্সি যোগ করুন বিকল্পে যান।
  2. URL হিসেবে https://github.com/googlemaps/ios-maps-sdk লিখুন, প্যাকেজটি পেতে Enter কী টিপুন এবং "প্যাকেজ যোগ করুন" বিকল্পে ক্লিক করুন।
  3. নির্দিষ্ট version ইনস্টল করতে, নির্ভরতা সংক্রান্ত নিয়ম ফিল্ডকে ভার্সন-ভিত্তিক বিকল্পগুলির মধ্যে একটি হিসেবে সেট করুন। নতুন প্রোজেক্টের জন্য, আমরা লেটেস্ট ভার্সন উল্লেখ করা এবং "সঠিক ভার্সন" বিকল্প ব্যবহার করার সাজেশন দিই। সম্পূর্ণ হয়ে গেলে, "প্যাকেজ যোগ করুন" বিকল্পে ক্লিক করুন।
  4. প্যাকেজ প্রোডাক্ট বেছে নিন উইন্ডো থেকে, GoogleMaps (৯.০.০-এর আগের ভার্সনের জন্য, GoogleMaps, GoogleMapsBase এবং GoogleMapsCore) আপনার নির্দিষ্ট করা main টার্গেটে যোগ করা হবে কিনা তা যাচাই করুন। সম্পূর্ণ হয়ে গেলে, "প্যাকেজ যোগ করুন" বিকল্পে ক্লিক করুন।
  5. ইনস্টলেশন যাচাই করতে, টার্গেটের সাধারণ প্যানেলে নেভিগেট করুন। ফ্রেমওয়ার্ক, লাইব্রেরি ও এম্বেড করা কন্টেন্ট-এ ইনস্টল করা প্যাকেজ দেখতে পাবেন। এছাড়াও, প্যাকেজ ও এর ভার্সন যাচাই করতে, আপনি "প্রজেক্ট নেভিগেটর" -এর "প্যাকেজ ডিপেন্ডেন্সি" বিভাগ দেখতে পারেন।

আগে থেকে থাকা কোনও প্রজেক্টের জন্য package আপডেট করতে, এইসব ধাপ ফলো করুন:

  1. আপনি যদি 9.0.0-এর আগের কোনও ভার্সন থেকে আপগ্রেড করেন, তাহলে আপগ্রেড করার পরে আপনাকে অবশ্যই নিম্নলিখিত ডিপেন্ডেন্সিগুলি সরাতে হবে: GoogleMapsBase, GoogleMapsCore এবং GoogleMapsM4B। GoogleMaps-এর জন্য ডিপেন্ডেন্সি সরাবেন না। আরও তথ্যের জন্য, 9.0.0 ভার্সনের রিলিজ নোট দেখুন।

    আপনার Xcode প্রোজেক্ট কনফিগারেশন সেটিংস থেকে, ফ্রেমওয়ার্ক, লাইব্রেরি, এবং এম্বেড করা কন্টেন্ট বিকল্প খুঁজুন। নিচের ফ্রেমওয়ার্ক সরাতে মাইনাস চিহ্ন(-) ব্যবহার করুন:

    • GoogleMapsBase (শুধুমাত্র 9.0.0-এর আগের ভার্সন থেকে আপগ্রেড করার জন্য)
    • GoogleMapsCore (শুধুমাত্র 9.0.0-এর আগের ভার্সন থেকে আপগ্রেড করার জন্য)
    • GoogleMapsM4B (শুধুমাত্র 9.0.0-এর আগের ভার্সন থেকে আপগ্রেড করার জন্য)
  2. Xcode থেকে, ফাইল > প্যাকেজ > লেটেস্ট প্যাকেজ ভার্সনে আপডেট করুন বিকল্পে যান।
  3. আপনার ইনস্টলেশন যাচাই করতে, প্রোজেক্ট নেভিগেটর-এর প্যাকেজ ডিপেন্ডেন্সি বিভাগে যান এবং প্যাকেজ ও এর ভার্সন যাচাই করুন।

CocoaPods ব্যবহার করে যোগ করা iOS ডিপেন্ডেন্সির জন্য আগে থেকে থাকা Maps SDK সরাতে, এই ধাপগুলি অনুসরণ করুন:

  1. আপনার Xcode ওয়ার্কস্পেস বন্ধ করুন। টার্মিনাল খুলে নিম্নলিখিত কমান্ডটি এক্সিকিউট করুন: 
    sudo gem install cocoapods-deintegrate cocoapods-clean
pod deintegrate
pod cache clean --all
  2. CocoaPods ছাড়া অন্য কোনও কিছুর জন্য ব্যবহার না করলে, Podfile, Podfile.resolved এবং Xcode workspace সরিয়ে দিন।

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

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

Swift প্যাকেজ ম্যানেজার

আগে থেকে থাকা প্রোজেক্টের জন্য package আপডেট করতে, এই ধাপগুলি অনুসরণ করুন:

  1. আপনার ইনস্টলেশন যাচাই করতে, প্রোজেক্ট নেভিগেটর-এর প্যাকেজ ডিপেন্ডেন্সি বিভাগে যান এবং প্যাকেজ ও এর ভার্সন যাচাই করুন।

ম্যানুয়াল ইনস্টলেশন

SDK ইনস্টল করার সময় লেটেস্ট সোর্স ফাইলের লিঙ্ক পান ।

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