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

আপনি বিলিং সক্ষম করার পরে এবং একটি API কী তৈরি করার পরে, আপনি Xcode প্রকল্পটি সেট আপ করতে প্রস্তুত যা আপনি আপনার অ্যাপ বিকাশ করতে ব্যবহার করেন৷

রিলিজ নোট প্রতিটি রিলিজের জন্য উপলব্ধ.

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

iOS এর জন্য Places SDK ব্যবহার করে একটি প্রকল্প তৈরি করতে, আপনার প্রয়োজন:

• Xcode সংস্করণ 15.0 বা তার পরে

ধাপ 2: Xcode প্রকল্প তৈরি করুন এবং iOS এর জন্য Places SDK ইনস্টল করুন

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

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

গুরুত্বপূর্ণ: এই নির্দেশাবলী Xcode 15 বা তার পরবর্তী ব্যবহার অনুমান করে, কিন্তু Xcode-এর পূর্ববর্তী সংস্করণগুলির জন্য অনুরূপ হওয়া উচিত।

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

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

   আপনি যদি অপসারিত GitHub URL থেকে Google Places Swift আপডেট করছেন

   গুরুত্বপূর্ণ: Google Places Swift অ্যাক্সেস করার জন্য GitHub URL 0.3.0 সংস্করণ থেকে শুরু করে পরিবর্তিত হয়েছে। আপনি যদি পুরানো URL, https://github.com/googlemaps/ios-places-swift-sdk মাধ্যমে অ্যাক্সেস করা GooglePlacesSwift-এর একটি সংস্করণ আপডেট করছেন, তাহলে এটিকে আপনার Xcode-এর প্যাকেজ নির্ভরতা বিভাগ থেকে সরিয়ে দিন।

5. আপনার ইনস্টলেশন যাচাই করতে, আপনার লক্ষ্যের সাধারণ ফলকে নেভিগেট করুন। ফ্রেমওয়ার্ক, লাইব্রেরি এবং এমবেডেড সামগ্রীতে , আপনার ইনস্টল করা প্যাকেজগুলি দেখতে হবে। আপনি প্যাকেজ এবং এর সংস্করণ যাচাই করতে প্রকল্প নেভিগেটরের প্যাকেজ নির্ভরতা বিভাগটিও দেখতে পারেন। Xcode GitHub সংস্করণ দেখায়, যা GooglePlaces এর সংস্করণের সাথে মেলে (উদাহরণস্বরূপ 9.2.0) কিন্তু GooglePlacesSwift এর সংস্করণের সাথে মেলে না (উদাহরণস্বরূপ 0.3.0)।

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

1. এক্সকোড থেকে, "ফাইল> প্যাকেজ> সর্বশেষ প্যাকেজ সংস্করণে আপডেট" এ যান।

   আপনি যদি অপসারিত GitHub URL থেকে Google Places Swift আপডেট করছেন

   গুরুত্বপূর্ণ: Google Places Swift অ্যাক্সেস করার জন্য GitHub URL 0.3.0 সংস্করণ থেকে শুরু করে পরিবর্তিত হয়েছে। আপনি যদি পুরানো URL, https://github.com/googlemaps/ios-places-swift-sdk মাধ্যমে অ্যাক্সেস করা GooglePlacesSwift-এর একটি সংস্করণ আপডেট করছেন, তাহলে এটিকে আপনার Xcode-এর প্যাকেজ নির্ভরতা বিভাগ থেকে সরিয়ে দিন।

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

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

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

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

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

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

1. নিম্নলিখিত SDK বাইনারি এবং সংস্থান ফাইলগুলি ডাউনলোড করুন:
   • GooglePlaces
   • GooglePlaces সম্পদ
2. আপনি যদি iOS (প্রিভিউ) এর জন্য Places Swift SDK ইনস্টল করে থাকেন, তাহলে নিম্নলিখিত ফাইলগুলি ইনস্টল করুন:
   • GooglePlacesSwift
   • GooglePlacesSwiftResources
3. XCFramework এবং সংস্থানগুলি অ্যাক্সেস করতে ফাইলগুলি বের করুন৷
4. Xcode চালু করুন এবং হয় একটি বিদ্যমান প্রকল্প খুলুন, অথবা একটি নতুন প্রকল্প তৈরি করুন। আপনি iOS ডেভেলপমেন্টে নতুন হলে, একটি নতুন প্রকল্প তৈরি করুন এবং iOS অ্যাপ টেমপ্লেট নির্বাচন করুন।
5. আপনার প্রোজেক্ট থেকে আগের রিলিজ থেকে যেকোনও ম্যাপ বান্ডিল সরান।
6. সাধারণ ট্যাব খুলুন। ফ্রেমওয়ার্ক, লাইব্রেরি এবং এমবেডেড কন্টেন্টের অধীনে নিম্নলিখিত XCFrameworkটিকে আপনার প্রকল্পে টেনে আনুন। এম্বেড করবেন না নির্বাচন নিশ্চিত করুন:
   • GooglePlaces.xcframework
   আপনি যদি iOS (প্রিভিউ) এর জন্য Places Swift SDK ইন্সটল করছেন, তাহলে নিচের XCFrameworkটিকে আপনার প্রজেক্টে Frameworks, Libraries এবং Embedded Content-এর অধীনে টেনে আনুন। এম্বেড করবেন না নির্বাচন নিশ্চিত করুন:
   • GooglePlacesSwift.xcframework
7. আপনার Xcode প্রকল্পের শীর্ষ স্তরের ডিরেক্টরিতে আপনার ডাউনলোড করা GooglePlacesResources থেকে GooglePlaces.bundle টি অনুলিপি করুন৷ অনুরোধ করা হলে গন্তব্য গোষ্ঠীর ফোল্ডারে আইটেমগুলি অনুলিপি নির্বাচন করতে ভুলবেন না৷
   
   আপনি যদি iOS এর জন্য Places Swift SDK ইনস্টল করেন (প্রিভিউ), আপনার Xcode প্রকল্পের শীর্ষ স্তরের ডিরেক্টরিতে ডাউনলোড করা GooglePlacesSwiftResources থেকে GooglePlacesSwift.bundle টি অনুলিপি করুন। অনুরোধ করা হলে গন্তব্য গোষ্ঠীর ফোল্ডারে আইটেমগুলি অনুলিপি নির্বাচন করতে ভুলবেন না৷
8. প্রজেক্ট নেভিগেটর থেকে আপনার প্রজেক্ট সিলেক্ট করুন এবং আপনার অ্যাপ্লিকেশনের টার্গেট বেছে নিন।
9. বিল্ড ফেজ ট্যাব খুলুন। লাইব্রেরির সাথে বাইনারি লিঙ্কের মধ্যে, নিম্নলিখিত ফ্রেমওয়ার্ক এবং লাইব্রেরি যোগ করুন:
   • CoreGraphics.framework
   • CoreLocation.framework
   • libc++.tbd
   • libz.tbd
   • QuartzCore.framework
   • UIKit.framework

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

কোকোপডস

iOS এর জন্য Places SDK এবং iOS এর জন্য Places Swift SDK (প্রিভিউ) CocoaPod পড, GooglePlaces এবং GooglePlacesSwift হিসাবে উপলব্ধ।

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

sudo gem install cocoapods

SDK এবং তাদের নির্ভরতা ইনস্টল করতে একটি Podfile তৈরি করুন:

1. আপনার যদি এখনও একটি Xcode প্রকল্প না থাকে তবে এখনই একটি তৈরি করুন এবং এটি আপনার স্থানীয় মেশিনে সংরক্ষণ করুন। আপনি iOS ডেভেলপমেন্টে নতুন হলে, একটি নতুন প্রকল্প তৈরি করুন এবং iOS অ্যাপ টেমপ্লেট নির্বাচন করুন।
2. আপনার প্রকল্প ডিরেক্টরিতে Podfile নামে একটি ফাইল তৈরি করুন। এই ফাইলটি আপনার প্রকল্পের নির্ভরতা সংজ্ঞায়িত করে।
3. Podfile সম্পাদনা করুন এবং তাদের সংস্করণ সহ আপনার নির্ভরতা যোগ করুন। এখানে একটি উদাহরণ রয়েছে যা আপনার অ্যাপ্লিকেশনের টার্গেট নাম এবং GooglePlaces এবং GooglePlacesSwift পডের নাম উল্লেখ করে:

   source 'https://github.com/CocoaPods/Specs.git'
   
   platform :ios, '15.0'
   
   target 'YOUR_APPLICATION_TARGET_NAME_HERE' do
     pod 'GooglePlaces', '9.2.0'
     pod 'GooglePlacesSwift', '0.3.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 সর্বশেষ সংস্করণে আপডেট করবে।

ধাপ 3: আপনার অ্যাপে API কী যোগ করুন

নিম্নলিখিত উদাহরণগুলিতে, আপনার API কী দিয়ে YOUR_API_KEY প্রতিস্থাপন করুন।

সুইফট

নিম্নরূপ আপনার AppDelegate.swift এ আপনার API কী যোগ করুন:

• নিম্নলিখিত আমদানি বিবৃতি যোগ করুন:

  import GooglePlaces

• আপনার এপিআই কী দিয়ে YOUR_API_KEY প্রতিস্থাপন করে আপনার application(_:didFinishLaunchingWithOptions:) পদ্ধতিতে নিম্নলিখিত যোগ করুন:

  GMSPlacesClient.provideAPIKey("YOUR_API_KEY")

উদ্দেশ্য-C

নিম্নরূপ আপনার AppDelegate.m এ আপনার API কী যোগ করুন:

• নিম্নলিখিত আমদানি বিবৃতি যোগ করুন:

  @import GooglePlaces;

• আপনার application:didFinishLaunchingWithOptions: পদ্ধতি, আপনার API কী দিয়ে YOUR_API_KEY প্রতিস্থাপন করুন:

  [GMSPlacesClient provideAPIKey:@"YOUR_API_KEY"];

GooglePlacesSwift

নিম্নরূপ আপনার AppDelegate.swift এ আপনার API কী যোগ করুন:

• নিম্নলিখিত আমদানি বিবৃতি যোগ করুন:

  import GooglePlacesSwift

• আপনার এপিআই কী দিয়ে YOUR_API_KEY প্রতিস্থাপন করে আপনার application(_:didFinishLaunchingWithOptions:) পদ্ধতিতে নিম্নলিখিত যোগ করুন:

  PlacesClient.provideAPIKey("YOUR_API_KEY")

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

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

অ্যাপলের অ্যাপ স্টোরে অ্যাপের জন্য অ্যাপের গোপনীয়তার বিবরণ প্রয়োজন। আপডেট এবং আরও তথ্যের জন্য অ্যাপল অ্যাপ স্টোরের গোপনীয়তা বিবরণ পৃষ্ঠাতে যান।

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

পরবর্তী পদক্ষেপ

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