הגדרה של פיתוח עם 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.3 לפרויקט

   אם משתמשים ב-CocoaPods, אפשר להשתמש ב-pod update כדי להוסיף לפרויקט את גרסה 4.8.3 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. הוספת 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.3 בשם בהקדם האפשרי.

iOS 13

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

iOS 12

אזהרה לגבי iOS 12: אם מפתחים באמצעות Xcode 10, הפונקציה "Access WiFi Information" נדרשת יכולת כדי לגלות מכשירי Cast ולהתחבר אליהם.

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

בנוסף, פרופיל הקצאת ההרשאות צריך לתמוך ב-Access Wi-Fi יכולות מידע. ניתן להוסיף את האפשרות הזו Apple Developer Portal.

הגדרת 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

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

בקטע הקוד הזה, גרסה 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:

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

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

הורדות

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

ספריות של אפליקציית Cast ל-iOS Sender SDK 4.8.3:

סטטי דינמית

שלבי ההגדרה

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

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.