راه‌اندازی برای توسعه با «چارچوب برنامه Cast» (CAF) برای iOS

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

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

راه‌اندازی Xcode

  1. افزودن Cast iOS SDK 4.8.6 به پروژه

    اگر از Swift Package Manager استفاده می‌کنید، بسته google-cast-ios-sdk را به نسخه ۴.۸.۶ به‌روز کنید.

    درغیراین‌صورت، کیت توسعه نرم‌افزار را به‌صورت دستی وارد کنید.

  2. افزودن NSBonjourServices به Info.plist

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

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

    appID همان receiverID شما است که در 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 و دیگر سرویس‌های کاوش، مثل 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

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

راه‌اندازی Swift Package Manager

روش توصیه‌شده برای ادغام Google Cast استفاده از مدیر بسته Swift (SPM) است. بسته Cast iOS SDK از مخزن GitHub google-cast-ios-sdk دردسترس است.

برای افزودن Cast iOS SDK به پروژه خود در Xcode:

  1. در Xcode، فایل > افزودن بسته‌ها… را انتخاب کنید.
  2. نشانی وب مخزن را وارد کنید: https://github.com/googlecast/google-cast-ios-sdk.
  3. قوانین نسخه‌گذاری‌تان را انتخاب کنید. برای مثال، تا نسخه عمده بعدی را با حداقل نسخه ۴.۸.۶ انتخاب کنید تا به‌روزرسانی‌های سازگار را بدون تغییرات مخرب غیرمنتظره دریافت کنید.
  4. روی افزودن بسته کلیک کنید.
  5. محصول GoogleCastDynamic یا GoogleCastStatic را انتخاب کنید، و آن را به هدف برنامه‌تان اضافه کنید.

انتخاب نوع چارچوب

بسته Cast iOS SDK دو محصول ارائه می‌دهد:

  • GoogleCastDynamic: چارچوب پویا. این کتابخانه شامل همه منابع دارایی موردنیاز مؤلفه‌های Cast UI است و به هیچ پرچم پیونددهنده اضافی نیاز ندارد. برنامه‌هایی که از Mac Catalyst پشتیبانی می‌کنند باید از چارچوب پویا استفاده کنند. برای اطلاعات بیشتر، راه‌اندازی Mac Catalyst را ببینید.
  • GoogleCastStatic: چارچوب ایستا. این روش به مراحل راه‌اندازی اضافی نیاز دارد که در راه‌اندازی چارچوب ایستا شرح داده شده است.

راه‌اندازی چارچوب ایستا

چارچوب‌های ایستا نمی‌توانند شامل دسته‌های منبع باشند. درنتیجه، Swift Package Manager نمی‌تواند به‌طور خودکار منابع دارایی موردنیاز مؤلفه‌های Cast UI (مانند تصاویر UI، استوری‌بردها، و فایل‌های بومی‌سازی) را با محصول GoogleCastStatic بسته‌بندی کند. اگر GoogleCastStatic را به هدفتان اضافه کنید، مراحل زیر را تکمیل کنید:

  1. در پروژه Xcode، پرچم‌های -ObjC -lc++ را به تنظیمات ساخت > پرچم‌های دیگر پیونددهنده اضافه کنید.
  2. اگر برنامه‌تان از مؤلفه‌های Cast UI استفاده می‌کند، بسته‌های دارایی را به‌طور دستی به پروژه‌تان اضافه کنید:
    1. کتابخانه ایستا را از بارگیری‌ها بارگیری کنید. مطمئن شوید که نسخه کتابخانه ایستا با نسخه بسته‌ای که اضافه کرده‌اید مطابقت داشته باشد.
    2. پوشه Resources را در دایرکتوری از حالت فشرده خارج‌شده پیدا کنید و همه فایل‌های .bundle را به پروژه Xcode بکشید. «درصورت نیاز، همه موارد کپی شود» را علامت بزنید و به همه هدف‌ها اضافه کنید.

راه‌اندازی CocoaPods

تنظیم دستی

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

بارگیری‌ها

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

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

ایستا پویا

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

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

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

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

  1. نسخه فعلی GoogleCastSDK را درصورت وجود بردارید.
  2. کتابخانه Protobuf نسخه ۳.۱۳ یا بالاتر را با دنبال کردن دستورالعمل‌های موجود در مخزن Protobuf GitHub اضافه کنید.

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

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

راه‌اندازی Mac Catalyst

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

بعدی
حریم خصوصی