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

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

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

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

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

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

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

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

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

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

iOS এর জন্য Navigation SDK এর জন্য XCFrameworks এবং iOS এর জন্য Maps SDK ইনস্টল করতে এই পদক্ষেপগুলি অনুসরণ করুন:

1. নিম্নলিখিত SDK বাইনারি এবং রিসোর্স ফাইলগুলি ডাউনলোড করুন:
   • গুগল ম্যাপস
   • গুগল ম্যাপসরিসোর্স
   • গুগল নেভিগেশন
   • গুগল নেভিগেশন রিসোর্স
2. Xcode চালু করুন এবং হয় একটি বিদ্যমান প্রকল্প খুলুন, অথবা একটি নতুন প্রকল্প তৈরি করুন। আপনি যদি iOS এ নতুন হন, তাহলে একটি নতুন প্রকল্প তৈরি করুন এবং iOS অ্যাপ টেমপ্লেট নির্বাচন করুন।
3. প্রকল্প থেকে বিদ্যমান সমস্ত মানচিত্র, নেভিগেশন এবং স্থানের রেফারেন্সগুলি সরিয়ে ফেলুন।
4. Maps এবং Navigation SDK উভয়ই ইনস্টল করার জন্য Frameworks, Libraries এবং Embedded Content এর অধীনে নিম্নলিখিত XCFrameworks টেনে আনুন (প্রস্তাবিত হলে, প্রয়োজনে Copy items নির্বাচন করুন):
   • GoogleMaps.xcframework
   • GoogleNavigation.xcframework
5. আপনার ডাউনলোড করা GoogleMapsResources থেকে GoogleMaps.bundle টেনে আপনার Xcode প্রজেক্টের শীর্ষ স্তরের ডিরেক্টরিতে আনুন। অনুরোধ করা হলে, প্রয়োজনে Copy items নির্বাচন করা আছে কিনা তা নিশ্চিত করুন।
6. আপনার ডাউনলোড করা GoogleNavigationResources থেকে GoogleNavigation.bundle টেনে আপনার Xcode প্রজেক্টের শীর্ষ স্তরের ডিরেক্টরিতে আনুন। অনুরোধ করা হলে, নিশ্চিত করুন যে আইটেমগুলি গন্তব্য গ্রুপের ফোল্ডারে কপি করুন নির্বাচন করা হয়েছে।
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. নির্দিষ্ট লক্ষ্যের পরিবর্তে আপনার প্রকল্পটি বেছে নিন এবং বিল্ড সেটিংস ট্যাবটি খুলুন। অন্যান্য লিঙ্কার ফ্ল্যাগ বিভাগে, ডিবাগ এবং রিলিজ উভয়ের জন্য ‑ObjC যোগ করুন। যদি এই সেটিংস দৃশ্যমান না হয়, তাহলে বিল্ড সেটিংস বারের ফিল্টারটি বেসিক থেকে All এ পরিবর্তন করুন।
11. Info.plist খুলুন এবং নিম্নলিখিত কী-মান জোড়া যোগ করুন:
    • কী: NSLocationWhenInUseUsageDescription ( গোপনীয়তা - ব্যবহারের সময় অবস্থান ব্যবহারের বিবরণ )
      মান: "এই অ্যাপটির আপনার অবস্থান ব্যবহার করে ধাপে ধাপে নেভিগেশনের অনুমতি প্রয়োজন।"
    • কী: NSLocationAlwaysAndWhenInUseUsageDescription ( গোপনীয়তা - অবস্থান সর্বদা এবং কখন ব্যবহারে ব্যবহার বিবরণ )
      মান: "এই অ্যাপটির আপনার অবস্থান ব্যবহার করে ধাপে ধাপে নেভিগেশনের অনুমতি প্রয়োজন।"

কোকোপডস

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

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

sudo gem install cocoapods

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

1. যদি আপনার এখনও কোনও Xcode প্রকল্প না থাকে, তাহলে এখনই একটি তৈরি করুন এবং এটি আপনার স্থানীয় মেশিনে সংরক্ষণ করুন। আপনি যদি iOS ডেভেলপমেন্টে নতুন হন:
   1. একটি নতুন প্রকল্প তৈরি করুন।
   2. iOS > অ্যাপ টেমপ্লেটটি নির্বাচন করুন।
   3. প্রকল্পের বিকল্প স্ক্রিনে:
      1. প্রকল্পের নাম লিখুন।
      2. বান্ডেল আইডেন্টিফায়ার ফিল্ডের মান রেকর্ড করুন। আপনি নীচে আপনার API কী সীমাবদ্ধ করতে সেই মানটি ব্যবহার করতে পারেন।
      3. প্রোজেক্ট ইন্টারফেসটি স্টোরিবোর্ডে সেট করুন।
      4. ভাষাটি Swift অথবা Objective-C তে সেট করুন।
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.4.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 গুলিকে সর্বশেষ সংস্করণে আপডেট করে।

সুইফট

আপনার 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"];