একটি Xcode প্রকল্প সেট আপ করুন

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

প্রতিটি রিলিজের জন্য রিলিজ নোট পাওয়া যায়।

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

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

ধাপ ২: Xcode প্রজেক্ট তৈরি করুন এবং নেভিগেশন SDK ইনস্টল করুন।

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

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

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

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

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

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

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

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

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

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

  1. নিম্নলিখিত SDK বাইনারি এবং রিসোর্স ফাইলগুলি ডাউনলোড করুন:
  2. Xcode চালু করুন এবং একটি বিদ্যমান প্রজেক্ট খুলুন অথবা একটি নতুন প্রজেক্ট তৈরি করুন। আপনি যদি iOS-এ নতুন হন, তাহলে একটি নতুন প্রজেক্ট তৈরি করুন এবং iOS অ্যাপ টেমপ্লেটটি নির্বাচন করুন।
  3. প্রজেক্ট থেকে বিদ্যমান সমস্ত ম্যাপ, নেভিগেশন এবং প্লেসেস রেফারেন্স মুছে ফেলুন।
  4. Maps এবং Navigation SDK উভয়ই ইনস্টল করতে, নিম্নলিখিত XCFrameworks-গুলিকে আপনার প্রোজেক্টের Frameworks, Libraries, এবং Embedded Content-এর অধীনে ড্র্যাগ করুন ( প্রয়োজনে, নির্দেশিত হলে 'Copy items ' নির্বাচন করুন):
    • GoogleMaps.xcframework
    • GoogleNavigation.xcframework
  5. আপনার ডাউনলোড করা GoogleMapsResources থেকে GoogleMaps.bundle আপনার Xcode প্রজেক্টের টপ লেভেল ডিরেক্টরিতে ড্র্যাগ করে আনুন। প্রম্পট এলে, নিশ্চিত করুন যে ‘Copy items if needed’ অপশনটি সিলেক্ট করা আছে।
  6. আপনার ডাউনলোড করা GoogleNavigationResources থেকে GoogleNavigation.bundle আপনার Xcode প্রজেক্টের টপ লেভেল ডিরেক্টরিতে ড্র্যাগ করুন। প্রম্পট এলে, নিশ্চিত করুন যে ‘Copy items into destination group's folder’ অপশনটি সিলেক্ট করা আছে।
  7. প্রজেক্ট নেভিগেটর থেকে আপনার প্রজেক্টটি নির্বাচন করুন এবং আপনার অ্যাপ্লিকেশনের লক্ষ্য বেছে নিন।
  8. Build Phases ট্যাবটি খুলুন এবং Link Binary with Libraries-এর মধ্যে নিম্নলিখিত ফ্রেমওয়ার্ক ও লাইব্রেরিগুলো যোগ করুন:
    • 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. আপনার অ্যাপ্লিকেশনের টার্গেটে, Capabilities ট্যাবটি নির্বাচন করুন, Background Modes চালু করুন এবং নিম্নলিখিত মোডগুলি সক্রিয় করুন:
    • অডিও, এয়ারপ্লে এবং পিকচার ইন পিকচার
    • অবস্থান আপডেট
  10. কোনো নির্দিষ্ট টার্গেটের পরিবর্তে আপনার প্রজেক্টটি বেছে নিন এবং বিল্ড সেটিংস ট্যাবটি খুলুন। আদার লিঙ্কার ফ্ল্যাগস (Other Linker Flags) সেকশনে, ডিবাগ এবং রিলিজ উভয়ের জন্য ‑ObjC যোগ করুন। যদি এই সেটিংসগুলো দেখা না যায়, তাহলে বিল্ড সেটিংস বারের ফিল্টারটি বেসিক (Basic) থেকে অল (All)- এ পরিবর্তন করুন।
  11. Info.plist খুলুন এবং নিম্নলিখিত কী-ভ্যালু পেয়ারগুলো যোগ করুন:
    • Key: NSLocationWhenInUseUsageDescription ( গোপনীয়তা - ব্যবহারের সময় অবস্থানের ব্যবহারের বিবরণ )
      মান: "ধাপে ধাপে দিকনির্দেশনার জন্য এই অ্যাপটির আপনার অবস্থান ব্যবহার করার অনুমতি প্রয়োজন।"
    • Key: NSLocationAlwaysAndWhenInUseUsageDescription ( গোপনীয়তা - অবস্থান সর্বদা এবং ব্যবহারের সময় ব্যবহারের বিবরণ )
      মান: "ধাপে ধাপে দিকনির্দেশনার জন্য এই অ্যাপটির আপনার অবস্থান ব্যবহার করার অনুমতি প্রয়োজন।"

কোকোপড

iOS-এর জন্য নেভিগেশন SDK একটি CocoaPods পড হিসেবে উপলব্ধ। CocoaPods হলো Swift এবং Objective-C Cocoa প্রোজেক্টের জন্য একটি ওপেন সোর্স ডিপেন্ডেন্সি ম্যানেজার।

আপনার কাছে যদি আগে থেকেই CocoaPods টুলটি না থাকে, তাহলে টার্মিনাল থেকে নিম্নলিখিত কমান্ডটি চালিয়ে macOS-এ এটি ইনস্টল করুন। বিস্তারিত জানতে, CocoaPods Getting Started গাইডটি দেখুন।

sudo gem install cocoapods

iOS-এর জন্য নেভিগেশন SDK-এর একটি Podfile তৈরি করুন এবং এটি ব্যবহার করে API ও এর নির্ভরতাগুলি ইনস্টল করুন:

  1. আপনার যদি এখনও কোনো Xcode প্রজেক্ট না থাকে, তাহলে এখনই একটি তৈরি করে আপনার লোকাল মেশিনে সেভ করুন। আপনি যদি iOS ডেভেলপমেন্টে নতুন হন:
    1. একটি নতুন প্রকল্প তৈরি করুন।
    2. iOS > অ্যাপ টেমপ্লেট নির্বাচন করুন।
    3. প্রজেক্ট অপশন স্ক্রিনে:
      1. প্রকল্পের নাম লিখুন।
      2. বান্ডেল আইডেন্টিফায়ার ফিল্ডের মানটি রেকর্ড করুন। আপনি নিচে আপনার এপিআই কী সীমাবদ্ধ করতে সেই মানটি ব্যবহার করতে পারেন।
      3. প্রজেক্ট ইন্টারফেসটি স্টোরিবোর্ডে সেট করুন।
      4. ভাষাটি সুইফট অথবা অবজেক্টিভ-সি- তে সেট করুন।
  2. আপনার প্রজেক্ট ডিরেক্টরিতে Podfile নামে একটি ফাইল তৈরি করুন। এই ফাইলটি আপনার প্রজেক্টের ডিপেন্ডেন্সিগুলো নির্ধারণ করে।
  3. Podfile সম্পাদনা করুন এবং আপনার ডিপেন্ডেন্সিগুলো তাদের ভার্সনসহ যোগ করুন। এখানে একটি উদাহরণ দেওয়া হলো, যেখানে iOS-এর জন্য নেভিগেশন SDK-এর প্রয়োজনীয় ডিপেন্ডেন্সিটি অন্তর্ভুক্ত রয়েছে: # Cocoapods ইনস্টল রেফারেন্স #
    source 'https://github.com/CocoaPods/Specs.git'

platform :ios, '16.0'

target 'YOUR_APPLICATION_TARGET_NAME_HERE' do
  pod 'GoogleNavigation', '10.10.0'
end
    নতুন সংস্করণগুলি সনাক্ত করতে নিয়মিতভাবে pod outdated চালান। প্রয়োজনে, সর্বশেষ সংস্করণে আপগ্রেড করুন ।
  4. Podfile সংরক্ষণ করুন।

  5. একটি টার্মিনাল খুলুন এবং Podfile যে ডিরেক্টরিতে আছে সেখানে যান:

    cd <path-to-project>

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

    pod install

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

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

  1. একটি টার্মিনাল খুলুন এবং Podfile টি যে প্রজেক্ট ডিরেক্টরিতে রয়েছে, সেখানে যান।
  2. pod update কমান্ডটি চালান। এটি Podfile এ উল্লেখিত সমস্ত API-কে সর্বশেষ সংস্করণে আপডেট করে।

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

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

সুইফট

আপনার AppDelegate.swift ফাইলে নিম্নলিখিতভাবে আপনার API কী যোগ করুন:

  1. নিম্নলিখিত ইম্পোর্ট স্টেটমেন্টগুলো যোগ করুন: 
    import GoogleMaps
import GoogleNavigation
  2. আপনার application(_:didFinishLaunchingWithOptions:) মেথডে নিম্নলিখিতটি যোগ করুন: 
    GMSServices.provideAPIKey("YOUR_API_KEY")

উদ্দেশ্য-সি

আপনার AppDelegate.m এ আপনার API কী নিম্নলিখিতভাবে যোগ করুন:

  1. নিম্নলিখিত ইম্পোর্ট স্টেটমেন্টগুলো যোগ করুন: 
    @import GoogleMaps;
@import GoogleNavigation;
  2. আপনার application:didFinishLaunchingWithOptions: মেথডে নিম্নলিখিতটি যোগ করুন: 
    [GMSServices provideAPIKey:@"YOUR_API_KEY"];

ধাপ ৪ (ঐচ্ছিক): অ্যাপল প্রাইভেসি ম্যানিফেস্ট ফাইলটি পরিদর্শন করুন

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

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

আপনি যদি মোবিলিটি সার্ভিসেস-এর গ্রাহক হন

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

এরপর কী?

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