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

‫Cast Framework תומך ב-iOS מגרסה 15 ואילך, והוא זמין גם כמסגרת סטטית וגם כמסגרת דינמית.

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

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

הגדרה של Xcode

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

iOS 14

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

1. הוספת Cast iOS SDK 4.8.4 לפרויקט

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

   אחרת, שולפים את ה-SDK באופן ידני.

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

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

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

   מזהה האפליקציה הוא receiverID, שהוא אותו מזהה שמוגדר ב-GCKDiscoveryCriteria.

   מעדכנים את ההגדרה של הדוגמה הבאה ומחליפים את 'ABCD1234' במזהה האפליקציה.NSBonjourServices

   <key>NSBonjourServices</key>
   <array>
     <string>_googlecast._tcp</string>
     <string>_ABCD1234._googlecast._tcp</string>
   </array>

3. הוספה של NSLocalNetworkUsageDescription אל Info.plist

   מומלץ מאוד להתאים אישית את ההודעה שמוצגת בהנחיה לגבי הרשת המקומית, על ידי הוספת מחרוזת הרשאה ספציפית לאפליקציה בקובץ Info.plist של האפליקציה, למשל כדי לתאר את האיתור של Cast ושירותי איתור אחרים, כמו DIAL.NSLocalNetworkUsageDescription

   <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.4 בהקדם האפשרי.

iOS 13

אזהרה לגבי iOS 13: שינויים בהרשאות של Apple ב-iOS 13 וב-Xcode 11 השפיעו על Google Cast iOS SDK בכמה דרכים. כדי להבין איך השינויים האלה ישפיעו על האפליקציה שלכם, מומלץ לעיין במסמך בנושא שינויים ב-iOS 13.

‫iOS 12

אזהרה לגבי iOS 12: אם אתם מפתחים באמצעות Xcode 10, נדרשת היכולת 'גישה למידע על Wi-Fi' כדי לגלות מכשירים עם Cast ולהתחבר אליהם.

מוודאים שהמתג Access WiFi Information (גישה לפרטי ה-Wi-Fi) בקטע Capabilities (יכולות) של היעד מוגדר למצב 'On' (מופעל).

בנוסף, פרופיל ההקצאה צריך לתמוך ביכולת Access WiFi Information. אפשר להוסיף אותו ב-Apple Developer Portal.

הגדרת CocoaPods

הדרך המומלצת לשילוב של Google Cast היא באמצעות CocoaPods. כדי לבצע שילוב, משתמשים ב-CocoaPods‏ google-cast-sdk.

כדי להתחיל, צריך לפעול לפי המדריך למתחילים.

אחרי שמגדירים את 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

בפרויקט, צריך לציין טווח ל-Pods כדי למנוע שינויים לא צפויים שעלולים לשבור את הקוד, כמו שמפורט במדריך podfile.

בקטע הקוד הזה, מותרות גרסה 4.8.4 והגרסאות עד הגרסה העיקרית הבאה (major.minor.patch):

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

לדוגמה, '‎~> 1.6.7' יכלול את כל הגרסאות מ-1.6.7 ועד גרסה 2.0.0, לא כולל גרסה 2.0.0.

הגדרה ידנית

ההוראות הבאות מתייחסות להוספת Cast iOS SDK לפרויקט בלי להשתמש ב-CocoaPods:

נקודה חשובה: החל מגרסה 4.3.1,‏ CocoaPods משתמש בספריות סטטיות כדי למנוע אזהרות על סמלים כפולים שנגרמות כתוצאה מתלות בספריית Protobuf משותפת כשמשתמשים ב-Firebase וב-Cast SDK ביחד.

החל מגרסה 4.8.4, אם אתם משתמשים בספרייה אחרת שתלויה ב-Protobuf (כמו Firebase), גודל האפליקציה הסופי יגדל.

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

הורדות

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

ספריות Cast iOS Sender SDK 4.8.4:

סטטי דינמי

שלבי ההגדרה

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

1. מורידים ומחלצים את ה-SDK המתאים לפרויקט.
2. מגדירים את הספרייה הדינמית GoogleCastSDK:
3. גוררים את הקובץ .xcframework שלאחר פתיחת ה-zip אל הפרויקט הראשי בחלונית הניווט של פרויקט Xcode (לא אל פרויקט ה-Pods אם יש כזה). מסמנים את האפשרות 'העתקת כל הפריטים אם צריך' ומוסיפים לכל יעדי הטרגוט.
4. בכרטיסייה General של יעד Xcode, בוחרים באפשרות Embed and Sign בשדה 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 בגרסה 3.13 ומעלה, לפי ההוראות שמופיעות במאגר Protobuf GitHub.

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

1. בפרויקט Xcode, מוסיפים את הדגלים -ObjC -lc++ אל Build Settings (הגדרות ה-Build) > Other Linker Flags (דגלי מקשר אחרים).
2. מאתרים את התיקייה Resources בספרייה שחולצה וגוררים את כל הקבצים .bundle אל הפרויקט לצד הקובץ GoogleCast.xcframework שהוספתם קודם. מסמנים את התיבה 'העתקת כל הפריטים אם צריך' ומוסיפים את הפריטים לכל יעדי הטרגוט.

הגדרה של Mac Catalyst

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