إعداد التطوير باستخدام إطار عمل تطبيق 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. إضافة NSLocalNetworkUsageDescription إلى Info.plist

   ننصحك بشدة بتخصيص الرسالة التي تظهر في الدليل المحلي إشعار الشبكة من خلال إضافة سلسلة إذن خاص بالتطبيق في قسم ملف Info.plist NSLocalNetworkUsageDescription مثل وصف البث وخدمات الاكتشاف الأخرى مثل 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.3 في أقرب وقت ممكن.

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

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

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

تحذير لنظام التشغيل iOS 12: في حال تطوير التطبيق باستخدام Xcode 10، فإن "الوصول إلى معلومات WiFi" الإمكانيات اللازمة لاكتشاف أجهزة البث وربطها.

تأكَّد من استخدام مفتاح التبديل الوصول إلى معلومات WiFi في الإمكانات. ضبط الجزء المستهدف على "تفعيل".

بالإضافة إلى ذلك، يجب أن يتوافق ملفك الشخصي للتوفير مع ميزة الوصول إلى WiFi. قدرة المعلومات. يمكن إضافة ذلك في بوابة مطوّري برامج Apple

إعداد CocoaPods

والطريقة الموصى بها لدمج Google Cast هي استخدام CocoaPods. للدمج، استخدم دالة google-cast-sdk CocoaPods

للبدء، اتبع دليل البدء.

بعد إعداد CocoaPods، اتّبِع دليل استخدام CocoaPods لإنشاء Podfile وتجهيز مشروعك للاستخدام مع Google Cast SDK.

في ما يلي مثال على كيفية إضافة google-cast-sdk CocoaPod إلى 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) لتطبيق Cast على نظام التشغيل iOS إلى مشروعك بدون استخدام 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.