راه اندازی برای توسعه با 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.1 را به پروژه خود اضافه کنید

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

   در غیر این صورت، 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. 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.1 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

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

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

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

برای مثال، «~> 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.1 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 از قبل کامپایل شده اند، که باعث ایجاد خطای پیوند دهنده هنگام ساختن در برابر هدف مک می شود.