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

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

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

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

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

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

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

Swift Package Manager

Swift প্যাকেজ ম্যানেজার-এর মাধ্যমে Navigation SDK ইনস্টল করা যেতে পারে। 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-এর জন্য আগে থেকে থাকা নেভিগেশন SDK সরাতে, এইসব ধাপ অনুসরণ করুন:

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

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

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

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

1. নিম্নলিখিত SDK বাইনারি ও রিসোর্স ফাইল ডাউনলোড করুন:
   • GoogleMaps
   • GoogleMapsResources
   • GoogleNavigation
   • GoogleNavigationResources
2. Xcode চালু করে আগে থেকে থাকা কোনও প্রোজেক্ট খুলুন অথবা নতুন প্রোজেক্ট তৈরি করুন। আপনি iOS-এ নতুন হলে, নতুন প্রোজেক্ট তৈরি করে iOS অ্যাপ টেমপ্লেট বেছে নিন।
3. প্রোজেক্ট থেকে আগে থাকা সব Maps, নেভিগেশন ও জায়গার রেফারেন্স সরিয়ে দিন।
   গুরুত্বপূর্ণ: iOS-এর জন্য নেভিগেশন SDK-তে iOS-এর জন্য Places SDK অন্তর্ভুক্ত থাকে না, এবং এটি আলাদাভাবে ইনস্টল করতে হয়। iOS-এর জন্য Places SDK-এর 5.0 ভার্সন থেকে এটি প্রযোজ্য। Google সাজেস্ট করে যে আপনি iOS-এর জন্য Places SDK এবং iOS-এর জন্য Navigation SDK-এর একই ভার্সন ডাউনলোড ও ইনস্টল করুন। iOS-এর জন্য Places SDK ইনস্টল করুন দেখুন।
4. Maps ও Navigation SDK, দুটিই ইনস্টল করতে, নিম্নলিখিত XCFrameworks আপনার প্রোজেক্টের Frameworks, Libraries, and Embedded Content-এর মধ্যে টেনে আনুন (প্রম্পট করা হলে, প্রয়োজন হলে আইটেম কপি করুন বিকল্প বেছে নিন):
   • 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. নির্দিষ্ট টার্গেটের পরিবর্তে আপনার প্রোজেক্ট বেছে নিন এবং বিল্ড সেটিংস ট্যাব খুলুন। অন্যান্য লিঙ্কার ফ্ল্যাগ বিভাগে, debug ও release, দু'টির জন্যই ‑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

আপনার AppDelegate.swift-এ নিম্নলিখিত উপায়ে API key যোগ করুন:

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

   import GoogleMaps
   import GoogleNavigation

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

   GMSServices.provideAPIKey("YOUR_API_KEY")

Objective-C

আপনার AppDelegate.m-এ নিম্নলিখিত উপায়ে API key যোগ করুন:

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

   @import GoogleMaps;
   @import GoogleNavigation;

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

   [GMSServices provideAPIKey:@"YOUR_API_KEY"];

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

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

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

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

আপনি Mobility Services-এর গ্রাহক হলে

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

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

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

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