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

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

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

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

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

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

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

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

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

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

    আপনি যদি অপ্রচলিত GitHub URL থেকে Google Places Swift আপডেট করেন

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

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

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

  1. Xcode থেকে, 'File > Packages > Update To Latest Package Versions'-এ যান।

    আপনি যদি অপ্রচলিত GitHub URL থেকে Google Places Swift আপডেট করেন

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

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

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

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

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

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

  1. নিম্নলিখিত SDK বাইনারি এবং রিসোর্স ফাইলগুলি ডাউনলোড করুন:
  2. আপনি যদি iOS-এর জন্য Places Swift SDK ইনস্টল করেন, তাহলে নিম্নলিখিত ফাইলগুলি ইনস্টল করুন:
  3. XCFramework এবং রিসোর্সগুলো অ্যাক্সেস করতে ফাইলগুলো এক্সট্র্যাক্ট করুন।
  4. Xcode চালু করুন এবং একটি বিদ্যমান প্রজেক্ট খুলুন অথবা একটি নতুন প্রজেক্ট তৈরি করুন। আপনি যদি iOS ডেভেলপমেন্টে নতুন হন, তাহলে একটি নতুন প্রজেক্ট তৈরি করুন এবং iOS অ্যাপ টেমপ্লেটটি নির্বাচন করুন।
  5. আপনার প্রজেক্ট থেকে পূর্ববর্তী রিলিজের যেকোনো ম্যাপস বান্ডেল সরিয়ে ফেলুন।
  6. জেনারেল ট্যাবটি খুলুন। নিম্নলিখিত XCFramework-টি আপনার প্রোজেক্টের Frameworks, Libraries, and Embedded Content-এর অধীনে ড্র্যাগ করে আনুন। Do Not Embed সিলেক্ট করতে ভুলবেন না।
    • GooglePlaces.xcframework
    আপনি যদি প্লেসেস সুইফট এসডিকে (Places Swift SDK) ইনস্টল করেন, তাহলে নিম্নলিখিত XCFramework-টি আপনার প্রোজেক্টের Frameworks, Libraries, and Embedded Content-এর অধীনে ড্র্যাগ করে আনুন। Do Not Embed নির্বাচন করতে ভুলবেন না।
    • GooglePlacesSwift.xcframework
  7. আপনার ডাউনলোড করা GooglePlacesResources থেকে GooglePlaces.bundle ফাইলটি আপনার Xcode প্রোজেক্টের টপ লেভেল ডিরেক্টরিতে কপি করুন। প্রম্পট করা হলে, অবশ্যই 'Copy items into destination group's folder' নির্বাচন করুন।

    আপনি যদি প্লেসেস সুইফট এসডিকে (Places Swift SDK) ইনস্টল করেন, তাহলে আপনার ডাউনলোড করা GooglePlacesSwiftResources থেকে GooglePlacesSwift.bundle ফাইলটি আপনার এক্সকোড (Xcode) প্রোজেক্টের টপ লেভেল ডিরেক্টরিতে কপি করুন। প্রম্পট করা হলে, অবশ্যই ‘Copy items into destination group's folder’ অপশনটি সিলেক্ট করবেন।
  8. প্রজেক্ট নেভিগেটর থেকে আপনার প্রজেক্টটি নির্বাচন করুন এবং আপনার অ্যাপ্লিকেশনের লক্ষ্য বেছে নিন।
  9. Build Phases ট্যাবটি খুলুন। Link Binary with Libraries- এর মধ্যে, নিম্নলিখিত ফ্রেমওয়ার্ক এবং লাইব্রেরিগুলি যোগ করুন:
    • CoreGraphics.framework
    • CoreLocation.framework
    • libc++.tbd
    • libz.tbd
    • QuartzCore.framework
    • UIKit.framework

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

কোকোপড

iOS-এর জন্য Places SDK এবং iOS-এর জন্য Places Swift SDK, CocoaPod pod, GooglePlaces এবং GooglePlacesSwift হিসেবে উপলব্ধ।

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

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, '16.0'

target 'YOUR_APPLICATION_TARGET_NAME_HERE' do
  pod 'GooglePlaces', '10.13.0'
  pod 'GooglePlacesSwift', '10.13.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 কী যোগ করুন

নিম্নলিখিত উদাহরণগুলিতে, YOUR_API_KEY এর জায়গায় আপনার এপিআই কী (API key) বসান।

গুগলপ্লেসেসসুইফট

আপনার 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: মেথডে নিম্নলিখিতটি যোগ করুন, যেখানে YOUR_API_KEY- এর জায়গায় আপনার API কী বসান: 
    [GMSPlacesClient provideAPIKey:@"YOUR_API_KEY"];

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

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

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

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