إعداد التطوير باستخدام إطار عمل تطبيق Cast (CAF) لنظام التشغيل iOS

يتوافق إطار عمل Google Cast مع نظام التشغيل iOS 14 والإصدارات الأحدث، ويشمل كلاً من والثابتة والديناميكية.

يُرجى الاطّلاع على مرجع واجهة برمجة التطبيقات Google Cast iOS API للحصول على أوصاف لجميع الفئات والطرق.

ملاحظة: الإصدارات الجديدة من حزمة تطوير البرامج (SDK) لنظام التشغيل iOS XCFrameworks للتكنولوجيا التي تعمل بتكنولوجيا Google Cast، والتي تدعم تطوير على أجهزة كمبيوتر Apple Silicon.

إعداد Xcode

تحذير: ضبط علامة Optimization Level Apple Clang - Code Generation إلى -Ofast لطلب البحث "التحسينات الأسرع والأكثر فعالية" سيسبب استخدام التطبيقات يتعطّل إرسال حزمة تطوير البرامج (SDK) لنظام التشغيل iOS بسبب عدم التوافق مع التحسينات. حزمة SDK تدعم القيمة التلقائية -Os لـ 'Fastest, Smallest' (أسرع، أصغر).

الإصدار 14 من نظام التشغيل iOS

تحذير على الإصدار 14 من نظام التشغيل iOS: تغييرات على الإصدار 14 من نظام التشغيل iOS تأثير أذونات الوصول إلى الشبكة المحلية في حزمة تطوير البرامج (SDK) لنظام التشغيل iOS لتكنولوجيا Google Cast في عدد الطرق. يُرجى الاطّلاع على التغييرات على الإصدار 14 من نظام التشغيل iOS لمعرفة مدى تأثُّر تطبيقك.

1. إضافة الإصدار 4.8.3 من حزمة تطوير البرامج (SDK) لنظام التشغيل iOS لخدمة Cast إلى مشروعك

   في حال استخدام CocoaPods، استخدِم pod update لإضافة حزمة تطوير البرامج (SDK) 4.8.3 إلى مشروعك.

   وإلا، سحب حزمة SDK يدويًا

   ملاحظة: إذا أنشأت أداة اختيار أجهزة مخصّصة في تطبيقك، ستحتاج إلى لاستدعاء طريقة startDiscovery بشكل صريح على GCKDiscoveryManager لبدء اكتشاف الأجهزة. تم إيقاف الفحص التلقائي بواسطة تلقائيًا بدءًا من الإصدار 4.5.0 من حزمة تطوير البرامج (SDK) الخاصة بتكنولوجيا Google Cast.
2. إضافة "NSBonjourServices" إلى "Info.plist"

   حدِّد NSBonjourServices في Info.plist من أجل يتيح اكتشاف الشبكات المحلية بنجاح على نظام التشغيل iOS 14.

   ستحتاج إلى إضافة كل من _googlecast._tcp _<your-app-id>._googlecast._tcp كخدمات للجهاز الاكتشاف لتعمل بشكل صحيح.

   معرِّف appID هو معرِّف المُستلِم، وهو المعرِّف نفسه المحدَّد في GCKDiscoveryCriteria

   تعديل التعريف التالي في المثال NSBonjourServices استبدال "ABCD1234" باستخدام appID.

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

3. Add NSLocalNetworkUsageDescription to your Info.plist

   We strongly recommend that you customize the message shown in the Local Network prompt by adding an app-specific permission string in your app's Info.plist file for the NSLocalNetworkUsageDescription such as to describe Cast discovery and other discovery services, like DIAL.

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

   This message will appear as part of the iOS Local Network Access dialog as shown in the mock.

   
4. Re-release your app to the Apple App Store

   We recommend you also re-release your app using 4.8.3 as soon as possible.

iOS 13

iOS 13 Warning: Apple permissions changes to iOS 13 and Xcode 11 have impacted the Google Cast iOS SDK in a number of ways. Please see the iOS 13 Changes document to see how your app will be impacted.

iOS 12

iOS 12 Warning: If developing using Xcode 10, the "Access WiFi Information" capability is required in order to discover and connect to Cast devices.

Ensure that the Access WiFi Information switch in the Capabilities section of the target is set to "On".

Additionally, your provisioning profile will need to support the Access WiFi Information capability. This can be added in the Apple Developer Portal.

CocoaPods setup

The recommended way of integrating Google Cast is using CocoaPods. For integration, use the google-cast-sdk CocoaPods.

To get started, follow the getting started guide.

Once CocoaPods is set up, follow the using CocoaPods guide to get your Podfile created and your project ready to use with the Google Cast SDK.

Here's an example of how to add the google-cast-sdk CocoaPod to your Podfile:

use_frameworks!

platform :ios, '14.0'

def target_pods
  pod 'google-cast-sdk'
end

target 'CastVideos-objc' do
  target_pods
end
target 'CastVideos-swift' do
  target_pods
end

بالنسبة إلى مشروعك، عليك تحديد نطاق للوحاتك لتجنُّب التغييرات غير المتوقّعة. التغييرات التي قد تؤدي إلى أعطال كما هو مفصل في podfile guide.

في هذا المقتطف، الإصدار 4.8.3 والإصدارات اللاحقة يُسمح بالإصدار الرئيسي (major.minor.patch):

pod 'google-cast-sdk', '~> 4.8.3'

على سبيل المثال، '~> 1.6.7' جميع الإصدارات من 1.6.7 وما بعدها، لكن لا بما في ذلك الإصدار 2.0.0.

الإعداد اليدوي

التعليمات التالية مخصّصة لإضافة حزمة تطوير البرامج (SDK) لنظام التشغيل iOS من Cast إلى مشروعك. بدون استخدام CocoaPods:

نقطة رئيسية: بدءًا من الإصدار 4.3.1، يستخدم CocoaPods مكتبات ثابتة لتجنُّب تحذيرات الرموز المكرّرة الناتجة عن اعتمادية مكتبة Protobuf المشتركة عند استخدام حِزم تطوير البرامج (SDK) لمنصّة Firebase وCast على الرغم من أن هذا التغيير سيؤدي إلى تنزيل أكبر حجمًا، إلا أن التطبيق النهائي فلن يزيد حجمها.

إذا كان اختلاف الحجم مصدر قلق لحالتك، يُرجى تنزيل للحصول على حجم مشابه لإصدارات CocoaPods السابقة على الإصدار 4.3.1 المكتبة.

عمليات التنزيل

بعد تنزيل المكتبة المناسبة أدناه، اتبع خطوات الإعداد لإضافة إطار العمل إلى مشروعك.

مكتبات الإصدار 4.8.3 من حزمة تطوير البرامج (SDK) لـ iOS Sender:

الثابت ديناميكية

خطوات الإعداد

لتثبيت المكتبة:

1. عليك تنزيل حزمة SDK المناسبة لمشروعك واستخراجها.
2. إعداد مكتبة GoogleCastSDK الديناميكية:
3. اسحب ".xcframework" غير المضغوط إلى مشروعك الرئيسي أداة التنقّل في مشروع Xcode (وليس في مشروع Pods إذا كان لديك حساب) ضَع علامة في المربّع "نسخ كلّ العناصر عند الحاجة" وأضِفها إلى جميع الاستهدافات.
4. في استهداف Xcode، ضمن علامة التبويب General، اختَر Embed and Sign لـ GoogleCast.xcframework.

في حال إعداد المكتبة الثابتة، يُرجى اتّباع الخطوات التالية بالإضافة إلى الخطوات السابقة:

1. إعداد مكتبة Protobuf بالحد الأدنى للإصدار الإصدار 3.13.
1. إذا كان مشروعك يستخدم CocoaPods:
1. يُرجى فتح "Podfile" وإزالة google-cast-sdk في حال توفّرها:

   pod 'google-cast-sdk'

2. إضافة مكتبة Protobuf في حال عدم توفّرها:

   pod 'Protobuf', '3.13'

3. نفِّذ "pod install" في المجلد الجذر لمشروعك.
2. إذا كان مشروعك لا يستخدم CocoaPods:
1. إزالة الإصدار الحالي من GoogleCastSDK إن توفّر
2. أضف مكتبة Protobuf v3.13 أو أحدث، باتباع التعليمات الواردة في Protobuf GitHub المستودع.
2. في مشروع Xcode، أضِف العلامات -ObjC -lc++ إلى إعدادات الإصدار > علامات الروابط الأخرى:
3. حدد موقع مجلد "Resources" (الموارد) في الدليل غير المضغوط سحب GoogleCastCoreResources.bundle، GoogleCastUIResources.bundle وMaterialDialogs.bundle في مشروعك بجوار GoogleCast.xcframework التي تمت إضافتها مسبقًا. ضَع علامة في المربّع بجانب "نسخ كل العناصر عند الحاجة" وأضِفها إلى الكل. المستهدفة.

إعداد Mac Catalyst

بالنسبة إلى التطبيقات التي تتيح استخدام Mac Catalyst، يمكنك استخدام المكتبة الديناميكية لحزمة Cast SDK. اتّبِع عملية الإعداد اليدوي لإضافة إطار عمل أجايل لمشروعك. بعد ذلك، عليك استثناء حزمة تطوير البرامج (SDK) لـ Cast من نظام التشغيل Mac بشكل مشروط. كما هو مذكور في مستندات Apple يتم تجميع المكتبات الثابتة مسبقًا لبنية iOS، ما يؤدي إلى ظهور رابط عند إنشاء خطأ في مقابل هدف Mac.