शुरू करें

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

इस दस्तावेज़ में बताया गया है कि 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 में बताए गए एपीआई इंस्टॉल हो जाएंगे. साथ ही, उनकी डिपेंडेंसी भी इंस्टॉल हो जाएगी.

  $ पॉड इंस्टॉल

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

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

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

1. आपके प्रोजेक्ट की .xcworkspace फ़ाइल वाली डायरेक्ट्री में, नई हेडर फ़ाइल जोड़ें. इसे अपनी पसंद का नाम दें और ".h" फ़ाइल नाम एक्सटेंशन का इस्तेमाल करें.
2. इस कोड को अपनी बनाई गई फ़ाइल में चिपकाएं: #import <GNSMessages.h>.
3. फ़ाइल सेव करें.
4. प्रोजेक्ट एडिटर के बाएं पैनल में, मुख्य प्रोजेक्ट चुनें.
5. बिल्ड एडिटर में सबसे ऊपर मौजूद, सेटिंग बनाएं पर क्लिक करें.
6. बिल्ड की सेटिंग में, "Swift Compiler - Code Generation" पर जाएं. इसे तुरंत खोजने के लिए, खोज बॉक्स में "Swift Compiler" टाइप करें.
7. ऑब्जेक्ट-सी ब्रिजिंग हेडर सेक्शन को बड़ा करने के लिए ऐरो पर क्लिक करें.
8. डीबग और रिलीज़ में जाकर, अपनी बनाई गई हेडर फ़ाइल का पाथ जोड़ें.
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 API कुंजी, आपके प्रोजेक्ट की एपीआई कुंजियों की सूची में दिखेगी. एपीआई पासकोड, वर्णों की एक स्ट्रिंग होती है. यह कुछ इस तरह की होती है:

   AIzaSyBdVl-cTICSwYKrZ95SuvNw7dbMuDt1KG0

7. कोटा की चोरी से बचने के लिए, इन सबसे सही तरीकों को अपनाकर अपनी एपीआई कुंजी सुरक्षित करें.

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

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

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

Objective-C

#import <GNSMessages.h>

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

Swift

let messageManager = GNSMessageManager(APIKey: "API_KEY")