Xcode প্রোজেক্ট সেট-আপ করা

বিলিং চালু করা এবং API কী তৈরি করার পরে, আপনি অ্যাপ ডেভেলপ করার জন্য Xcode প্রোজেক্ট সেট-আপ করতে পারবেন।

প্রতিটি রিলিজের জন্য রিলিজ নোট উপলভ্য।

ধাপ ১: প্রয়োজনীয় সফ্টওয়্যার ইনস্টল করা

iOS-এর জন্য Navigation SDK ব্যবহার করে প্রোজেক্ট তৈরি করতে, আপনাকে অবশ্যই এগুলি ডাউনলোড ও ইনস্টল করতে হবে:

• Xcode ভার্সন 26.0 বা তার পরবর্তী যেকোনও ভার্সন

ধাপ ২: Xcode প্রোজেক্ট তৈরি করা এবং Navigation SDK ইনস্টল করা

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

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

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

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

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

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

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

ম্যানুয়ালি ইনস্টল করা iOS-এর জন্য আগে থেকে থাকা Navigation SDK সরাতে, এইসব ধাপ অনুসরণ করুন:

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

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

এই নির্দেশিকা থেকে জানতে পারবেন যে কীভাবে ম্যানুয়ালি XCFrameworks যোগ করতে হয়, যার মধ্যে iOS-এর জন্য নেভিগেশন SDK এবং আপনার প্রোজেক্টে iOS-এর জন্য Maps SDK থাকে এবং Xcode-এ আপনার বিল্ড সেটিংস কনফিগার করতে হয়। XCFramework হল একটি বাইনারি প্যাকেজ যা আপনি M1 চিপসেট ব্যবহার করা মেশিন সহ একাধিক প্ল্যাটফর্মে ব্যবহার করতে পারবেন

iOS-এর জন্য Navigation SDK এবং iOS-এর জন্য Maps SDK-এর XCFrameworks ইনস্টল করতে এইসব ধাপ অনুসরণ করুন:

1. নিম্নলিখিত SDK বাইনারি ও রিসোর্স ফাইল ডাউনলোড করুন:
   • GoogleMaps
   • GoogleMapsResources
   • GoogleNavigation
   • GoogleNavigationResources
2. Xcode চালু করে আগে থেকে থাকা কোনও প্রোজেক্ট খুলুন অথবা নতুন প্রোজেক্ট তৈরি করুন। আপনি iOS-এ নতুন হলে, নতুন প্রোজেক্ট তৈরি করে iOS অ্যাপ টেমপ্লেট বেছে নিন।
3. প্রোজেক্ট থেকে Maps, নেভিগেশন ও Places-এর সব রেফারেন্স সরিয়ে দিন।
   গুরুত্বপূর্ণ: iOS-এর জন্য Places SDK, iOS-এর জন্য Navigation SDK-এর সাথে অন্তর্ভুক্ত নয়, এবং আলাদাভাবে ইনস্টল করতে হবে। iOS-এর জন্য Places SDK-এর 5.0 ভার্সন থেকে এটি প্রযোজ্য। Google সাজেস্ট করে যে আপনি iOS-এর জন্য Places SDK এবং iOS-এর জন্য Navigation SDK-এর একই ভার্সন ডাউনলোড এবং ইনস্টল করুন। iOS-এর জন্য Places SDK ইনস্টল করুন দেখুন।
4. Maps ও Navigation SDK, দুটিই ইনস্টল করতে, নিম্নলিখিত XCFrameworks টেনে এনে আপনার প্রোজেক্টের ফ্রেমওয়ার্ক, লাইব্রেরি ও এম্বেড করা কন্টেন্ট বিকল্পের মধ্যে রাখুন (প্রম্পট করা হলে, প্রয়োজন হলে আইটেম কপি করুন বিকল্প বেছে নিন):
   • GoogleMaps.xcframework
   • GoogleNavigation.xcframework
5. আপনার ডাউনলোড করা GoogleMapsResources থেকে GoogleMaps.bundle টেনে এনে আপনার Xcode প্রোজেক্টের টপ লেভেল ডিরেক্টরিতে রাখুন। প্রম্পট করা হলে, প্রয়োজন হলে আইটেম কপি করুন বিকল্প বেছে নেওয়া হয়েছে কিনা তা নিশ্চিত করুন।
6. আপনার ডাউনলোড করা GoogleNavigationResources থেকে GoogleNavigation.bundle টেনে এনে আপনার Xcode প্রোজেক্টের টপ লেভেল ডিরেক্টরিতে রাখুন। প্রম্পট করা হলে, ডেস্টিনেশন গ্রুপের ফোল্ডারে আইটেম কপি করুন বিকল্পটি বেছে নেওয়া হয়েছে কিনা তা নিশ্চিত করুন।
7. প্রোজেক্ট নেভিগেটর থেকে আপনার প্রোজেক্ট বেছে নিন এবং আপনার অ্যাপ্লিকেশনের টার্গেট বেছে নিন।
8. বিল্ড ফেজ ট্যাব খুলুন এবং লাইব্রেরির সাথে বাইনারি লিঙ্ক করুন বিকল্পের মধ্যে, নিম্নলিখিত ফ্রেমওয়ার্ক ও লাইব্রেরি যোগ করুন:
   • Accelerate.framework
   • AudioToolbox.framework
   • AVFoundation.framework
   • CarPlay.framework
   • Contacts.framework
   • CoreData.framework
   • CoreGraphics.framework
   • CoreImage.framework
   • CoreLocation.framework
   • CoreTelephony.framework
   • CoreText.framework
   • GLKit.framework
   • ImageIO.framework
   • libc++.tbd
   • libxml2.tbd
   • libz.tbd
   • MapKit.framework
   • Metal.framework
   • OpenGLES.framework
   • QuartzCore.framework
   • Security.framework
   • SystemConfiguration.framework
   • UIKit.framework
   • UserNotifications.framework
   • WebKit.framework
9. আপনার অ্যাপ্লিকেশনের টার্গেটে, ক্ষমতা ট্যাব বেছে নিন, ব্যাকগ্রাউন্ড মোড চালু করুন এবং নিম্নলিখিত মোডগুলি চালু করুন:
   • অডিও, AirPlay ও ছবির-মধ্যে-ছবি
   • লোকেশন সংক্রান্ত আপডেট
10. নির্দিষ্ট টার্গেটের পরিবর্তে আপনার প্রোজেক্ট বেছে নিন এবং বিল্ড সেটিংস ট্যাব খুলুন। অন্যান্য লিঙ্কার ফ্ল্যাগ বিভাগে, ডিবাগ ও রিলিজ, দুটির জন্যই ‑ObjC যোগ করুন। এইসব সেটিংস দেখতে না পেলে, বিল্ড সেটিংস বারে ফিল্টার বেসিক থেকে সব-এ পরিবর্তন করুন।
    গুরুত্বপূর্ণ: SDK-তে Swift সিম্বল আছে। আপনি যদি সম্পূর্ণ Objective-C প্রোজেক্ট তৈরি করেন, তাহলে আপনাকে প্রোজেক্টে একটি খালি .swift ফাইল তৈরি করতে হবে অথবা Xcode প্রোজেক্টের অন্যান্য লিঙ্কার ফ্ল্যাগ বিভাগে নিম্নলিখিতগুলি যোগ করতে হবে।

    -L$(DEVELOPER_DIR)/Toolchains/XcodeDefault.xctoolchain/usr/lib/swift/$(PLATFORM_NAME)

11. Info.plist খুলে নিম্নলিখিত কী-ভ্যালু পেয়ার যোগ করুন:
    • কী: NSLocationWhenInUseUsageDescription (গোপনীয়তা - ব্যবহার করার সময় লোকেশন ব্যবহারের বিবরণ)
      ভ্যালু: "ধাপে ধাপে নেভিগেশনের জন্য এই অ্যাপের আপনার লোকেশন ব্যবহার করার অনুমতি প্রয়োজন।"
    • কী: NSLocationAlwaysAndWhenInUseUsageDescription (গোপনীয়তা - লোকেশন সবসময় এবং ব্যবহারের সময় ব্যবহারের বিবরণ)
      ভ্যালু: "ধাপে ধাপে নেভিগেশনের জন্য এই অ্যাপের আপনার লোকেশন ব্যবহার করার অনুমতি প্রয়োজন।"

ধাপ ৩: প্রোজেক্টে আপনার API key যোগ করুন

Xcode-এ আপনার প্রোজেক্টে কীভাবে API কী যোগ করতে হয় তা নিম্নলিখিত উদাহরণ থেকে জানতে পারবেন:

Swift

আপনার API key আপনার AppDelegate.swift-এ এইভাবে যোগ করুন:

1. নিম্নলিখিত ইমপোর্ট স্টেটমেন্ট যোগ করুন:

   import GoogleMaps
   import GoogleNavigation

2. আপনার application(_:didFinishLaunchingWithOptions:) পদ্ধতিতে নিম্নলিখিত তথ্য যোগ করুন:

   GMSServices.provideAPIKey("YOUR_API_KEY")

Objective-C

আপনার API key আপনার AppDelegate.m-এ এইভাবে যোগ করুন:

1. নিম্নলিখিত ইমপোর্ট স্টেটমেন্ট যোগ করুন:

   @import GoogleMaps;
   @import GoogleNavigation;

2. আপনার application:didFinishLaunchingWithOptions: পদ্ধতিতে নিম্নলিখিত তথ্য যোগ করুন:

   [GMSServices provideAPIKey:@"YOUR_API_KEY"];

ধাপ ৪ (ঐচ্ছিক): Apple গোপনীয়তা ম্যানিফেস্ট ফাইল পরীক্ষা করা

মনে রাখবেন: আপনি ওয়েব স্টোরে অ্যাপ ডিপ্লয় করলে নিম্নলিখিত তথ্য প্রাসঙ্গিক হবে।

App Store-এ থাকা অ্যাপের জন্য Apple-এর অ্যাপ গোপনীয়তা সংক্রান্ত বিবরণ প্রয়োজন। আপডেট ও আরও তথ্যের জন্য Apple App Store-এর গোপনীয়তা সংক্রান্ত বিবরণ পৃষ্ঠা দেখুন।

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

আপনি যদি মোবিলিটি পরিষেবার গ্রাহক হন

আপনি Mobility Services-এর গ্রাহক হলে, Mobility ডকুমেন্টেশন থেকে বিলিং সম্পর্কে জানুন। ট্রানজ্যাকশন রেকর্ড করা সম্পর্কে আরও জানতে, বিলিং সেট-আপ করুন বিকল্প দেখুন। আপনার Navigation SDK প্রয়োগে কীভাবে ট্রানজ্যাকশন আইডি যোগ করতে হয় তা জানতে, আপনার পরিষেবা ব্যবহারকে মোবিলিটি ট্রানজ্যাকশনের সাথে যুক্ত করুন দেখুন।

এর পরে কী করতে হবে

এখন আপনার কাছে API key এবং Xcode প্রোজেক্ট আছে, আপনি অ্যাপ তৈরি ও রান করতে পারবেন। iOS-এর জন্য Navigation SDK টিউটোরিয়াল প্রদান করে যা আপনাকে শুরু করতে সাহায্য করতে পারে। আরও জানতে, দেখুন:

• টিউটোরিয়াল
  • কোনও রুটে নেভিগেট করা
  • নেভিগেশন ইভেন্ট শোনা
• আপনার API key সুরক্ষিত করতে App Check ব্যবহার করা
• কোডের নমুনা ও কোডল্যাব