iOS ভার্সনের জন্য ড্রাইভার SDK

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

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

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

    সুবিধা:

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

    সুবিধা:

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

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

ইনস্টল করা

আপনার ডিপেন্ডেন্সিতে সবসময় ভার্সন নম্বর উল্লেখ করুন, অপ্টিমিস্টিক অপারেটর (~>) ব্যবহার করবেন না, কারণ এর ফলে অপ্রত্যাশিত ও পুনরাবৃত্তি করা যায় না এমন বিল্ড তৈরি হতে পারে। iOS-এর জন্য Driver SDK সিম্যান্টিক ভার্সনিং মেনে চলে এবং নতুন মেজর ভার্সন রিলিজের মধ্যে ব্রেকিং পরিবর্তন অন্তর্ভুক্ত থাকে।

CocoaPods

Podfile সিনট্যাক্স ব্যবহার করে Podfile ডিপেন্ডেন্সির একটি উদাহরণ:

      source "https://github.com/CocoaPods/Specs.git"

      target 'YOUR_APPLICATION_TARGET_NAME_HERE' do
        pod 'GoogleRidesharingDriver', '2.0.0'
      end
    

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

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

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

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

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

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

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

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

Cocoapods

  1. টার্মিনাল খুলে Podfile থাকা ডিরেক্টরিতে যান:

    cd <path-to-project>
  2. iOS-এর জন্য Driver SDK-এর নতুন ভার্সন উপলভ্য আছে কিনা তা দেখতে pod outdated রান করুন।
  3. SDK-এর নতুন ভার্সন পাওয়া গেলে, আপনার Podfile এই নতুন ভার্সনে আপডেট করুন। আপনার Podfile-এ কীভাবে নির্দিষ্ট ভার্সন সেট করবেন তা জানতে পড ভার্সন নির্দিষ্ট করা দেখুন।
  4. pod update রান করুন।
  5. আপগ্রেড করার ফলে প্রয়োজনীয় যেকোনও পরিবর্তন করুন। প্রতিটি রিলিজে হওয়া পরিবর্তনের তালিকা দেখতে রিলিজ নোট দেখুন।
  6. প্রোডাক্ট > ক্লিন এবং তারপর প্রোডাক্ট > বিল্ড বিকল্প বেছে নিয়ে আপনার প্রোজেক্ট ক্লিন ও রিবিল্ড করুন

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

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

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