ড্রাইভার SDK পান

এই বিভাগে বর্ণনা করা হয়েছে কীভাবে আপনার সিস্টেম ন্যূনতম প্রয়োজনীয়তা পূরণ করে কিনা তা যাচাই করবেন, আপনার ওয়ার্কস্পেস গ্রুপ সেট আপ করবেন এবং ড্রাইভার এসডিকে (SDK) পাবেন।

শুরু করার আগে

iOS-এর জন্য ড্রাইভার SDK ব্যবহার করতে হলে আপনার অ্যাপটিকে নিম্নলিখিত শর্তগুলো পূরণ করতে হবে:

• নেভিগেশন এসডিকে আছে।
• আপনার গুগল ক্লাউড কনসোলে iOS-এর জন্য Maps SDK সক্রিয় করুন এবং একটি API কী সংগ্রহ করুন।

ন্যূনতম সিস্টেমের প্রয়োজনীয়তাগুলো যাচাই করুন

আপনি যে ড্রাইভার এসডিকে সংস্করণটি ব্যবহার করছেন তার ন্যূনতম প্রয়োজনীয়তা জানতে রিলিজ নোট দেখুন। রিলিজ নোট দেখুন।

• মোবাইল ডিভাইসটিতে অবশ্যই iOS 16 বা তার পরবর্তী সংস্করণ চলতে হবে।
• অ্যাপল এক্সকোড সংস্করণ ২৬ বা তার পরবর্তী সংস্করণ।

আপনার গুগল ওয়ার্কস্পেসে অ্যাক্সেস পান

আপনি যদি গুগল ওয়ার্কস্পেসের গ্রাহক হন, তাহলে নিম্নলিখিত ধাপগুলো অনুসরণ করুন:

1. একটি ওয়ার্কস্পেস গ্রুপ তৈরি করুন। আরও তথ্যের জন্য, ওয়ার্কস্পেস গ্রুপ দেখুন।

   উদাহরণস্বরূপ, একটি উত্তম অনুশীলন হিসেবে, অনবোর্ডিংয়ের সময় আপনার গ্রুপের নাম [e-mail] রাখুন।

2. সঠিক CocoaPods রিপোজিটরিগুলোতে অ্যাক্সেস দেওয়ার জন্য, আপনার ওয়ার্কস্পেস গ্রুপকে একটি অনুমতি তালিকায় (allowlist) যুক্ত করতে Google-কে নামটি প্রদান করুন।

3. নিশ্চিত করুন যে, যেসব ব্যবহারকারীর ইমেল এবং পরিষেবা অ্যাকাউন্টের ইমেলে অ্যাক্সেস প্রয়োজন, সেগুলো এই তালিকায় অন্তর্ভুক্ত আছে।

যদি আপনার সংস্থা ওয়ার্কস্পেস গ্রুপ তৈরি করতে না পারে, তাহলে গুগলকে সেইসব ব্যবহারকারী এবং পরিষেবা অ্যাকাউন্টের ইমেলের একটি তালিকা পাঠান যাদের এই আর্টিফ্যাক্টগুলিতে অ্যাক্সেস প্রয়োজন।

দ্রষ্টব্য: ওয়ার্কস্পেস গ্রুপ এবং গুগল গ্রুপ এক নয় , কারণ গুগল গ্রুপের নামের শেষে @googlegroups.com থাকে। শুধুমাত্র ওয়ার্কস্পেস গ্রুপই সমর্থিত।

ক্লাউড এসডিকে দিয়ে সাইন ইন করুন

স্থানীয় ডেভেলপমেন্টের জন্য ক্লাউড এসডিকে দিয়ে সাইন ইন করুন। বিস্তারিত জানতে, gcloud CLI ইনস্টল করুন দেখুন।

নিম্নলিখিত উদাহরণগুলিতে ক্লাউড এসডিকে ব্যবহার করে কীভাবে সাইন ইন করতে হয় তা দেখানো হয়েছে।

জিক্লাউড

gcloud auth login

আপনাকে অবশ্যই এমন একটি ইমেল ব্যবহার করতে হবে যা ওয়ার্কস্পেস গ্রুপের সদস্য।

আপনার অটোমেশন হোস্টগুলি সেট আপ করুন

বিল্ড সিস্টেম বা কন্টিনিউয়াস ইন্টিগ্রেশনের জন্য, গুগল এপিআই এবং পরিষেবাগুলিতে প্রমাণীকরণের উদ্দেশ্যে সার্ভিস অ্যাকাউন্ট ব্যবহারের জন্য প্রদত্ত পদ্ধতির তালিকার উপর ভিত্তি করে আপনার অটোমেশন হোস্টগুলি সেট আপ করুন। বিস্তারিত জানতে, 'Authentication methods at Google' পৃষ্ঠার সার্ভিস অ্যাকাউন্ট বিভাগটি দেখুন।

• আপনার প্রসেসটি যদি গুগল ক্লাউড পরিবেশে চলে, তাহলে স্বয়ংক্রিয় ক্রেডেনশিয়াল ডিটেকশন ব্যবহার করুন। আরও তথ্যের জন্য, স্বয়ংক্রিয় ক্রেডেনশিয়াল ডিটেকশন দেখুন।

• অন্যথায়, সার্ভিস অ্যাকাউন্ট কী ফাইলটি হোস্টের ফাইল-সিস্টেমের একটি সুরক্ষিত স্থানে সংরক্ষণ করুন এবং GOOGLE_APPLICATION_CREDENTIALS এনভায়রনমেন্ট ভেরিয়েবলটি যথাযথভাবে সেট করুন। আরও বিস্তারিত জানতে, GOOGLE_APPLICATION_CREDENTIALS দেখুন।

ক্রেডেনশিয়ালগুলির সাথে যুক্ত সার্ভিস অ্যাকাউন্টের ইমেলটি অবশ্যই ওয়ার্কস্পেস গ্রুপের সদস্য হতে হবে।

ড্রাইভার এসডিকে পান

ড্রাইভার এসডিকে ইনস্টল ও কনফিগার করুন।

কোকোপড

1. CocoaPods টুলটি ইনস্টল করুন : একটি টার্মিনাল উইন্ডো খুলুন এবং নিম্নলিখিত কমান্ডটি চালান।

   sudo gem install cocoapods
   

   আরও বিস্তারিত জানতে, CocoaPods Get Started গাইডটি দেখুন।

2. ড্রাইভার SDK-এর জন্য একটি Podfile তৈরি করুন : API এবং এর নির্ভরতাগুলো ইনস্টল করার জন্য আপনি Podfile ব্যবহার করেন।

   1. আপনার প্রজেক্ট ডিরেক্টরিতে Podfile নামে একটি ফাইল তৈরি করুন। এই ফাইলটি আপনার প্রজেক্টের ডিপেন্ডেন্সিগুলো নির্ধারণ করে।

   2. Podfile সম্পাদনা করুন এবং আপনার ডিপেন্ডেন্সিগুলো যোগ করুন। এখানে একটি উদাহরণ দেওয়া হলো, যেখানে ডিপেন্ডেন্সিগুলো অন্তর্ভুক্ত রয়েছে:

      source "https://github.com/CocoaPods/Specs.git"
      
      target 'YOUR_APPLICATION_TARGET_NAME_HERE' do
        pod 'GoogleRidesharingDriver'
      end
      

      এখানে একটি উদাহরণ দেওয়া হলো, যেখানে ড্রাইভার এসডিকে-এর আলফা এবং বিটা পডগুলো ডিপেন্ডেন্সি হিসেবে অন্তর্ভুক্ত রয়েছে:

      source "https://cpdc-eap.googlesource.com/ridesharing-driver-sdk.git"
      source "https://github.com/CocoaPods/Specs.git"
      
      target 'YOUR_APPLICATION_TARGET_NAME_HERE' do
        pod 'GoogleRidesharingDriver'
      end
      

   3. Podfile সংরক্ষণ করুন : একটি টার্মিনাল খুলুন এবং Podfile-টি যে ফোল্ডারে আছে সেখানে যান:

      cd <path-to-project>
      

3. `pod install` কমান্ডটি চালান : এই কমান্ডটি Podfile-এ উল্লেখিত API-গুলো এবং সেগুলোর সম্ভাব্য নির্ভরতাগুলো ইনস্টল করবে।

   pod install
   

4. আপনার প্রজেক্টটি Xcode-এ খুলুন : Xcode বন্ধ করুন, এবং তারপর Xcode চালু করতে আপনার প্রজেক্টের .xcworkspace ফাইলটি খুলুন (ডাবল-ক্লিক করুন)। পরবর্তীতে প্রজেক্টটি খোলার জন্য .xcworkspace ফাইলটি ব্যবহার করুন।

   দ্রষ্টব্য: SDK-এর নতুন সংস্করণ এলে তা শনাক্ত করতে নির্দিষ্ট সময় পর পর pod outdated চালান। আরও তথ্যের জন্য, `Driver SDK for iOS Versions` দেখুন।

সুইফট প্যাকেজ ম্যানেজার

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

নতুন বা বিদ্যমান প্রকল্পে SDK যোগ করতে, এই ধাপগুলো অনুসরণ করুন:

1. আপনার Xcode project বা workspace খুলুন, তারপর File > Add Package Dependencies- এ যান।
2. URL হিসেবে https://github.com/googlemaps/ios-driver-sdk লিখুন, প্যাকেজটি যুক্ত করতে এন্টার চাপুন এবং 'Add Package'-এ ক্লিক করুন।
3. একটি নির্দিষ্ট version ইনস্টল করতে, ' ডিপেন্ডেন্সি রুল' ফিল্ডটিকে সংস্করণ-ভিত্তিক বিকল্পগুলির মধ্যে একটিতে সেট করুন। নতুন প্রোজেক্টের জন্য, আমরা সর্বশেষ সংস্করণটি নির্দিষ্ট করার এবং 'এক্সাক্ট ভার্সন' বিকল্পটি ব্যবহার করার পরামর্শ দিই। এটি সম্পন্ন হলে, 'অ্যাড প্যাকেজ'-এ ক্লিক করুন।

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

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

গুরুত্বপূর্ণ: কখনও কখনও, আর্টিফ্যাক্টগুলি সমাধান করা যায় না বা ত্রুটি দেখা দিতে পারে, সেক্ষেত্রে 'ফাইল > প্যাকেজ > প্যাকেজ ক্যাশে রিসেট করুন' নির্বাচন করুন।

ম্যানুয়ালি ইনস্টল করা বিদ্যমান ড্রাইভার এসডিকে অপসারণ করতে, এই ধাপগুলো অনুসরণ করুন:

1. আপনার Xcode প্রোজেক্টের কনফিগারেশন সেটিংস থেকে Frameworks, Libraries, and Embedded Content খুঁজুন। নিম্নলিখিত ফ্রেমওয়ার্কটি অপসারণ করতে মাইনাস চিহ্ন (-) ব্যবহার করুন:

   • GoogleRidesharingDriver.xcframework

2. আপনার Xcode প্রজেক্টের শীর্ষ ডিরেক্টরি থেকে GoogleRidesharingDriver বান্ডেলটি সরিয়ে ফেলুন।

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

এই নির্দেশিকায় দেখানো হয়েছে কীভাবে ড্রাইভার SDK সম্বলিত XCFramework-টি আপনার প্রোজেক্টে ম্যানুয়ালি যোগ করবেন এবং Xcode-এ আপনার বিল্ড সেটিংস কনফিগার করবেন।

সতর্কতা : সর্বোত্তম পন্থা হিসেবে, যখনই সম্ভব ড্রাইভার এসডিকে ইনস্টল করার জন্য কোকোপডস (Cocoapods) ব্যবহার করুন।

এই নির্দেশিকা অনুসরণ করার আগে, নিম্নলিখিত কাজগুলো করুন:

• XCFramework ডাউনলোড করুন, এটি একটি বাইনারি প্যাকেজ যা আপনি ড্রাইভার SDK ইনস্টল করতে ব্যবহার করেন। আপনি এই প্যাকেজটি অ্যাপল সিলিকন ব্যবহারকারী মেশিন সহ একাধিক প্ল্যাটফর্মে ব্যবহার করতে পারেন।

• নেভিগেশন এসডিকে ইনস্টল করুন।

ড্রাইভার এসডিকে ম্যানুয়ালি ইনস্টল করতে নিম্নলিখিত ধাপগুলি অনুসরণ করুন:

1. SDK বাইনারি এবং রিসোর্স ডাউনলোড করুন:

   • GoogleRidesharingDriver.xcframework
   • GoogleRidesharingDriver.bundle

2. XCFramework এবং রিসোর্সগুলো অ্যাক্সেস করতে জিপ করা ফাইলগুলো আনপ্যাক করুন।

3. Xcode চালু করুন এবং একটি বিদ্যমান প্রজেক্ট খুলুন অথবা একটি নতুন প্রজেক্ট তৈরি করুন। আপনি যদি iOS-এ নতুন হন, তাহলে একটি নতুন প্রজেক্ট তৈরি করুন এবং iOS অ্যাপ টেমপ্লেটটি নির্বাচন করুন।

4. আপনার প্রজেক্ট গ্রুপে যদি ফ্রেমওয়ার্কস গ্রুপ না থাকে, তাহলে সেটি তৈরি করুন।

5. ড্রাইভার SDK ইনস্টল করতে, GoogleRidesharingDriver.xcframework ফাইলটি আপনার প্রোজেক্টের Frameworks, Libraries, and Embedded Content-এর অধীনে ড্র্যাগ করে আনুন। অনুরোধ করা হলে, Copy items নির্বাচন করুন।

6. ডাউনলোড করা GoogleRidesharingDriver.bundle ফাইলটি আপনার Xcode প্রজেক্টের টপ-লেভেল ডিরেক্টরিতে ড্র্যাগ করুন। অনুরোধ করা হলে, ‘Copy items’ নির্বাচন করুন।

7. প্রজেক্ট নেভিগেটর থেকে আপনার প্রজেক্টটি নির্বাচন করুন এবং আপনার অ্যাপ্লিকেশনের লক্ষ্য বেছে নিন।

8. Build Phases ট্যাবটি খুলুন এবং Link Binary with Libraries অংশে, নিম্নলিখিত ফ্রেমওয়ার্ক ও লাইব্রেরিগুলো আগে থেকে উপস্থিত না থাকলে যোগ করুন:

   • Accelerate.framework
   • AudioToolbox.framework
   • AVFoundation.framework
   • CoreData.framework
   • CoreGraphics.framework
   • CoreLocation.framework
   • CoreTelephony.framework
   • CoreText.framework
   • GLKit.framework
   • ImageIO.framework
   • libc++.tbd
   • libxml2.tbd
   • libz.tbd
   • LocalAuthentication.framework
   • OpenGLES.framework
   • QuartzCore.framework
   • SystemConfiguration.framework
   • UIKit.framework
   • WebKit.framework

9. কোনো নির্দিষ্ট টার্গেটের পরিবর্তে আপনার প্রজেক্টটি বেছে নিন এবং বিল্ড সেটিংস ট্যাবটি খুলুন। আদার লিঙ্কার ফ্ল্যাগস (Other Linker Flags) সেকশনে, ডিবাগ এবং রিলিজ উভয়ের জন্য -ObjC যোগ করুন।

   যদি এই সেটিংসগুলি দেখা না যায়, তাহলে বিল্ড সেটিংস বারে থাকা ফিল্টারটি 'বেসিক' থেকে 'অল'- এ পরিবর্তন করুন।

অ্যাপল প্রাইভেসি ম্যানিফেস্ট ফাইলটি পরিদর্শন করুন

অ্যাপ স্টোরে থাকা অ্যাপগুলোর জন্য অ্যাপলের গোপনীয়তার বিবরণ প্রয়োজন। আপডেট এবং আরও তথ্যের জন্য অ্যাপল অ্যাপ স্টোর প্রাইভেসি ডিটেইলস পেজটি দেখুন।

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

এরপর কী?

একটি গুগল ক্লাউড কনসোল প্রজেক্ট কনফিগার করুন