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

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

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

   <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

   מומלץ גם לפרסם מחדש את האפליקציה באמצעות גרסה 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 שחולץ אל הפרויקט הראשי ב-Xcode Project Navigator (לא אל פרויקט ה-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.