הגדרה של פיתוח עם Cast Application Framework (CAF) ל-iOS

framework של Cast תומך ב-iOS 14 ואילך, ומגיע סטטיות ודינמיות.

אפשר לעיין בחומר העזר בנושא API של Google Cast ב-iOS כדי לקבל תיאורים של כל הסוגים והשיטות.

הערה: גרסאות חדשות של Cast iOS SDK XCFrameworks זמינים עכשיו, שתומך בפיתוח במחשבי Apple Silicon.

הגדרת Xcode

אזהרה: הגדרת הדגל Apple Clang - Code Generation Optimization Level אל -Ofast לצורך 'אופטימיזציות מהירות ואגרסיביות ביותר' תגרום לאפליקציות שמשתמשות בפלט הפעלת Cast של SDK ל-iOS כדי לקרוס בגלל חוסר תאימות לאופטימיזציות. ה-SDK יש תמיכה בערך ברירת המחדל -Os עבור 'Fastest, Smallest' (המהיר ביותר, הקטן ביותר).

iOS 14

אזהרה ל-iOS 14: שינויים ב-iOS 14 הרשאות הגישה לרשת המקומית השפיעו על ה-SDK של Google Cast ל-iOS בכל מיני דרכים. כדאי לעיין שינויים ב-iOS 14 כדי לבדוק איך האפליקציה מושפעת.

1. מוסיפים את Cast של iOS SDK 4.8.1 לפרויקט

   אם משתמשים ב-CocoaPods, אפשר להשתמש ב-pod update כדי להוסיף לפרויקט את גרסה 4.8.1 SDK.

   אחרת, שליפה ידנית של ה-SDK.

   הערה: אם יצרתם באפליקציה בורר מכשירים מותאם אישית, תצטרכו כדי לקרוא במפורש ל-method startDiscovery GCKDiscoveryManager כדי להפעיל גילוי מכשיר. הסריקה האוטומטית הושבתה על ידי כברירת מחדל, החל מגרסה 4.5.0 של Cast SDK.
2. הוספת NSBonjourServices אל Info.plist

   יש לציין NSBonjourServices ב-Info.plist כדי לאפשר גילוי רשת מקומית ב-iOS 14.

   צריך להוסיף גם _googlecast._tcp וגם _<your-app-id>._googlecast._tcp בתור שירותים למכשיר כדי שהוא יפעל כראוי.

   ה-appID הוא ה-ReceiverID שלך, שהוא אותו מזהה שמוגדר GCKDiscoveryCriteria

   מעדכנים את ההגדרה הבאה של NSBonjourServices לדוגמה, ו מחליפים את ABCD1234 עם ה-appID שלכם.

   <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

בפרויקט שלך, עליך לציין טווח לרצפים כדי למנוע שיבושים של שינויי תוכנה שעלולים לגרום לכשל podfile guide (מדריך podfile).

בקטע הקוד הזה, גרסה 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 משותפת בזמן השימוש בערכות ה-SDK של Firebase ו-Cast את כל החלקים. למרות שהשינוי הזה יוביל להורדה גדולה יותר, האפליקציה הסופית הגודל לא יגדל.

אם ההבדלים בגודל משפיעים על המצב שלכם, כדאי להוריד את לספרייה דינמית כדי לקבל גודל הדומה לגרסאות קודמות של CocoaPods לספרייה.

הורדות

אחרי שמורידים את הספרייה המתאימה, צריך לפעול לפי שלבי ההגדרה להוספת ה-framework פרויקט.

ספריות של Cast iOS Sender SDK 4.8.1:

סטטי דינמית

שלבי ההגדרה

כדי להתקין את הספרייה:

1. מורידים ומחלצים את ה-SDK המתאים לפרויקט.
2. מגדירים את הספרייה הדינמית של GoogleCastSDK:
3. גוררים את .xcframework שחילצתם אל הפרויקט הראשי ב ניווט בפרויקט Xcode (לא לפרויקט Pods, אם יש כזה). מסמנים את האפשרות 'העתקת כל הפריטים במקרה הצורך' ומוסיפים אותה לכל היעדים.
4. ביעד Xcode, בכרטיסייה General, בוחרים את Embed and Sign עבור 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 גרסה 3.13 ומעלה, לפי ההוראות Protobuf GitHub מאגר תגים.
2. בפרויקט Xcode, מוסיפים את הדגלים -ObjC -lc++ אל הגדרות Build > סימונים אחרים מסוג Linker
3. מוצאים את תיקיית המשאבים בספרייה המכווצת גרירה של GoogleCastCoreResources.bundle, GoogleCastUIResources.bundle וגם MaterialDialogs.bundle לפרויקט שלך לצד GoogleCast.xcframework נוסף קודם לכן. מסמנים את האפשרות 'העתקת כל הפריטים במידת הצורך' ומוסיפים אותם לכולם יעדים.

הגדרת Catalyst של Mac

לאפליקציות שתומכות ב-Mac Catalyst, צריך להשתמש בספרייה הדינמית של Cast SDK. מבצעים את תהליך ההגדרה הידנית כדי להוסיף את ב-framework של הפרויקט. לאחר מכן מחריגים את ה-SDK של Cast מ-Mac באופן מותנה כמו שמצוין מסמכי תיעוד של Apple. הספריות הסטטיות עוברות הידור מראש לארכיטקטורת iOS, ולכן גורם לקישור בזמן הבנייה של יעד ה-Mac.