راه اندازی برای توسعه با Cast Application Framework (CAF) برای iOS

فریم ورک Cast از iOS 14 به بعد پشتیبانی می کند و در هر دو چارچوب استاتیک و پویا عرضه می شود.

برای توضیحات همه کلاس‌ها و روش‌ها به مرجع Google Cast iOS API مراجعه کنید.

توجه: نسخه‌های جدید Cast iOS SDK XCFrameworks اکنون در دسترس هستند که از توسعه در رایانه‌های Apple Silicon پشتیبانی می‌کنند.

راه اندازی Xcode

هشدار: تنظیم پرچم Apple Clang - Code Generation Optimization Level روی -Ofast برای «سریع‌ترین، بهینه‌سازی‌های تهاجمی» باعث می‌شود برنامه‌هایی که از Cast iOS SDK استفاده می‌کنند به دلیل ناسازگاری با بهینه‌سازی‌ها از کار بیفتند. SDK از مقدار پیش‌فرض -Os برای «سریع‌ترین، کوچک‌ترین» پشتیبانی می‌کند.

iOS 14

هشدار iOS 14 : تغییرات در مجوزهای دسترسی به شبکه محلی iOS 14 به طرق مختلف بر Google Cast iOS SDK تأثیر گذاشته است. لطفاً سند تغییرات iOS 14 را ببینید تا ببینید برنامه شما چه تأثیری دارد.

1. Cast iOS SDK 4.8.3 را به پروژه خود اضافه کنید

   اگر از CocoaPods استفاده می کنید، از pod update استفاده کنید تا SDK 4.8.3 را به پروژه خود اضافه کنید.

   در غیر این صورت، SDK را به صورت دستی بکشید .

   توجه : اگر یک انتخابگر دستگاه سفارشی در برنامه خود ایجاد کرده‌اید، باید صراحتاً متد startDiscovery را در کلاس GCKDiscoveryManager فراخوانی کنید تا کشف دستگاه را آغاز کنید. اسکن خودکار به طور پیش فرض با انتشار نسخه 4.5.0 Cast SDK غیرفعال شد.
2. NSBonjourServices به Info.plist خود اضافه کنید

   NSBonjourServices در Info.plist خود مشخص کنید تا امکان کشف شبکه محلی در iOS 14 با موفقیت انجام شود.

   شما باید هم _googlecast._tcp و هم _<your-app-id>._googlecast._tcp را به عنوان سرویس اضافه کنید تا کاوش دستگاه به درستی کار کند.

   appID همان شناسه گیرنده شما است که در 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 Discovery و سایر سرویس‌های کشف، مانند 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 مجدداً منتشر کنید.

iOS 13

هشدار iOS 13 : تغییرات مجوزهای اپل در iOS 13 و Xcode 11 به طرق مختلف بر Google Cast iOS SDK تأثیر گذاشته است. لطفاً سند تغییرات iOS 13 را ببینید تا ببینید برنامه شما چگونه تحت تأثیر قرار خواهد گرفت.

iOS 12

هشدار iOS 12 : اگر با استفاده از Xcode 10 در حال توسعه هستید، برای کشف و اتصال به دستگاه‌های Cast، به قابلیت «دسترسی به اطلاعات WiFi» نیاز است.

اطمینان حاصل کنید که سوئیچ Access WiFi Information در بخش قابلیت‌های هدف روی «روشن» تنظیم شده است.

علاوه بر این، نمایه تامین شما باید از قابلیت Access WiFi Information پشتیبانی کند. این را می توان در پورتال برنامه نویس اپل اضافه کرد.

راه اندازی 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

برای پروژه خود، باید محدوده ای را برای پادهای خود تعیین کنید تا از تغییرات شکسته غیرمنتظره همانطور که در راهنمای پادفایل توضیح داده شده است جلوگیری کنید.

در این قطعه، نسخه 4.8.3 و نسخه های تا نسخه اصلی بعدی (major.minor.patch) مجاز هستند:

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

برای مثال، «~> 1.6.7» شامل همه نسخه‌ها از 1.6.7 به بالا است، اما شامل نسخه 2.0.0 نمی‌شود.

راه اندازی دستی

دستورالعمل های زیر برای افزودن Cast iOS SDK به پروژه خود بدون استفاده از CocoaPods است:

نکته کلیدی: با شروع نسخه 4.3.1، CocoaPods از کتابخانه های ثابت استفاده می کند تا از هشدارهای نمادهای تکراری ناشی از وابستگی کتابخانه Protobuf مشترک هنگام استفاده از Firebase و Cast SDK با هم جلوگیری کند. اگرچه این تغییر منجر به دانلود بزرگتر می شود، اما اندازه نهایی برنامه افزایش نمی یابد.

اگر تفاوت اندازه برای وضعیت شما نگران کننده است، کتابخانه پویا را دانلود کنید تا اندازه ای مشابه نسخه های قبل از 4.3.1 کتابخانه CocoaPods داشته باشید.

دانلودها

پس از دانلود کتابخانه مناسب زیر، مراحل راه اندازی را دنبال کنید تا چارچوب را به پروژه خود اضافه کنید.

کتابخانه‌های iOS Sender SDK 4.8.3 Cast:

استاتیک دینامیک

مراحل راه اندازی

برای نصب کتابخانه:

1. SDK مناسب برای پروژه خود را دانلود و استخراج کنید.
2. کتابخانه پویا GoogleCastSDK را تنظیم کنید:
3. xcframework .xcframework خارج شده را به پروژه اصلی خود در ناوبری پروژه Xcode بکشید (اگر دارید به پروژه Pods نیستید). "در صورت نیاز همه موارد را کپی کنید" را علامت بزنید و به همه اهداف اضافه کنید.
4. در هدف Xcode خود، در زیر برگه General ، Embed and Sign for 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 GitHub ، کتابخانه Protobuf نسخه 3.13 یا بالاتر را اضافه کنید.
2. در پروژه Xcode خود، پرچم‌ها -ObjC -lc++ را به Build Settings > Other Linker Flags اضافه کنید.
3. پوشه Resources را در دایرکتوری زیپ نشده پیدا کنید و GoogleCastCoreResources.bundle ، GoogleCastUIResources.bundle و MaterialDialogs.bundle را در پروژه خود در کنار GoogleCast.xcframework که قبلاً اضافه کرده اید، بکشید. "در صورت نیاز همه موارد را کپی کنید" را علامت بزنید و به همه اهداف اضافه کنید.

راه اندازی Mac Catalyst

برای برنامه‌هایی که از Mac Catalyst پشتیبانی می‌کنند، از کتابخانه پویا Cast SDK استفاده کنید. فرآیند راه اندازی دستی را برای اضافه کردن چارچوب به پروژه خود دنبال کنید. سپس به طور مشروط Cast SDK را از هدف Mac حذف کنید، همانطور که در اسناد اپل ذکر شده است. کتابخانه های ایستا برای معماری iOS از قبل کامپایل شده اند، که باعث ایجاد خطای پیوند دهنده هنگام ساختن در برابر هدف مک می شود.