framework של Cast תומך ב-iOS 14 ואילך, ומגיע סטטיות ודינמיות.
אפשר לעיין בחומר העזר בנושא API של Google Cast ב-iOS כדי לקבל תיאורים של כל הסוגים והשיטות.
הגדרת Xcode
iOS 14
-
מוסיפים את Cast של iOS SDK 4.8.1 לפרויקט
אם משתמשים ב-CocoaPods, אפשר להשתמש ב-
pod update
כדי להוסיף לפרויקט את גרסה 4.8.1 SDK.אחרת, שליפה ידנית של ה-SDK.
-
הוספת
NSBonjourServices
אלInfo.plist
יש לציין
NSBonjourServices
ב-Info.plist
כדי לאפשר גילוי רשת מקומית ב-iOS 14.צריך להוסיף גם
_googlecast._tcp
וגם_<your-app-id>._googlecast._tcp
בתור שירותים למכשיר כדי שהוא יפעל כראוי.ה-appID הוא ה-ReceiverID שלך, שהוא אותו מזהה שמוגדר
GCKDiscoveryCriteria
מעדכנים את ההגדרה הבאה של
NSBonjourServices
לדוגמה, ו מחליפים את ABCD1234 עם ה-appID שלכם. -
Add
NSLocalNetworkUsageDescription
to yourInfo.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 theNSLocalNetworkUsageDescription
such as to describe Cast discovery and other discovery services, like DIAL.This message will appear as part of the iOS Local Network Access dialog as shown in the mock.
-
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 12
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:
הורדות
אחרי שמורידים את הספרייה המתאימה, צריך לפעול לפי שלבי ההגדרה להוספת ה-framework פרויקט.
ספריות של Cast iOS Sender SDK 4.8.1:
שלבי ההגדרה
כדי להתקין את הספרייה:
- מורידים ומחלצים את ה-SDK המתאים לפרויקט.
- מגדירים את הספרייה הדינמית של GoogleCastSDK:
-
גוררים את
.xcframework
שחילצתם אל הפרויקט הראשי ב ניווט בפרויקט Xcode (לא לפרויקט Pods, אם יש כזה). מסמנים את האפשרות 'העתקת כל הפריטים במקרה הצורך' ומוסיפים אותה לכל היעדים. -
ביעד Xcode, בכרטיסייה
General
, בוחרים אתEmbed and Sign
עבורGoogleCast.xcframework
.
אם אתם מגדירים את הספרייה הסטטית, צריך לבצע גם את השלבים הבאים את השלבים הקודמים:
- הגדרת ספריית Protobuf עם הגרסה המינימלית גרסה 3.13.
- אם בפרויקט שלכם משתמשים ב-CocoaPods:
-
יש לפתוח את
Podfile
ולהסיר אתgoogle-cast-sdk
אם קיים:pod 'google-cast-sdk'
-
מוסיפים את הספרייה
Protobuf
אם היא לא קיימת:pod 'Protobuf', '3.13'
-
מריצים את הפקודה
pod install
בתיקיית הבסיס של הפרויקט. - אם בפרויקט שלכם לא נעשה שימוש ב-CocoaPods:
-
יש להסיר את הגרסה הנוכחית של
GoogleCastSDK
, אם יש כזו. - מוסיפים את ספריית Protobuf גרסה 3.13 ומעלה, לפי ההוראות Protobuf GitHub מאגר תגים.
-
בפרויקט Xcode, מוסיפים את הדגלים
-ObjC -lc++
אל הגדרות Build > סימונים אחרים מסוג Linker -
מוצאים את תיקיית המשאבים בספרייה המכווצת
גרירה של
GoogleCastCoreResources.bundle
,GoogleCastUIResources.bundle
וגםMaterialDialogs.bundle
לפרויקט שלך לצדGoogleCast.xcframework
נוסף קודם לכן. מסמנים את האפשרות 'העתקת כל הפריטים במידת הצורך' ומוסיפים אותם לכולם יעדים.
הגדרת Catalyst של Mac
לאפליקציות שתומכות ב-Mac Catalyst, צריך להשתמש בספרייה הדינמית של Cast SDK. מבצעים את תהליך ההגדרה הידנית כדי להוסיף את ב-framework של הפרויקט. לאחר מכן מחריגים את ה-SDK של Cast מ-Mac באופן מותנה כמו שמצוין מסמכי תיעוד של Apple. הספריות הסטטיות עוברות הידור מראש לארכיטקטורת iOS, ולכן גורם לקישור בזמן הבנייה של יעד ה-Mac.