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

چارچوب Cast از iOS 15 و بالاتر پشتیبانی می‌کند و در دو چارچوب ایستا و پویا ارائه می‌شود.

برای توضیحات مربوط به همه کلاس‌ها و متدها، به مرجع API گوگل کست برای iOS مراجعه کنید.

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

تنظیمات Xcode

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

آی‌او‌اس ۱۴

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

1. کیت توسعه نرم‌افزار Cast iOS نسخه ۴.۸.۴ را به پروژه خود اضافه کنید.

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

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

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

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

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

   appID همان receiverID شماست که همان ID تعریف شده در 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 ، مانند توصیف کشف Cast و سایر سرویس‌های کشف، مانند DIAL، سفارشی کنید.

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

   این پیام به عنوان بخشی از پنجره‌ی دسترسی به شبکه‌ی محلی iOS، همانطور که در تصویر نشان داده شده است، ظاهر خواهد شد.

   
4. برنامه خود را دوباره در فروشگاه اپل منتشر کنید

   توصیه می‌کنیم در اسرع وقت برنامه خود را با استفاده از نسخه ۴.۸.۴ دوباره منتشر کنید.

آی‌او‌اس ۱۳

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

آی‌او‌اس ۱۲

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

مطمئن شوید که گزینه Access WiFi Information در بخش Capabilities در دستگاه هدف روی «روشن» تنظیم شده باشد.

علاوه بر این، پروفایل تأمین شما باید از قابلیت دسترسی به اطلاعات وای‌فای پشتیبانی کند. این قابلیت را می‌توان در پورتال توسعه‌دهندگان اپل اضافه کرد.

تنظیمات CocoaPods

روش پیشنهادی برای ادغام Google Cast استفاده از CocoaPods است. برای ادغام، از google-cast-sdk CocoaPods استفاده کنید.

برای شروع، راهنمای شروع به کار را دنبال کنید.

پس از راه‌اندازی CocoaPods، راهنمای استفاده از CocoaPods را دنبال کنید تا Podfile شما ایجاد شود و پروژه شما برای استفاده با Google Cast SDK آماده شود.

در اینجا مثالی از نحوه اضافه کردن google-cast-sdk CocoaPod به Podfile شما آورده شده است:

use_frameworks!

platform :ios, '15.0'

def target_pods
  pod 'google-cast-sdk'
end

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

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

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

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

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

تنظیم دستی

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

نکته کلیدی: از نسخه ۴.۳.۱ به بعد، CocoaPods از کتابخانه‌های ایستا برای جلوگیری از هشدارهای نمادهای تکراری ناشی از وابستگی مشترک به کتابخانه Protobuf هنگام استفاده همزمان از Firebase و Cast SDK استفاده می‌کند.

از نسخه ۴.۸.۴ به بعد، اگر از کتابخانه دیگری که به Protobuf وابسته است (مانند Firebase) استفاده می‌کنید، این کار باعث افزایش حجم نهایی برنامه می‌شود.

توصیه می‌کنیم برای جلوگیری از مشکلات احتمالی سازگاری نسخه‌ها با Protobuf، از کتابخانه استاتیک استفاده کنید. با این حال، اگر تفاوت حجم برای شما نگران‌کننده است، کتابخانه دینامیک را دانلود کنید تا حجمی مشابه نسخه‌های قبل از ۴.۳.۱ کتابخانه CocoaPods داشته باشید.

دانلودها

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

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

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

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

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

1. SDK مناسب پروژه خود را دانلود و اکسترکت کنید.
2. کتابخانه پویای GoogleCastSDK را راه‌اندازی کنید:
3. فایل .xcframework از حالت فشرده خارج شده را به داخل پروژه اصلی خود در ناوبری پروژه Xcode بکشید (اگر پروژه Pods دارید، آن را داخل آن قرار ندهید). گزینه «در صورت نیاز همه موارد را کپی کنید» را علامت بزنید و به همه اهداف اضافه کنید.
4. در Xcode target خود، در زیر تب General ، گزینه Embed and Sign for GoogleCast.xcframework را انتخاب کنید.

اگر در حال راه‌اندازی کتابخانه پویا هستید، علاوه بر مراحل قبلی، این مراحل را نیز دنبال کنید:

1. کتابخانه Protobuf را با حداقل نسخه v3.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 نسخه ۳.۱۳ یا بالاتر را طبق دستورالعمل‌های موجود در مخزن گیت‌هاب Protobuf اضافه کنید.

اگر در حال راه‌اندازی کتابخانه استاتیک هستید، علاوه بر مراحل قبلی، این مراحل را نیز دنبال کنید:

1. در پروژه Xcode خود، پرچم‌های -ObjC -lc++ ‎ را به Build Settings > Other Linker Flags اضافه کنید.
2. پوشه Resources را در پوشه‌ای که از حالت فشرده خارج کرده‌اید، پیدا کنید و تمام فایل‌های .bundle را به پروژه خود، کنار GoogleCast.xcframework که قبلاً اضافه کرده‌اید، بکشید. گزینه «در صورت نیاز، همه موارد را کپی کنید» را علامت بزنید و به همه اهداف اضافه کنید.

تنظیمات مک کاتالیست

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