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

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

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

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

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

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

1. আপনি যদি 9.0.0-এর আগের কোনও ভার্সন থেকে আপগ্রেড করেন, তাহলে আপগ্রেড করার পরে আপনাকে নিম্নলিখিত ডিপেন্ডেন্সিগুলি সরাতে হবে: GoogleMapsBase, GoogleMapsCore এবং GoogleMapsM4B। GoogleMaps-এর জন্য নির্ভরতা সরাবেন না। আরও তথ্যের জন্য, ভার্সন 9.0.0 রিলিজ নোট দেখুন।

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

   • GoogleMapsBase (শুধুমাত্র 9.0.0-এর আগের ভার্সন থেকে আপগ্রেড করার জন্য)
   • GoogleMapsCore (শুধুমাত্র 9.0.0-এর আগের ভার্সন থেকে আপগ্রেড করার জন্য)
   • GoogleMapsM4B (শুধুমাত্র 9.0.0-এর আগের ভার্সন থেকে আপগ্রেড করার জন্য)
2. Xcode থেকে, ফাইল > প্যাকেজ > লেটেস্ট প্যাকেজ ভার্সনে আপডেট করুন বিকল্পে যান।
3. আপনার ইনস্টলেশন যাচাই করতে, প্রোজেক্ট নেভিগেটর-এর প্যাকেজ ডিপেন্ডেন্সি বিভাগে যান যাতে প্যাকেজ ও তার ভার্সন যাচাই করতে পারেন।

CocoaPods ব্যবহার করে যোগ করা iOS-এর জন্য Maps SDK-এর বিদ্যমান ডিপেন্ডেন্সি সরাতে, এই ধাপগুলি অনুসরণ করুন:

1. আপনার Xcode ওয়ার্কস্পেস বন্ধ করুন। টার্মিনাল খুলে নিম্নলিখিত কমান্ডটি এক্সিকিউট করুন:

   sudo gem install cocoapods-deintegrate cocoapods-clean
   pod deintegrate
   pod cache clean --all

2. Podfile, Podfile.resolved এবং Xcode workspace CocoaPods ছাড়া অন্য কিছুর জন্য ব্যবহার না করলে সেগুলি সরিয়ে দিন।

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

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

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

1. নিম্নলিখিত SDK বাইনারি ও রিসোর্স ফাইল ডাউনলোড করুন:
   • GoogleMaps
   • GoogleMapsResources
2. XCFrameworks এবং রিসোর্স অ্যাক্সেস করতে ফাইল এক্সট্র্যাক্ট করুন।
3. আপনার কাছে এখনও কোনও Xcode প্রোজেক্ট না থাকলে, এখনই একটি তৈরি করুন এবং আপনার লোকাল মেশিনে সেভ করুন। আপনি iOS ডেভেলপমেন্টে নতুন হলে:
   1. নতুন প্রোজেক্ট তৈরি করুন।
   2. iOS > অ্যাপ টেমপ্লেট বেছে নিন।
   3. প্রোজেক্ট বিকল্পের স্ক্রিনে:
      1. প্রোজেক্টের নাম লিখুন।
      2. বান্ডিল শনাক্তকারী ফিল্ডের ভ্যালু রেকর্ড করুন। নিচে আপনার API key সীমিত করতে আপনি সেই ভ্যালু ব্যবহার করতে পারবেন।
      3. প্রোজেক্টের ইন্টারফেস স্টোরিবোর্ড হিসেবে সেট করুন।
      4. ভাষা Swift বা Objective-C-তে সেট করুন।
4. সাধারণ ট্যাব খুলুন। ফ্রেমওয়ার্ক, লাইব্রেরি ও এম্বেড করা কন্টেন্ট বিকল্পের অধীনে আপনার প্রোজেক্টে নিম্নলিখিত XCFrameworks টেনে আনুন। এম্বেড করবেন না বিকল্পটি বেছে নিতে ভুলবেন না:
   • GoogleMaps.xcframework
5. আপনার Xcode প্রোজেক্টের টপ লেভেল ডিরেক্টরিতে ডাউনলোড করা GoogleMapsResources থেকে GoogleMaps.bundle কপি করুন। প্রম্পট করা হলে, গন্তব্য গ্রুপের ফোল্ডারে আইটেম কপি করুন বিকল্প বেছে নিতে ভুলবেন না।
6. প্রোজেক্ট নেভিগেটর থেকে আপনার প্রোজেক্ট বেছে নিন এবং আপনার অ্যাপ্লিকেশনের টার্গেট বেছে নিন।
7. আপনার অ্যাপ্লিকেশনের টার্গেটের জন্য বিল্ড ফেজ ট্যাব খুলুন। লাইব্রেরির সাথে বাইনারি লিঙ্ক করুন বিকল্পের মধ্যে, নিম্নলিখিত ফ্রেমওয়ার্ক ও লাইব্রেরি যোগ করুন:
   • Accelerate.framework
   • Contacts.framework
   • CoreData.framework
   • CoreGraphics.framework
   • CoreImage.framework
   • CoreLocation.framework
   • CoreTelephony.framework
   • CoreText.framework
   • GLKit.framework
   • ImageIO.framework
   • libc++.tbd
   • libz.tbd
   • Metal.framework
   • MetricKit.framework
   • OpenGLES.framework (আপনি OpenGL ব্যবহার করলে তবেই)
   • QuartzCore.framework
   • Security.framework
   • SystemConfiguration.framework
   • UIKit.framework

8. নির্দিষ্ট টার্গেটের পরিবর্তে আপনার প্রোজেক্ট বেছে নিন এবং বিল্ড সেটিংস ট্যাব খুলুন। লিঙ্ক করা - সাধারণ -> অন্যান্য লিঙ্কার ফ্ল্যাগ বিভাগে, "ডিবাগ" ও "রিলিজ" বিকল্পে -ObjC যোগ করুন। এইসব সেটিংস দেখতে না পেলে, বিল্ড সেটিংস বারে ফিল্টার প্রাথমিক থেকে সব-এ পরিবর্তন করুন।

9. iOS XCFramework-এর জন্য Places SDK ইনস্টল করতে, iOS-এর জন্য Places SDK-এর মাধ্যমে শুরু করুন দেখুন।

Swift

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

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

   import GoogleMaps

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

   GMSServices.provideAPIKey("YOUR_API_KEY")

3. আপনি Places API ব্যবহার করলে, এখানে দেখানো পদ্ধতি অনুযায়ী আবার আপনার 'কী' যোগ করুন:

   GMSPlacesClient.provideAPIKey("YOUR_API_KEY")

Objective-C

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

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

   @import GoogleMaps;

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

   [GMSServices provideAPIKey:@"YOUR_API_KEY"];

3. আপনি Places API ব্যবহার করলে, এখানে দেখানো পদ্ধতি অনুযায়ী আবার আপনার 'কী' যোগ করুন:

   [GMSPlacesClient provideAPIKey:@"YOUR_API_KEY"];