शुरू करें

चेतावनी: Nearby Messages की सुविधा बंद कर दी गई है. यह दिसंबर 2023 से काम नहीं करेगी. ज़्यादा मदद पाने के लिए, कृपया आस-पास शेयरिंग की सुविधा वाले कनेक्शन पर जाएं. इसके अलावा, Nearby Messages के मौजूदा इस्तेमाल को आस-पास शेयरिंग की सुविधा वाले कनेक्शन पर माइग्रेट करने के तरीके के बारे में जानने के लिए, माइग्रेशन से जुड़े दिशा-निर्देश देखें.

इस दस्तावेज़ में, 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 डेवलपमेंट पहले कभी नहीं किया है, तो एक व्यू वाला ऐप्लिकेशन बनाएं और पक्का करें कि ऑटोमैटिक रेफ़रंस काउंटिंग का इस्तेमाल चालू हो.)
• अपनी प्रोजेक्ट डायरेक्ट्री में 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 कंपाइलर - कोड जनरेशन" पर जाएं. इसे तुरंत ढूंढने के लिए, खोज बॉक्स में "Swift कंपाइलर" टाइप करें.
7. Objective-C ब्रिजिंग हेडर सेक्शन को बड़ा करने के लिए, ऐरो पर क्लिक करें.
8. डीबग करें और रिलीज़ करें में जाकर, अपनी बनाई गई हेडर फ़ाइल का पाथ जोड़ें.
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. कोटा की चोरी को रोकने के लिए, इन सबसे सही तरीकों का पालन करके अपनी एपीआई पासकोड को सुरक्षित करें.

ध्यान दें: अगर Android ऐप्लिकेशन भी डेवलप किया जा रहा है या Proximity Beacon REST API का इस्तेमाल किया जा रहा है, तो पक्का करें कि आपने सभी ज़रूरी एपीआई कुंजियां, एक ही Google Developers Console प्रोजेक्ट में जनरेट की हों. ज़्यादा जानकारी के लिए, Android के लिए शुरू करने की गाइड और REST API का इस्तेमाल शुरू करना देखें.

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

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

Objective-CSwift

#import <GNSMessages.h>

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

let messageManager = GNSMessageManager(APIKey: "API_KEY")