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

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

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

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

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

  সুবিধা:

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

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

  সুবিধা:

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

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

ইনস্টল করা

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

মনে রাখবেন: iOS-এর জন্য Driver SDK, Carthage ব্যবহার করে ইনস্টল করা যায় না।

CocoaPods

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

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

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

Swift Package Manager

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