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

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

প্রতিটি রিলিজের জন্য রিলিজ নোট উপলভ্য।

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

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

  • Xcode ভার্সন 26.0 বা তার পরবর্তী ভার্সন

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

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

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

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

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

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

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

  1. Xcode থেকে, ফাইল > প্যাকেজ > লেটেস্ট প্যাকেজ ভার্সনে আপডেট করুন বিকল্পে যান।

    আপনি যদি বন্ধ হয়ে যাওয়া GitHub URL থেকে Google Places Swift আপডেট করেন

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

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

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

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

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

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

  1. নিম্নলিখিত SDK বাইনারি ও রিসোর্স ফাইল ডাউনলোড করুন:
  2. আপনি iOS-এর জন্য Places Swift SDK ইনস্টল করলে, নিম্নলিখিত ফাইলগুলি ইনস্টল করুন:
  3. XCFramework ও রিসোর্স অ্যাক্সেস করতে ফাইল এক্সট্র্যাক্ট করুন।
  4. Xcode চালু করে আগে থেকে থাকা কোনও প্রোজেক্ট খুলুন অথবা নতুন প্রোজেক্ট তৈরি করুন। আপনি iOS ডেভেলপমেন্টে নতুন হলে, নতুন প্রোজেক্ট তৈরি করুন এবং iOS অ্যাপ টেমপ্লেট বেছে নিন।
  5. আপনার প্রোজেক্ট থেকে আগের রিলিজের যেকোনও Maps বান্ডেল সরান।
  6. সাধারণ ট্যাব খুলুন। ফ্রেমওয়ার্ক, লাইব্রেরি ও এম্বেড করা কন্টেন্ট-এর অধীনে আপনার প্রোজেক্টে নিম্নলিখিত XCFramework টেনে আনুন। এম্বেড করবেন না বিকল্পটি বেছে নিতে ভুলবেন না:
    • GooglePlaces.xcframework
    আপনি Places Swift SDK ইনস্টল করলে, ফ্রেমওয়ার্ক, লাইব্রেরি ও এম্বেড করা কন্টেন্ট বিকল্পের অধীনে আপনার প্রোজেক্টে নিম্নলিখিত XCFramework টেনে আনুন। এম্বেড করবেন না বিকল্পটি বেছে নিতে ভুলবেন না:
    • GooglePlacesSwift.xcframework
  7. আপনার Xcode প্রোজেক্টের টপ লেভেল ডিরেক্টরিতে ডাউনলোড করা GooglePlacesResources থেকে GooglePlaces.bundle কপি করুন। প্রম্পট করা হলে গন্তব্য গ্রুপের ফোল্ডারে আইটেম কপি করুন বিকল্প বেছে নিতে ভুলবেন না।

    আপনি Places Swift SDK ইনস্টল করলে, আপনার Xcode প্রোজেক্টের টপ লেভেল ডিরেক্টরিতে ডাউনলোড করা GooglePlacesSwiftResources থেকে GooglePlacesSwift.bundle কপি করুন। প্রম্পট করা হলে গন্তব্য গ্রুপের ফোল্ডারে আইটেম কপি করুন বিকল্প বেছে নিতে ভুলবেন না।
  8. প্রোজেক্ট নেভিগেটর থেকে আপনার প্রোজেক্ট বেছে নিন এবং আপনার অ্যাপ্লিকেশনের টার্গেট বেছে নিন।
  9. বিল্ড ফেজ ট্যাব খুলুন। লাইব্রেরির সাথে বাইনারি লিঙ্ক করুন বিকল্পের মধ্যে, নিম্নলিখিত ফ্রেমওয়ার্ক ও লাইব্রেরি যোগ করুন:
    • CoreGraphics.framework
    • CoreLocation.framework
    • libc++.tbd
    • libz.tbd
    • QuartzCore.framework
    • UIKit.framework
  10. নির্দিষ্ট টার্গেটের পরিবর্তে আপনার প্রোজেক্ট বেছে নিন এবং বিল্ড সেটিংস ট্যাব খুলুন। লিঙ্ক করা - সাধারণ -> অন্যান্য লিঙ্কার ফ্ল্যাগ বিভাগে, "ডিবাগ" ও "রিলিজ" বিকল্পে -ObjC যোগ করুন। এইসব সেটিংস দেখতে না পেলে, বিল্ড সেটিংস বারে ফিল্টারটি প্রাথমিক থেকে সব-এ পরিবর্তন করুন।

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

নিচের উদাহরণে, YOUR_API_KEY-এর জায়গায় আপনার API কী লিখুন।

<h3" data-text="12974050100921915444" id="googleplacesswift" tabindex="-1">GooglePlacesSwift</h3">

আপনার API key নিম্নলিখিত উপায়ে AppDelegate.swift-এ যোগ করুন:

  • নিম্নলিখিত ইম্পোর্ট স্টেটমেন্ট যোগ করুন:
    import GooglePlacesSwift
  • আপনার application(_:didFinishLaunchingWithOptions:) পদ্ধতিতে নিম্নলিখিতগুলি যোগ করুন, YOUR_API_KEY-এর জায়গায় আপনার API key লিখুন:
    PlacesClient.provideAPIKey("YOUR_API_KEY")

Swift

আপনার API key নিম্নলিখিত উপায়ে AppDelegate.swift-এ যোগ করুন:

  • নিম্নলিখিত ইম্পোর্ট স্টেটমেন্ট যোগ করুন:
    import GooglePlaces
  • YOUR_API_KEY-এর জায়গায় আপনার API key লিখে, আপনার application(_:didFinishLaunchingWithOptions:) পদ্ধতিতে নিম্নলিখিতগুলি যোগ করুন:
    GMSPlacesClient.provideAPIKey("YOUR_API_KEY")

Objective-C

আপনার API key নিম্নলিখিত উপায়ে AppDelegate.m-এ যোগ করুন:

  • নিম্নলিখিত ইম্পোর্ট স্টেটমেন্ট যোগ করুন:
    @import GooglePlaces;
  • YOUR_API_KEY-এর জায়গায় আপনার API key লিখে, আপনার application:didFinishLaunchingWithOptions: পদ্ধতিতে নিম্নলিখিতগুলি যোগ করুন:
    [GMSPlacesClient provideAPIKey:@"YOUR_API_KEY"];

ধাপ ৪ (ঐচ্ছিক): Apple গোপনীয়তা ম্যানিফেস্ট ফাইল পরীক্ষা করা

App Store-এ থাকা অ্যাপের জন্য Apple-এর অ্যাপ গোপনীয়তা সংক্রান্ত বিবরণ প্রয়োজন। আপডেট ও আরও তথ্যের জন্য Apple App Store-এর গোপনীয়তা সংক্রান্ত বিবরণ পৃষ্ঠা দেখুন।

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

পরবর্তী ধাপ