Przygotowanie do programowania za pomocą platformy Cast Application Framework (CAF) na iOS

Platforma Cast obsługuje iOS 14 i nowsze wersje. statyczne i dynamiczne struktury.

Zobacz materiały referencyjne na temat interfejsu Google Cast iOS API dla opisy wszystkich klas i metod.

Uwaga: nowe wersje pakietu SDK Cast na iOS jest już dostępny XCFrameworks, na komputerach Apple Silicon.

Konfiguracja Xcode

Ostrzeżenie: ustawienie flagi Apple Clang - Code Generation Optimization Level do -Ofast w sekcji „Najszybsze, agresywne optymalizacje” spowoduje, że aplikacje używające Przesyłanie pakietu SDK na iOS do awarii z powodu niezgodności z optymalizacjami. Pakiet SDK obsługuje domyślną wartość -Os opcji „Fastest, Smallest” (Najszybszy, Najmniejszy).

iOS 14

Ostrzeżenie dotyczące systemu iOS 14: zmiany w systemie iOS 14 uprawnienia dostępu do sieci lokalnej wpłynęły na pakiet SDK Google Cast na iOS na różne sposoby. Zapoznaj się z Zmiany związane z iOS 14 i dowiedz się, jaki to będzie miało wpływ na Twoją aplikację.

1. Dodawanie do projektu pakietu SDK Cast na iOS 4.8.1

   Jeśli korzystasz z CocoaPods, dodaj do projektu pakiet SDK 4.8.1 za pomocą pod update.

   W przeciwnym razie ręcznie pobrać pakiet SDK.

   Uwaga:jeśli masz w aplikacji niestandardowy selektor urządzeń, jawnie wywołać metodę startDiscovery w funkcji GCKDiscoveryManager , aby zainicjować wykrywanie urządzeń. Automatyczne skanowanie zostało wyłączone przez domyślnie począwszy od wersji 4.5.0 pakietu Cast SDK.
2. Dodaj: NSBonjourServices do: Info.plist

   Podaj NSBonjourServices w polu Info.plist na pozwala na skuteczne wykrywanie sieci lokalnej na urządzeniach z iOS 14.

   Musisz dodać zarówno _googlecast._tcp, jak i _<your-app-id>._googlecast._tcp jako usługi dla urządzenia ich prawidłowe działanie.

   Identyfikator appID to Twój odbiorca ID, czyli ten sam identyfikator zdefiniowany w GCKDiscoveryCriteria

   Zaktualizuj definicję iNSBonjourServicesponiższy przykład zastąp „ABCD1234” z identyfikatorem aplikacji.

   <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

W projekcie musisz określić zakres dla podów, aby zapobiec nieoczekiwanym zmiany powodujące niezgodność opisane w podfile.

W tym fragmencie kodu wersja 4.8.1 oraz kolejne wersje wersja główna (major.minor.patch) jest dozwolona:

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

Na przykład „~>”. 1.6.7' będzie obejmować wszystkie wersje od 1.6.7 aż do, ale nie w tym wersję 2.0.0.

Konfiguracja ręczna

Wykonaj te instrukcje, aby dodać do projektu pakiet SDK Cast na iOS bez korzystania z CocoaPods:

Ważne: od wersji 4.3.1 CocoaPods korzysta z bibliotek statycznych, aby unikać zduplikowanych ostrzeżeń o symbolach spowodowanych przez współużytkowana zależność biblioteki Protobuf podczas korzystania z pakietów SDK Firebase i Cast razem. Choć ta zmiana spowoduje większe pobieranie, ostateczna aplikacja rozmiar nie zwiększy się.

Jeśli różnica w rozmiarze jest w Twojej sytuacji problem, pobierz biblioteki dynamicznej, aby uzyskać rozmiar podobny do wersji CocoaPods sprzed 4.3.1 bibliotece.

Pobrane

Po pobraniu odpowiedniej biblioteki postępuj zgodnie z kroków konfiguracji, aby dodać platformę do platformy w projektach AI.

Biblioteki pakietu SDK Cast SDK 4.8.1 do przesyłania na iOS:

Statyczny Dynamiczne

Instrukcje konfiguracji

Aby zainstalować bibliotekę:

1. Pobierz i wyodrębnij odpowiedni pakiet SDK dla swojego projektu.
2. Skonfiguruj dynamiczną bibliotekę GoogleCastSDK:
3. Przeciągnij rozpakowany plik .xcframework do głównego projektu Nawigator projektów Xcode (nie do projektu podów, jeśli taki masz). Zaznacz opcję „W razie potrzeby skopiuj wszystkie elementy” i dodaj ją do wszystkich elementów docelowych.
4. W miejscu docelowym Xcode na karcie General wybierz Embed and Sign dla GoogleCast.xcframework.

Jeśli konfigurujesz bibliotekę statyczną, oprócz poprzednie kroki:

1. Konfigurowanie biblioteki Protobuf z minimalną wersją wersja 3.13.
1. Jeśli Twój projekt używa CocoaPods:
1. Otwórz aplikację Podfile i usuń google-cast-sdk (jeśli występuje):

   pod 'google-cast-sdk'

2. Dodaj bibliotekę Protobuf, jeśli jej nie ma:

   pod 'Protobuf', '3.13'

3. Uruchom pod install w folderze głównym projektu.
2. Jeśli Twój projekt nie korzysta z CocoaPods:
1. Usuń bieżącą wersję pakietu GoogleCastSDK, jeśli jest dostępna.
2. Dodaj bibliotekę Protobuf w wersji 3.13 lub nowszej, postępując zgodnie z instrukcjami podanymi na Protokół GitHub .
2. W projekcie Xcode dodaj flagi -ObjC -lc++ do Ustawienia kompilacji > Inne flagi łączące.
3. W rozpakowanym katalogu znajdź folder Resources przeciągnij: GoogleCastCoreResources.bundle, GoogleCastUIResources.bundle i MaterialDialogs.bundle obok projektu GoogleCast.xcframework dodane wcześniej. Zaznacz „W razie potrzeby skopiuj wszystkie elementy” i dodaj do wszystkich celów.

Konfiguracja Mac Catalyst

W przypadku aplikacji obsługujących Mac Catalyst użyj biblioteki dynamicznej z pakietu Cast SDK. Wykonaj ręczną konfigurację, aby dodać parametr platformy w projekcie. Następnie warunkowo wyklucz pakiet SDK Cast na Macu zgodnie z opisem w Dokumentacja Apple Biblioteki statyczne są wstępnie skompilowane pod kątem architektury iOS, co powoduje podczas kompilacji na komputerze Mac.