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

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

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

راه اندازی Xcode

iOS 14

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

   اگر از 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" را با شناسه برنامه خود جایگزین کنید.

   <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 12

اطمینان حاصل کنید که سوئیچ 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 است:

دانلودها

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

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