iOS के लिए, कास्ट ऐप्लिकेशन फ़्रेमवर्क (सीएएफ़) के साथ डेवलप करने के लिए सेटअप

Cast फ़्रेमवर्क, iOS 16 और इसके बाद के वर्शन पर काम करता है. यह स्टैटिक और डाइनैमिक, दोनों फ़्रेमवर्क में उपलब्ध है.

सभी क्लास और तरीकों की जानकारी के लिए, Google Cast iOS API का रेफ़रंस देखें.

ध्यान दें: Cast iOS SDK XCFrameworks के नए वर्शन अब उपलब्ध हैं. ये Apple Silicon कंप्यूटर पर डेवलपमेंट के साथ काम करते हैं.

Xcode सेटअप

चेतावनी: 'सबसे तेज़, एग्रेसिव ऑप्टिमाइज़ेशन' के लिए, Apple Clang - Code Generation Optimization Level फ़्लैग को -Ofast पर सेट करने से, Cast iOS SDK टूल का इस्तेमाल करने वाले ऐप्लिकेशन क्रैश हो जाएंगे. ऐसा ऑप्टिमाइज़ेशन के साथ काम न करने की वजह से होगा. SDK टूल, 'सबसे तेज़, सबसे छोटा' के लिए डिफ़ॉल्ट वैल्यू -Os के साथ काम करता है.

1. अपने प्रोजेक्ट में Cast iOS SDK 4.8.6 जोड़ना

   अगर Swift Package Manager का इस्तेमाल किया जा रहा है, तो google-cast-ios-sdk पैकेज को 4.8.6 वर्शन पर अपडेट करें.

   इसके अलावा, एसडीके को मैन्युअल तरीके से पुल करें.

   ध्यान दें: अगर आपने अपने ऐप्लिकेशन में कस्टम डिवाइस पिकर बनाया है, तो आपको डिवाइस खोजने की सुविधा शुरू करने के लिए, GCKDiscoveryManager क्लास पर startDiscovery तरीके को साफ़ तौर पर कॉल करना होगा. Cast SDK टूल के v4.5.0 वर्शन के साथ, अपने-आप स्कैन होने की सुविधा डिफ़ॉल्ट रूप से बंद कर दी गई थी.
2. Info.plist में NSBonjourServices को जोड़ना

   लोकल नेटवर्क डिस्कवरी की सुविधा को चालू करने के लिए, अपने Info.plist में NSBonjourServices की जानकारी दें.

   डिवाइस खोजने की सुविधा ठीक से काम करे, इसके लिए आपको _googlecast._tcp और _<your-app-id>._googlecast._tcp, दोनों को सेवाओं के तौर पर जोड़ना होगा.

   appID आपका receiverID होता है. यह वही आईडी होता है जो आपके GCKDiscoveryCriteria में तय किया गया है.

   यहां दिए गए उदाहरण में, NSBonjourServices की परिभाषा को अपडेट करें और "ABCD1234" की जगह अपना ऐप्लिकेशन आईडी डालें.

   <key>NSBonjourServices</key>
   <array>
     <string>_googlecast._tcp</string>
     <string>_ABCD1234._googlecast._tcp</string>
   </array>

3. NSLocalNetworkUsageDescription को अपने Info.plist में जोड़ें

   हमारा सुझाव है कि आप लोकल नेटवर्क प्रॉम्प्ट में दिखने वाले मैसेज को पसंद के मुताबिक बनाएं. इसके लिए, अपने ऐप्लिकेशन की Info.plist फ़ाइल में, NSLocalNetworkUsageDescription के लिए ऐप्लिकेशन के हिसाब से अनुमति वाली स्ट्रिंग जोड़ें. जैसे, Cast की खोज और DIAL जैसी अन्य खोज सेवाओं के बारे में बताने के लिए.

   <key>NSLocalNetworkUsageDescription</key>
   <string>${PRODUCT_NAME} uses the local network to discover Cast-enabled devices on your WiFi
   network.</string>

   यह मैसेज, iOS लोकल नेटवर्क ऐक्सेस डायलॉग के हिस्से के तौर पर दिखेगा, जैसा कि मॉक में दिखाया गया है.

   
4. Apple App Store पर अपने ऐप्लिकेशन को फिर से रिलीज़ करना

   हमारा सुझाव है कि आप जल्द से जल्द 4.8.6 का इस्तेमाल करके, अपने ऐप्लिकेशन को फिर से रिलीज़ करें.

Swift Package Manager सेटअप

Google Cast को इंटिग्रेट करने के लिए, Swift Package Manager (एसपीएम) का इस्तेमाल करने का सुझाव दिया जाता है. Cast iOS SDK पैकेज, google-cast-ios-sdk GitHub रिपॉज़िटरी से उपलब्ध है.

Xcode में अपने प्रोजेक्ट में Cast iOS SDK जोड़ने के लिए:

1. Xcode में, File > Add Packages... को चुनें.
2. डेटा स्टोर करने की जगह का यूआरएल डालें: https://github.com/googlecast/google-cast-ios-sdk.
3. वर्शन बनाने के नियम चुनें. उदाहरण के लिए, अगले मेजर वर्शन तक चुनें. साथ ही, कम से कम 4.8.6 वर्शन चुनें, ताकि आपको ऐसे अपडेट मिलें जो आपके ऐप्लिकेशन के साथ काम करते हों और उनमें नुकसान पहुंचा सकने वाले बदलाव न हों.
4. पैकेज जोड़ें पर क्लिक करें.
5. GoogleCastDynamic या GoogleCastStatic प्रॉडक्ट चुनें और उसे अपने ऐप्लिकेशन टारगेट में जोड़ें.

चेतावनी: अपने टारगेट में GoogleCastDynamic या GoogleCastStatic में से सिर्फ़ एक प्रॉडक्ट जोड़ें. SDK टूल के दोनों वैरिएंट को एक ही ऐप्लिकेशन में न जोड़ें.

फ़्रेमवर्क का कोई वैरिएंट चुनें

Cast iOS SDK पैकेज में दो प्रॉडक्ट मिलते हैं:

• GoogleCastDynamic: डाइनैमिक फ़्रेमवर्क. इसमें Cast के यूज़र इंटरफ़ेस (यूआई) कॉम्पोनेंट के लिए ज़रूरी सभी ऐसेट रिसॉर्स शामिल होते हैं. साथ ही, इसके लिए किसी अतिरिक्त लिंकर फ़्लैग की ज़रूरत नहीं होती. Mac Catalyst के साथ काम करने वाले ऐप्लिकेशन को डाइनैमिक फ़्रेमवर्क का इस्तेमाल करना चाहिए. ज़्यादा जानकारी के लिए, Mac Catalyst सेटअप देखें.
• GoogleCastStatic: स्टैटिक फ़्रेमवर्क. इसके लिए, स्टैटिक फ़्रेमवर्क सेटअप में बताए गए सेटअप के अतिरिक्त चरणों को पूरा करना ज़रूरी है.

स्टैटिक फ़्रेमवर्क सेटअप

स्टैटिक फ़्रेमवर्क में रिसॉर्स बंडल शामिल नहीं किए जा सकते. इस वजह से, Swift Package Manager, Cast के यूज़र इंटरफ़ेस (यूआई) कॉम्पोनेंट के लिए ज़रूरी ऐसेट रिसॉर्स को GoogleCastStatic प्रॉडक्ट के साथ अपने-आप बंडल नहीं कर सकता. जैसे, यूज़र इंटरफ़ेस (यूआई) इमेज, स्टोरीबोर्ड, और स्थानीय भाषा में उपलब्ध कराई गई फ़ाइलें. अगर आपको अपने टारगेट में GoogleCastStatic को जोड़ना है, तो यह तरीका अपनाएं:

1. अपने Xcode प्रोजेक्ट में, Build Settings > Other Linker Flags में जाकर, -ObjC -lc++ फ़्लैग जोड़ें.
2. अगर आपका ऐप्लिकेशन, Cast के यूज़र इंटरफ़ेस (यूआई) कॉम्पोनेंट का इस्तेमाल करता है, तो ऐसेट बंडल को अपने प्रोजेक्ट में मैन्युअल तरीके से जोड़ें:
   1. डाउनलोड से स्टैटिक लाइब्रेरी डाउनलोड करें. पक्का करें कि स्टैटिक लाइब्रेरी का वर्शन, आपके जोड़े गए पैकेज के वर्शन से मेल खाता हो.
   2. अनज़िप की गई डायरेक्ट्री में Resources फ़ोल्डर ढूंढें और सभी .bundle फ़ाइलों को अपने Xcode प्रोजेक्ट में खींचें और छोड़ें. 'ज़रूरत पड़ने पर सभी आइटम कॉपी करें' को चुनें और सभी टारगेट में जोड़ें.

ध्यान दें: google-cast-ios-sdk पैकेज को नए वर्शन में अपडेट करते समय, अपने प्रोजेक्ट में मौजूद ऐसेट बंडल को उसी वर्शन की स्टैटिक लाइब्रेरी के बंडल से बदलें.

CocoaPods सेटअप

चेतावनी: CocoaPods के लिए सहायता बंद कर दी गई है. वर्शन 4.8.6, CocoaPods पर पब्लिश किया गया आखिरी अपडेट है. इसके बाद के अपडेट, Swift Package Manager का इस्तेमाल करके उपलब्ध होंगे. साथ ही, इन्हें सीधे डाउनलोड करने का विकल्प भी उपलब्ध रहेगा.

मैन्युअल सेटअप

Swift Package Manager का इस्तेमाल किए बिना, अपने प्रोजेक्ट में Cast iOS SDK टूल जोड़ने के लिए, यहां दिए गए निर्देशों का पालन करें:

अहम जानकारी: 4.8.4 वर्शन से, अगर Protobuf पर निर्भर किसी दूसरी लाइब्रेरी (जैसे, Firebase) का इस्तेमाल किया जा रहा है, तो स्टैटिक लाइब्रेरी का इस्तेमाल करने से ऐप्लिकेशन का साइज़ बढ़ जाएगा.

हमारा सुझाव है कि आप स्टैटिक लाइब्रेरी का इस्तेमाल करें, ताकि Protobuf के साथ वर्शन के काम करने से जुड़ी संभावित समस्याओं से बचा जा सके. हालांकि, अगर साइज़ में अंतर होने से आपको कोई समस्या हो रही है, तो डाइनैमिक लाइब्रेरी डाउनलोड करें.

डाउनलोड

नीचे दी गई लाइब्रेरी में से सही लाइब्रेरी डाउनलोड करने के बाद, अपने प्रोजेक्ट में फ़्रेमवर्क जोड़ने के लिए, सेटअप करने का तरीका अपनाएं.

Cast iOS Sender SDK 4.8.6 लाइब्रेरी:

स्टैटिक डाइनैमिक

सेटअप का तरीका

लाइब्रेरी इंस्टॉल करने के लिए:

1. अपने प्रोजेक्ट के लिए सही एसडीके डाउनलोड करें और उसे एक्सट्रैक्ट करें.
2. डाइनैमिक GoogleCastSDK लाइब्रेरी सेट अप करें:
3. अनज़िप किए गए .xcframework को Xcode प्रोजेक्ट नेविगेटर में अपने मुख्य प्रोजेक्ट में खींचें और छोड़ें. 'ज़रूरत पड़ने पर सभी आइटम कॉपी करें' को चुनें और सभी टारगेट में जोड़ें.
4. अपने Xcode टारगेट में, General टैब में जाकर, GoogleCast.xcframework के लिए Embed and Sign को चुनें.

अगर आपको डाइनैमिक लाइब्रेरी सेट अप करनी है, तो पिछले चरणों के साथ-साथ यह तरीका भी अपनाएं:

1. अगर GoogleCastSDK का मौजूदा वर्शन मौजूद है, तो उसे हटाएं.
2. Protobuf GitHub रिपॉज़िटरी पर दिए गए निर्देशों का पालन करके, Protobuf लाइब्रेरी का v3.13 या इसके बाद का वर्शन जोड़ें.

अगर आपको स्टैटिक लाइब्रेरी सेट अप करनी है, तो पिछले चरणों के अलावा, यह तरीका भी अपनाएं:

1. अपने Xcode प्रोजेक्ट में, Build Settings > Other Linker Flags में जाकर, फ़्लैग -ObjC -lc++ जोड़ें.
2. अनज़िप की गई डायरेक्ट्री में Resources फ़ोल्डर ढूंढें और सभी .bundle फ़ाइलों को अपने प्रोजेक्ट में खींचें और छोड़ें. इन्हें पहले से जोड़े गए GoogleCast.xcframework के बगल में रखें. 'ज़रूरत पड़ने पर सभी आइटम कॉपी करें' को चुनें और सभी टारगेट में जोड़ें.

Mac Catalyst सेटअप करना

Mac Catalyst के साथ काम करने वाले ऐप्लिकेशन के लिए, Cast SDK की डाइनैमिक लाइब्रेरी का इस्तेमाल करें. अपने प्रोजेक्ट में फ़्रेमवर्क जोड़ने के लिए, मैन्युअल सेटअप प्रोसेस अपनाएं. इसके बाद, Apple के दस्तावेज़ में बताए गए तरीके से, Mac टारगेट से Cast SDK को शर्त के साथ बाहर रखें. स्टैटिक लाइब्रेरी, iOS आर्किटेक्चर के लिए पहले से कंपाइल की जाती हैं. इस वजह से, Mac टारगेट के लिए बिल्ड करते समय लिंकर गड़बड़ी होती है.