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

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

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

إعداد Xcode

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

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

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

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

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

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

تأكَّد من استخدام مفتاح التبديل الوصول إلى معلومات 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.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.