शुरू करें

इस दस्तावेज़ में, iOS पर Nearby Messages API का इस्तेमाल करके डेवलपमेंट शुरू करने का तरीका बताया गया है.

पहला चरण: Xcode का नया वर्शन डाउनलोड करना

iOS के लिए Google Nearby Messages API का इस्तेमाल करके कोई प्रोजेक्ट बनाने के लिए, आपके पास Xcode का 6.3 वर्शन या इसके बाद का वर्शन होना चाहिए.

दूसरा चरण: CocoaPods पाना

iOS के लिए Google Nearby Messages API, CocoaPods पॉड के तौर पर उपलब्ध है. CocoaPods, Swift और Objective-C Cocoa प्रोजेक्ट के लिए एक ओपन सोर्स डिपेंडेंसी मैनेजर है.

अगर आपके पास पहले से CocoaPods टूल नहीं है, तो इसे OS X पर इंस्टॉल करें. इसके लिए, टर्मिनल में जाकर यह कमांड चलाएं. ज़्यादा जानकारी के लिए, CocoaPods का इस्तेमाल शुरू करने से जुड़ी गाइड देखें.

$ sudo gem install cocoapods

तीसरा चरण: CocoaPods का इस्तेमाल करके एपीआई इंस्टॉल करना

iOS के लिए Google Nearby Messages API के लिए Podfile बनाएं. इसका इस्तेमाल, एपीआई और इसकी डिपेंडेंसी इंस्टॉल करने के लिए करें.

  • अगर आपके पास अब तक कोई 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 मौजूद है:

    $ cd

  • pod install कमांड चलाएं. इससे Podspec में बताए गए एपीआई इंस्टॉल हो जाएंगे. साथ ही, उनसे जुड़ी कोई भी डिपेंडेंसी भी इंस्टॉल हो जाएगी.

    $ pod install

  • Xcode बंद करें. इसके बाद, Xcode लॉन्च करने के लिए अपने प्रोजेक्ट की .xcworkspace फ़ाइल को खोलें (दो बार क्लिक करें). इसके बाद, प्रोजेक्ट खोलने के लिए आपको .xcworkspace फ़ाइल का इस्तेमाल करना होगा.

चौथा चरण: ब्रिजिंग हेडर बनाना (सिर्फ़ Swift के लिए)

अगर आपने Swift का इस्तेमाल करके अपना प्रोजेक्ट बनाया है, तो आपको अपने प्रोजेक्ट में एक ब्रिजिंग हेडर जोड़ना होगा, ताकि वह उन लाइब्रेरी का इस्तेमाल कर सके जिन्हें पॉड फ़ाइल ने इंस्टॉल किया था. ब्रिजिंग हेडर जोड़ने के लिए, यह तरीका अपनाएं:

  1. अपने प्रोजेक्ट की .xcworkspace फ़ाइल वाली डायरेक्ट्री में, एक नई हेडर फ़ाइल जोड़ें. इसे अपनी पसंद का कोई भी नाम दें और फ़ाइल नाम के एक्सटेंशन के तौर पर ".h" का इस्तेमाल करें.
  2. आपने जो फ़ाइल बनाई है उसमें यह कोड चिपकाएं: #import <GNSMessages.h>.
  3. फ़ाइल सेव करें.
  4. प्रोजेक्ट एडिटर के बाएं पैनल में, मुख्य प्रोजेक्ट चुनें.
  5. बिल्ड एडिटर में सबसे ऊपर मौजूद, बिल्ड सेटिंग पर क्लिक करें.
  6. बिल्ड सेटिंग में, "Swift Compiler - Code Generation" पर जाएं. इसे तुरंत ढूंढने के लिए, खोज बॉक्स में "Swift Compiler" टाइप करें.
  7. Objective-C Bridging Header सेक्शन को बड़ा करने के लिए, ऐरो पर क्लिक करें.
  8. Debug और Release में जाकर, बनाई गई हेडर फ़ाइल का पाथ जोड़ें.
  9. बदलावों को लागू करने के लिए, प्रोजेक्ट बनाएं.

पाँचवाँ चरण: Google खाता पाना

Nearby Messages API का इस्तेमाल करने के लिए, आपके पास Google खाता होना चाहिए. अगर आपके पास पहले से कोई खाता है, तो आप इसे इस्तेमाल करने के लिए तैयार हैं. आपको जांच के लिए, अलग Google खाते की ज़रूरत भी पड़ सकती है.

छठा चरण: एपीआई पासकोड पाना

iOS के लिए Google Nearby Messages API चालू करने और एपीआई कुंजी पाने के लिए, यह तरीका अपनाएं:

  1. Google Developers Console पर जाएं.
  2. अपने ऐप्लिकेशन को रजिस्टर करने के लिए, कोई प्रोजेक्ट बनाएं या चुनें.
  3. एपीआई चालू करने के लिए, जारी रखें पर क्लिक करें.
  4. क्रेडेंशियल पेज पर जाकर, एक नया iOS पासकोड बनाएं और एपीआई क्रेडेंशियल सेट करें.
    ध्यान दें: अगर आपके पास पहले से कोई iOS कुंजी है, तो उसका इस्तेमाल किया जा सकता है.
  5. इसके बाद, दिखने वाले डायलॉग में अपने ऐप्लिकेशन का बंडल आइडेंटिफ़ायर डालें. उदाहरण के लिए: 
    com.example.nearbyexample
  6. आपका नया iOS एपीआई पासकोड, आपके प्रोजेक्ट के एपीआई पासकोड की सूची में दिखता है. एपीआई पासकोड, वर्णों की एक स्ट्रिंग होती है. यह कुछ इस तरह की होती है: 
    AIzaSyBdVl-cTICSwYKrZ95SuvNw7dbMuDt1KG0
  7. कोटा चोरी को रोकने के लिए, इन सबसे सही तरीकों को अपनाकर अपने एपीआई पासकोड को सुरक्षित रखें.

सातवां चरण: मैसेज मैनेजर ऑब्जेक्ट बनाना

मैसेज मैनेजर ऑब्जेक्ट की मदद से, पब्लिश और सदस्यता ली जा सकती है. मैसेज एक्सचेंज की पुष्टि नहीं की जाती है. इसलिए, आपको पिछले चरण में बनाया गया एपीआई पासकोड देना होगा.

Objective-C

#import <GNSMessages.h>

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

Swift

let messageManager = GNSMessageManager(APIKey: "API_KEY")