শুরু করুন

এই ডকুমেন্টটিতে ব্যাখ্যা করা হয়েছে কীভাবে iOS-এ Nearby Messages API ব্যবহার করে ডেভেলপমেন্ট শুরু করতে হয়।

ধাপ ১: Xcode-এর সর্বশেষ সংস্করণটি ডাউনলোড করুন।

iOS-এর জন্য Google Nearby Messages API ব্যবহার করে একটি প্রজেক্ট তৈরি করতে, আপনার Xcode- এর 6.3 বা তার পরবর্তী সংস্করণ প্রয়োজন।

ধাপ ২: কোকোপড সংগ্রহ করুন

iOS-এর জন্য গুগল নিয়ারবাই মেসেজেস এপিআই একটি কোকোয়া পডস পড হিসেবে উপলব্ধ। কোকোয়া পডস হলো সুইফট এবং অবজেক্টিভ-সি কোকোয়া প্রোজেক্টের জন্য একটি ওপেন সোর্স ডিপেন্ডেন্সি ম্যানেজার।

আপনার কাছে যদি আগে থেকেই CocoaPods টুলটি না থাকে, তাহলে টার্মিনাল থেকে নিম্নলিখিত কমান্ডটি চালিয়ে OS X-এ এটি ইনস্টল করুন। বিস্তারিত জানতে, CocoaPods Getting Started গাইডটি দেখুন।

$ sudo gem install cocoapods

ধাপ ৩: CocoaPods ব্যবহার করে API ইনস্টল করুন

iOS-এর জন্য Google Nearby Messages API-এর একটি Podfile তৈরি করুন এবং সেটি ব্যবহার করে API ও এর নির্ভরশীলতাগুলো ইনস্টল করুন।

  • আপনার যদি এখনও কোনো Xcode প্রজেক্ট না থাকে, তাহলে এখনই একটি তৈরি করে আপনার লোকাল মেশিনে সেভ করুন। (আপনি যদি iOS ডেভেলপমেন্টে নতুন হন, তাহলে একটি Single View Application তৈরি করুন এবং নিশ্চিত করুন যে Use Automatic Reference Counting চালু আছে।)
  • আপনার প্রজেক্ট ডিরেক্টরিতে Podfile নামে একটি ফাইল তৈরি করুন। এই ফাইলটি আপনার প্রজেক্টের ডিপেন্ডেন্সিগুলো নির্ধারণ করে।

  • Podfile সম্পাদনা করুন এবং আপনার ডিপেন্ডেন্সিগুলো যোগ করুন। নিচে একটি সাধারণ Podspec দেওয়া হলো, যেখানে iOS-এর জন্য Google Nearby Messages API-এর জন্য আপনার প্রয়োজনীয় পডের নামটি অন্তর্ভুক্ত রয়েছে:

    source 'https://github.com/CocoaPods/Specs.git'
platform :ios, '7.0'
pod 'NearbyMessages'

  • Podfile সংরক্ষণ করুন।

  • একটি টার্মিনাল খুলুন এবং Podfile যে ডিরেক্টরিতে আছে সেখানে যান:

    $ সিডি

  • pod install কমান্ডটি চালান। এটি Podspec-এ উল্লেখিত API-গুলো এবং সেগুলোর সম্ভাব্য নির্ভরতাগুলো ইনস্টল করবে।

    $ pod install

  • Xcode বন্ধ করুন, এবং তারপর Xcode চালু করার জন্য আপনার প্রোজেক্টের .xcworkspace ফাইলটি খুলুন (ডাবল-ক্লিক করুন)। এখন থেকে, প্রোজেক্টটি খোলার জন্য আপনাকে অবশ্যই .xcworkspace ফাইলটি ব্যবহার করতে হবে।

ধাপ ৪: একটি ব্রিজিং হেডার তৈরি করুন (শুধুমাত্র সুইফট-এর জন্য)

আপনি যদি সুইফট ব্যবহার করে আপনার প্রজেক্ট তৈরি করে থাকেন, তাহলে আপনাকে অবশ্যই আপনার প্রজেক্টে একটি ব্রিজিং হেডার যোগ করতে হবে, যাতে এটি পড ফাইলের মাধ্যমে ইনস্টল করা লাইব্রেরিগুলো ব্যবহার করতে পারে। ব্রিজিং হেডার যোগ করতে এই ধাপগুলো অনুসরণ করুন:

  1. আপনার প্রোজেক্টের .xcworkspace ফাইলটি যে ডিরেক্টরিতে আছে, সেখানেই একটি নতুন হেডার ফাইল যোগ করুন (আপনার পছন্দমতো নাম দিন এবং ফাইলের এক্সটেনশন হিসেবে ".h" ব্যবহার করুন)।
  2. আপনার তৈরি করা ফাইলে নিম্নলিখিত কোডটি পেস্ট করুন: #import <GNSMessages.h> ।
  3. ফাইলটি সংরক্ষণ করুন।
  4. প্রজেক্ট এডিটরের বাম প্যানে, মূল প্রজেক্টটি নির্বাচন করুন।
  5. বিল্ড এডিটরের শীর্ষে থাকা বিল্ড সেটিংস- এ ক্লিক করুন।
  6. বিল্ড সেটিংস-এ, "সুইফট কম্পাইলার - কোড জেনারেশন"-এ যান (দ্রুত খুঁজে পেতে সার্চ বক্সে "সুইফট কম্পাইলার" টাইপ করুন)।
  7. Objective-C Bridging Header সেকশনটি প্রসারিত করতে তীরচিহ্নটিতে ক্লিক করুন।
  8. Debug and Release-এর অধীনে, আপনার তৈরি করা হেডার ফাইলের পাথটি যোগ করুন।
  9. পরিবর্তনগুলো কার্যকর করার জন্য প্রকল্পটি তৈরি করুন।

ধাপ ৫: একটি গুগল অ্যাকাউন্ট তৈরি করুন।

Nearby Messages API ব্যবহার করার জন্য আপনার একটি Google অ্যাকাউন্ট প্রয়োজন। যদি আপনার আগে থেকেই একটি অ্যাকাউন্ট থাকে, তাহলে আর কোনো সমস্যা নেই। পরীক্ষার উদ্দেশ্যে আপনার একটি আলাদা Google অ্যাকাউন্টও লাগতে পারে।

ধাপ ৬: একটি এপিআই কী সংগ্রহ করুন।

iOS-এর জন্য Google Nearby Messages API সক্রিয় করতে এবং একটি API কী পেতে এই পদক্ষেপগুলি অনুসরণ করুন:

  1. গুগল ডেভেলপার কনসোলে যান।
  2. আপনার আবেদনপত্রটি নিবন্ধন করার জন্য একটি প্রকল্প তৈরি করুন বা নির্বাচন করুন।
  3. এপিআই সক্রিয় করতে ' চালিয়ে যান'- এ ক্লিক করুন।
  4. ক্রেডেনশিয়ালস পেজে, একটি নতুন iOS কী তৈরি করুন (এবং API ক্রেডেনশিয়ালস সেট করুন)।
    দ্রষ্টব্য: আপনার যদি আগে থেকে কোনো iOS কী থাকে, তবে আপনি সেই কী-টি ব্যবহার করতে পারেন।
  5. প্রদর্শিত ডায়ালগ বক্সে আপনার অ্যাপের বান্ডেল আইডেন্টিফায়ারটি লিখুন। উদাহরণস্বরূপ: 
    com.example.nearbyexample
  6. আপনার নতুন iOS API কী আপনার প্রোজেক্টের API কী-গুলোর তালিকায় দেখা যাচ্ছে। API কী হলো অক্ষরের একটি স্ট্রিং, যা দেখতে অনেকটা এইরকম: 
    AIzaSyBdVl-cTICSwYKrZ95SuvNw7dbMuDt1KG0
  7. কোটা চুরি রোধ করতে, এই সর্বোত্তম পদ্ধতিগুলো অনুসরণ করে আপনার এপিআই কী সুরক্ষিত করুন।

ধাপ ৭: একটি মেসেজ ম্যানেজার অবজেক্ট তৈরি করুন

মেসেজ ম্যানেজার অবজেক্টটি আপনাকে পাবলিশ এবং সাবস্ক্রাইব করার সুযোগ দেয়। মেসেজ আদান-প্রদান প্রমাণীকরণবিহীন, তাই আপনাকে অবশ্যই পূর্ববর্তী ধাপে তৈরি করা এপিআই কী (API key) সরবরাহ করতে হবে।

উদ্দেশ্য-সি 

#import <GNSMessages.h>

GNSMessageManager *messageManager =
    [[GNSMessageManager alloc] initWithAPIKey:@"API_KEY"];

সুইফট 

let messageManager = GNSMessageManager(APIKey: "API_KEY")