বিলিং সক্ষম করার পরে এবং একটি API কী তৈরি করার পরে, আপনি আপনার অ্যাপটি তৈরি করতে যে Xcode প্রকল্পটি ব্যবহার করেন তা সেট আপ করতে প্রস্তুত।
প্রতিটি প্রকাশের জন্য রিলিজ নোট পাওয়া যায়।
ধাপ ১: প্রয়োজনীয় সফ্টওয়্যার ইনস্টল করুন
iOS এর জন্য Places SDK ব্যবহার করে একটি প্রকল্প তৈরি করতে, আপনার প্রয়োজন:
- এক্সকোড সংস্করণ ২৬.০ বা তার পরবর্তী
ধাপ ২: Xcode প্রজেক্ট তৈরি করুন এবং iOS এর জন্য Places SDK ইনস্টল করুন।
সুইফট প্যাকেজ ম্যানেজার
iOS এর জন্য Places SDK Swift Package Manager এর মাধ্যমে ইনস্টল করা যেতে পারে। SDK যোগ করতে, নিশ্চিত করুন যে আপনি iOS নির্ভরতার জন্য বিদ্যমান Places SDK সরিয়ে ফেলেছেন।
একটি নতুন বা বিদ্যমান প্রকল্পে SDK যোগ করতে, এই পদক্ষেপগুলি অনুসরণ করুন:
- আপনার Xcode
projectবাworkspaceখুলুন, তারপর File > Add Package Dependencies এ যান। - URL হিসেবে https://github.com/googlemaps/ios-places-sdk লিখুন, প্যাকেজটি টেনে আনতে এন্টার টিপুন এবং "প্যাকেজ যোগ করুন" এ ক্লিক করুন।
- একটি নির্দিষ্ট
versionইনস্টল করতে, নির্ভরতা নিয়ম ক্ষেত্রটি সংস্করণ-ভিত্তিক বিকল্পগুলির মধ্যে একটিতে সেট করুন। নতুন প্রকল্পগুলির জন্য, আমরা সর্বশেষ সংস্করণটি নির্দিষ্ট করে "সঠিক সংস্করণ" বিকল্পটি ব্যবহার করার পরামর্শ দিচ্ছি। সম্পূর্ণ হয়ে গেলে, "প্যাকেজ যোগ করুন" এ ক্লিক করুন। - "প্যাকেজ পণ্য নির্বাচন করুন" উইন্ডো থেকে, যাচাই করুন যে
GooglePlaces,GooglePlacesSwift, অথবা উভয়ই আপনার নির্ধারিত প্রধান লক্ষ্যবস্তুতে যোগ করা হয়েছে। সম্পূর্ণ হয়ে গেলে, "প্যাকেজ যোগ করুন" এ ক্লিক করুন।যদি আপনি অবচিত GitHub URL থেকে Google Places Swift আপডেট করেন
গুরুত্বপূর্ণ: Google Places Swift অ্যাক্সেস করার জন্য GitHub URL 0.3.0 সংস্করণ থেকে পরিবর্তিত হয়েছে। যদি আপনি GooglePlacesSwift এর এমন একটি সংস্করণ আপডেট করেন যা পুরানো URL,
https://github.com/googlemaps/ios-places-swift-sdkএর মাধ্যমে অ্যাক্সেস করা হয়েছিল, তাহলে এটি আপনার Xcode এর প্যাকেজ নির্ভরতা বিভাগ থেকে সরিয়ে দিন। - আপনার ইনস্টলেশন যাচাই করতে, আপনার টার্গেটের জেনারেল প্যানে নেভিগেট করুন। ফ্রেমওয়ার্ক, লাইব্রেরি এবং এমবেডেড কন্টেন্টে , আপনি ইনস্টল করা প্যাকেজগুলি দেখতে পাবেন। প্যাকেজ এবং এর সংস্করণ যাচাই করতে আপনি প্রজেক্ট নেভিগেটরের প্যাকেজ নির্ভরতা বিভাগটিও দেখতে পারেন।
বিদ্যমান প্রকল্পের package আপডেট করতে, এই পদক্ষেপগুলি অনুসরণ করুন:
- এক্সকোড থেকে, "ফাইল > প্যাকেজ > সর্বশেষ প্যাকেজ সংস্করণে আপডেট করুন" এ যান।
যদি আপনি অবচিত GitHub URL থেকে Google Places Swift আপডেট করেন
গুরুত্বপূর্ণ: Google Places Swift অ্যাক্সেস করার জন্য GitHub URL 0.3.0 সংস্করণ থেকে পরিবর্তিত হয়েছে। যদি আপনি GooglePlacesSwift এর এমন একটি সংস্করণ আপডেট করেন যা পুরানো URL,
https://github.com/googlemaps/ios-places-swift-sdkএর মাধ্যমে অ্যাক্সেস করা হয়েছিল, তাহলে এটি আপনার Xcode এর প্যাকেজ নির্ভরতা বিভাগ থেকে সরিয়ে দিন। - আপনার ইনস্টলেশন যাচাই করতে, প্যাকেজ এবং এর সংস্করণ যাচাই করতে প্রজেক্ট নেভিগেটরের প্যাকেজ নির্ভরতা বিভাগে যান।
ম্যানুয়ালি ইনস্টল করা বিদ্যমান Places SDK for iOS অপসারণ করতে, এই পদক্ষেপগুলি অনুসরণ করুন:
- আপনার Xcode প্রজেক্ট কনফিগারেশন সেটিংস থেকে, Frameworks, Libraries, এবং Embedded Content খুঁজুন। নিম্নলিখিত ফ্রেমওয়ার্কগুলি সরাতে বিয়োগ চিহ্ন (-) ব্যবহার করুন:
-
GooglePlaces.xcframework -
GooglePlacesSwift.xcframework
-
- আপনার Xcode প্রকল্পের শীর্ষ স্তরের ডিরেক্টরি থেকে,
GooglePlacesবান্ডেলটি সরিয়ে ফেলুন।
ম্যানুয়াল ইনস্টলেশন
এই নির্দেশিকাটি দেখায় কিভাবে আপনার প্রোজেক্টে Places SDK for iOS এবং Places Swift SDK for iOS সম্বলিত XCFrameworks ম্যানুয়ালি যোগ করবেন এবং Xcode-এ আপনার বিল্ড সেটিংস কনফিগার করবেন। XCFramework হল একটি বাইনারি প্যাকেজ যা আপনি একাধিক প্ল্যাটফর্মে ব্যবহার করতে পারেন, যার মধ্যে Apple silicon ব্যবহার করে এমন মেশিনও অন্তর্ভুক্ত। আপনি iOS-এর জন্য Places SDK, iOS-এর জন্য Places Swift SDK, অথবা উভয়ই যোগ করতে পারেন।
- নিম্নলিখিত SDK বাইনারি এবং রিসোর্স ফাইলগুলি ডাউনলোড করুন:
- আপনি যদি iOS এর জন্য Places Swift SDK ইনস্টল করেন, তাহলে নিম্নলিখিত ফাইলগুলি ইনস্টল করুন:
- XCFramework এবং রিসোর্স অ্যাক্সেস করতে ফাইলগুলি এক্সট্র্যাক্ট করুন।
- Xcode চালু করুন এবং হয় একটি বিদ্যমান প্রকল্প খুলুন, অথবা একটি নতুন প্রকল্প তৈরি করুন। আপনি যদি iOS ডেভেলপমেন্টে নতুন হন, তাহলে একটি নতুন প্রকল্প তৈরি করুন এবং iOS অ্যাপ টেমপ্লেট নির্বাচন করুন।
- আপনার প্রোজেক্টের পূর্ববর্তী রিলিজ থেকে যেকোনো ম্যাপ বান্ডেল সরিয়ে ফেলুন।
- "General" ট্যাবটি খুলুন। Frameworks, Libraries, and Embedded Content এর অধীনে নিম্নলিখিত XCFramework টি আপনার প্রোজেক্টে টেনে আনুন। "Do Not Embed" নির্বাচন করতে ভুলবেন না:
-
GooglePlaces.xcframework
-
GooglePlacesSwift.xcframework
-
- আপনার Xcode প্রজেক্টের শীর্ষ স্তরের ডিরেক্টরিতে ডাউনলোড করা GooglePlacesResources থেকে
GooglePlaces.bundleকপি করুন। অনুরোধ করা হলে Copy items into destination group এর ফোল্ডার নির্বাচন করতে ভুলবেন না।
যদি আপনি Places Swift SDK ইনস্টল করেন, তাহলে আপনার Xcode প্রজেক্টের শীর্ষ স্তরের ডিরেক্টরিতে ডাউনলোড করা GooglePlacesSwiftResources থেকেGooglePlacesSwift.bundleকপি করুন। অনুরোধ করা হলে Copy items into destination group এর ফোল্ডার নির্বাচন করতে ভুলবেন না। - প্রজেক্ট নেভিগেটর থেকে আপনার প্রজেক্ট নির্বাচন করুন এবং আপনার অ্যাপ্লিকেশনের লক্ষ্য নির্বাচন করুন।
- " বিল্ড ফেজেস" ট্যাবটি খুলুন। "লিঙ্ক বাইনারি উইথ লাইব্রেরি" এর মধ্যে, নিম্নলিখিত ফ্রেমওয়ার্ক এবং লাইব্রেরিগুলি যুক্ত করুন:
-
CoreGraphics.framework -
CoreLocation.framework -
libc++.tbd -
libz.tbd -
QuartzCore.framework -
UIKit.framework
-
নির্দিষ্ট লক্ষ্যের পরিবর্তে আপনার প্রকল্পটি বেছে নিন এবং বিল্ড সেটিংস ট্যাবটি খুলুন। লিঙ্কিং - জেনারেল -> অন্যান্য লিঙ্কার ফ্ল্যাগ বিভাগে, "ডিবাগ" এবং "রিলিজ"-এ
-ObjCযোগ করুন। যদি এই সেটিংসগুলি দৃশ্যমান না হয়, তাহলে বিল্ড সেটিংস বারের ফিল্টারটি বেসিক থেকে All এ পরিবর্তন করুন।
কোকোপডস
iOS এর জন্য Places SDK এবং iOS এর জন্য Places Swift SDK CocoaPod পড, GooglePlaces এবং GooglePlacesSwift হিসাবে উপলব্ধ।
CocoaPods হল Swift এবং Objective-C Cocoa প্রকল্পের জন্য একটি ওপেন সোর্স ডিপেন্ডেন্সি ম্যানেজার। যদি আপনার কাছে ইতিমধ্যে CocoaPods টুল না থাকে, তাহলে টার্মিনাল থেকে নিম্নলিখিত কমান্ডটি চালিয়ে macOS-এ এটি ইনস্টল করুন। বিস্তারিত জানার জন্য, CocoaPods শুরু করার নির্দেশিকা দেখুন।
sudo gem install cocoapods
SDK এবং তাদের নির্ভরতা ইনস্টল করার জন্য একটি Podfile তৈরি করুন:
- যদি আপনার এখনও কোনও Xcode প্রকল্প না থাকে, তাহলে এখনই একটি তৈরি করুন এবং আপনার স্থানীয় মেশিনে সংরক্ষণ করুন। যদি আপনি iOS ডেভেলপমেন্টে নতুন হন, তাহলে একটি নতুন প্রকল্প তৈরি করুন এবং iOS অ্যাপ টেমপ্লেট নির্বাচন করুন।
- আপনার প্রোজেক্ট ডিরেক্টরিতে
Podfileনামে একটি ফাইল তৈরি করুন। এই ফাইলটি আপনার প্রোজেক্টের নির্ভরতা নির্ধারণ করে। -
Podfileসম্পাদনা করুন এবং তাদের সংস্করণগুলির সাথে আপনার নির্ভরতাগুলি যুক্ত করুন। এখানে একটি উদাহরণ যা আপনার অ্যাপ্লিকেশন টার্গেটের নাম এবংGooglePlacesএবংGooglePlacesSwiftপডগুলির নাম নির্দিষ্ট করে:source 'https://github.com/CocoaPods/Specs.git' platform :ios, '16.0' target 'YOUR_APPLICATION_TARGET_NAME_HERE' do pod 'GooglePlaces', '10.8.0' pod 'GooglePlacesSwift', '10.8.0' end
pod outdatedচালাতে ভুলবেন না যাতে আপনি সর্বদা সর্বশেষ আপডেটে থাকেন। -
Podfileসংরক্ষণ করুন। একটি টার্মিনাল খুলুন এবং
Podfileধারণকারী ডিরেক্টরিতে যান:cd <path-to-project>
pod installকমান্ডটি চালান। এটিPodfileএ উল্লেখিত API গুলি, এবং তাদের যেকোনো নির্ভরতা ইনস্টল করবে।pod install
Xcode বন্ধ করুন, এবং তারপর Xcode চালু করতে আপনার প্রোজেক্টের
.xcworkspaceফাইলটি খুলুন (ডাবল-ক্লিক করুন)। এখন থেকে, প্রোজেক্টটি খুলতে আপনাকে.xcworkspaceফাইলটি ব্যবহার করতে হবে।
বিদ্যমান প্রকল্পের জন্য API আপডেট করতে, এই পদক্ষেপগুলি অনুসরণ করুন:
- একটি টার্মিনাল খুলুন এবং
Podfileধারণকারী প্রকল্প ডিরেক্টরিতে যান। -
pod updateকমান্ডটি চালান। এটিPodfileউল্লেখিত সমস্ত API গুলিকে সর্বশেষ সংস্করণে আপডেট করবে।
ধাপ ৩: আপনার অ্যাপে API কী যোগ করুন
নিম্নলিখিত উদাহরণগুলিতে, YOUR_API_KEY আপনার API কী দিয়ে প্রতিস্থাপন করুন।
গুগলপ্লেসসুইফট
আপনার AppDelegate.swift এ আপনার API কীটি নিম্নরূপ যোগ করুন:
- নিম্নলিখিত আমদানি বিবৃতি যোগ করুন:
import GooglePlacesSwift
- আপনার
application(_:didFinishLaunchingWithOptions:)পদ্ধতিতে নিম্নলিখিতটি যোগ করুন, YOUR_API_KEY কে আপনার API কী দিয়ে প্রতিস্থাপন করুন:PlacesClient.provideAPIKey("YOUR_API_KEY")
সুইফট
আপনার AppDelegate.swift এ আপনার API কীটি নিম্নরূপ যোগ করুন:
- নিম্নলিখিত আমদানি বিবৃতি যোগ করুন:
import GooglePlaces
- আপনার
application(_:didFinishLaunchingWithOptions:)পদ্ধতিতে নিম্নলিখিতটি যোগ করুন, YOUR_API_KEY কে আপনার API কী দিয়ে প্রতিস্থাপন করুন:GMSPlacesClient.provideAPIKey("YOUR_API_KEY")
অবজেক্টিভ-সি
আপনার AppDelegate.m এ আপনার API কীটি নিম্নরূপ যোগ করুন:
- নিম্নলিখিত আমদানি বিবৃতি যোগ করুন:
@import GooglePlaces;
- আপনার
application:didFinishLaunchingWithOptions:পদ্ধতি, আপনার API কী দিয়ে YOUR_API_KEY প্রতিস্থাপন করুন:[GMSPlacesClient provideAPIKey:@"YOUR_API_KEY"];
ধাপ ৪ (ঐচ্ছিক): অ্যাপল প্রাইভেসি ম্যানিফেস্ট ফাইলটি পরীক্ষা করুন
অ্যাপ স্টোরের অ্যাপগুলির জন্য অ্যাপলের গোপনীয়তার বিবরণ প্রয়োজন। আপডেট এবং আরও তথ্যের জন্য অ্যাপল অ্যাপ স্টোরের গোপনীয়তার বিবরণ পৃষ্ঠাটি দেখুন।
অ্যাপল প্রাইভেসি ম্যানিফেস্ট ফাইলটি SDK-এর রিসোর্স বান্ডেলে অন্তর্ভুক্ত। প্রাইভেসি ম্যানিফেস্ট ফাইলটি অন্তর্ভুক্ত করা হয়েছে কিনা তা যাচাই করতে এবং এর বিষয়বস্তু পরীক্ষা করতে, আপনার অ্যাপের একটি আর্কাইভ তৈরি করুন এবং আর্কাইভ থেকে একটি গোপনীয়তা প্রতিবেদন তৈরি করুন ।
পরবর্তী পদক্ষেপ
- কোড লেখা শুরু করুন। একটি প্রস্তাবিত সূচনা বিন্দু হল একটি স্টার্টার অ্যাপ বাস্তবায়ন করা যা ব্যবহারকারীর বর্তমান স্থান পাবে।
- আপনার প্রকল্পটি কনফিগার করার পরে, আপনি নমুনা অ্যাপগুলি অন্বেষণ করতে পারেন।
- আপনার API কী সুরক্ষিত করতে অ্যাপ চেক ব্যবহার করুন ।