आरंभ करें

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

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

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

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

दूसरा चरण: CocoaPods इंस्टॉल करें

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

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

$ sudo gem install cocoapods

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

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

• अगर आपके पास अभी तक Xcode प्रोजेक्ट नहीं है, तो अभी एक प्रोजेक्ट बनाएं और उसे अपने मशीन बंद हो जाता है. (अगर आप iOS डेवलपमेंट में नए हैं, तो सिंगल व्यू बनाएं इस्तेमाल करें.)
• अपनी प्रोजेक्ट डायरेक्ट्री में Podfile नाम की फ़ाइल बनाएं. यह फ़ाइल आपकी की डिपेंडेंसी.

• Podfile में बदलाव करें और अपनी डिपेंडेंसी जोड़ें. यहाँ एक आसान Podspec दिया गया है, इसमें उस पॉड का नाम शामिल है जिसकी आपको Google Nearby Messages API के लिए ज़रूरत है iOS:

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

  अभी तक किसी भी व्यक्ति ने चेक इन नहीं किया है

• Podfile को सेव करें.

• टर्मिनल खोलें और Podfile वाली डायरेक्ट्री पर जाएं:

  $ cd

• pod install निर्देश चलाएं. इससे Podspec और उनकी सभी निर्भरताएं शामिल होनी चाहिए.

  $ पॉड इंस्टॉल

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

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

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

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

   AIzaSyBdVl-cTICSwYKrZ95SuvNw7dbMuDt1KG0

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

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

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

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

Objective-C

#import <GNSMessages.h>

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

Swift

let messageManager = GNSMessageManager(APIKey: "API_KEY")