शुरू करें

इस दस्तावेज़ में, iOS पर आस-पास शेयरिंग की सुविधा वाले मैसेज के एपीआई की मदद से डेवलपमेंट शुरू करने का तरीका बताया गया है.

पहला चरण: Xcode का सबसे नया वर्शन पाना

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

दूसरा चरण: 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. बिल्ड एडिटर में सबसे ऊपर मौजूद, Build Settings पर क्लिक करें.
  6. Build Settings में, "Swift Compiler - Code Generation" पर जाएं. इसे ढूंढने के लिए, खोज बॉक्स में "Swift Compiler" टाइप करें.
  7. Objective-C Bridging Header सेक्शन को बड़ा करने के लिए, तीर के निशान पर क्लिक करें.
  8. Debug और Release में, अपनी बनाई गई हेडर फ़ाइल का पाथ जोड़ें.
  9. बदलावों को लागू करने के लिए, प्रोजेक्ट बनाएं.

पांचवां चरण: कोई Google खाता पाना

आस-पास शेयरिंग की सुविधा वाले मैसेज के एपीआई का इस्तेमाल करने के लिए, आपके पास एक 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")