শুরু করুন

এই দস্তাবেজটি ব্যাখ্যা করে কিভাবে iOS-এ Nearby Messages API দিয়ে ডেভেলপ করা শুরু করতে হয়।

ধাপ 1: এক্সকোডের সর্বশেষ সংস্করণ পান

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

ধাপ 2: কোকোপড পান

iOS এর জন্য Google Nearby Messages API একটি CocoaPods পড হিসাবে উপলব্ধ। CocoaPods হল সুইফট এবং অবজেক্টিভ-সি কোকো প্রকল্পগুলির জন্য একটি ওপেন সোর্স নির্ভরতা ব্যবস্থাপক।

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

$ sudo gem install cocoapods

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

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

  • আপনার যদি এখনও একটি Xcode প্রকল্প না থাকে তবে এখনই একটি তৈরি করুন এবং এটি আপনার স্থানীয় মেশিনে সংরক্ষণ করুন। (আপনি যদি iOS ডেভেলপমেন্টে নতুন হয়ে থাকেন, তাহলে একটি সিঙ্গেল ভিউ অ্যাপ্লিকেশন তৈরি করুন এবং নিশ্চিত করুন যে স্বয়ংক্রিয় রেফারেন্স কাউন্টিং ব্যবহার করুন চালু আছে।)
  • আপনার প্রকল্প ডিরেক্টরিতে Podfile নামে একটি ফাইল তৈরি করুন। এই ফাইলটি আপনার প্রকল্পের নির্ভরতা সংজ্ঞায়িত করে।

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

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

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

  • একটি টার্মিনাল খুলুন এবং Podfile ধারণকারী ডিরেক্টরিতে যান:

    $ cd

  • pod install কমান্ড চালান। এটি Podspec-এ নির্দিষ্ট করা APIগুলিকে ইনস্টল করবে, সাথে তাদের যে কোনো নির্ভরতা থাকতে পারে।

    $পড ইনস্টল করুন

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

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

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

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

ধাপ 5: একটি Google অ্যাকাউন্ট পান

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

ধাপ 6: একটি API কী পান

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

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

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

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

উদ্দেশ্য-C 

#import <GNSMessages.h>

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

সুইফট 

let messageManager = GNSMessageManager(APIKey: "API_KEY")