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

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

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

কোন ভার্সনের সাথে লিঙ্ক করতে চান?

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

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

  সুবিধা:

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

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

  সুবিধা:

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

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

ইনস্টল করা

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

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

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

1. আপনার Xcode project বা workspace খুলুন, তারপর ফাইল > প্যাকেজ ডিপেন্ডেন্সি যোগ করুন বিকল্পে যান।
2. URL হিসেবে https://github.com/googlemaps/ios-maps-sdk লিখুন, প্যাকেজটি পুল করতে Enter প্রেস করুন এবং "প্যাকেজ যোগ করুন" বিকল্পে ক্লিক করুন।
3. নির্দিষ্ট version ইনস্টল করতে, নির্ভরতা সংক্রান্ত নিয়ম ফিল্ডকে ভার্সন-ভিত্তিক বিকল্পগুলির মধ্যে একটি হিসেবে সেট করুন। নতুন প্রোজেক্টের জন্য, আমরা লেটেস্ট ভার্সন উল্লেখ করা এবং "সঠিক ভার্সন" বিকল্প ব্যবহার করার সাজেশন দিই। সম্পূর্ণ হয়ে গেলে, "প্যাকেজ যোগ করুন" বিকল্পে ক্লিক করুন।
4. প্যাকেজ প্রোডাক্ট বেছে নিন উইন্ডো থেকে, যাচাই করুন যে GoogleMaps (9.0.0-এর আগের ভার্সনের জন্য, যাচাই করুন যে 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. Podfile, Podfile.resolved এবং Xcode workspace CocoaPods ছাড়া অন্য কিছুর জন্য ব্যবহার না করলে সেগুলি সরিয়ে দিন।

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

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

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

To update the package for an existing project, follow these steps:

  

    
    
    

      To verify your installation, go to the Package Dependencies section of Project Navigator
      to verify the package and its version.
    
  
  
  

    Important: Sometimes, artifacts cannot be resolved or errors can occur, 
    in this case select "File > Packages > Reset Package Cache".
  

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

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

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