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

1. Dodaj do projektu pakiet Cast iOS SDK 4.8.4

   Jeśli używasz CocoaPods, dodaj do projektu pakiet SDK w wersji 4.8.4 za pomocą polecenia pod update.

   W przeciwnym razie, pobierz pakiet SDK ręcznie.

2. Dodaj NSBonjourServices do pliku Info.plist

   Określ NSBonjourServices w pliku Info.plist, aby umożliwić wykrywanie sieci lokalnej w iOS 14.

   Aby wykrywanie urządzeń działało prawidłowo, musisz dodać zarówno _googlecast._tcp, jak i _<your-app-id>._googlecast._tcp jako usługi.

   AppID to Twój receiverID, czyli ten sam identyfikator, który jest zdefiniowany w GCKDiscoveryCriteria.

   Zaktualizuj poniższy przykład definicji NSBonjourServices i zastąp "ABCD1234" swoim appID.

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

3. Dodaj NSLocalNetworkUsageDescription do swojego Info.plist

   Zdecydowanie zalecamy dostosowanie komunikatu wyświetlanego w prośbie o dostęp do sieci lokalnej przez dodanie do pliku aplikacji ciągu uprawnień specyficznych dla aplikacji w przypadku takich jak aby opisać wykrywanie Cast i inne usługi wykrywania, takie jak DIAL.Info.plistNSLocalNetworkUsageDescription

   <key>NSLocalNetworkUsageDescription</key>
   <string>${PRODUCT_NAME} uses the local network to discover Cast-enabled devices on your WiFi
   network.</string>

   Ten komunikat będzie wyświetlany w oknie dialogowym dostępu do sieci lokalnej w iOS, jak pokazano na makiecie.

   
4. Ponownie opublikuj aplikację w Apple App Store

   Zalecamy jak najszybsze ponowne opublikowanie aplikacji w wersji 4.8.4.

iOS 13

iOS 12

Upewnij się, że przełącznik Access WiFi Information (Dostęp do informacji o Wi-Fi) w sekcji Capabilities (Możliwości) celu jest ustawiony na „On” (Włączone).

Twój profil aprowizacji musi też obsługiwać funkcję Access WiFi Information (Dostęp do informacji o Wi-Fi). Możesz ją dodać w portalu dla deweloperów Apple.

Konfiguracja CocoaPods

Zalecamy integrację Google Cast za pomocą CocoaPods. Do integracji użyj google-cast-sdk CocoaPods.

Aby rozpocząć, zapoznaj się z przewodnikiem dla początkujących.

Po skonfigurowaniu CocoaPods postępuj zgodnie z instrukcjami w przewodniku dotyczącym korzystania z CocoaPods, aby utworzyć plik Podfile i przygotować projekt do użycia z pakietem Google Cast SDK.

Oto przykład dodawania CocoaPod google-cast-sdk do pliku 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

W przypadku projektu należy określić zakres dla podów, aby zapobiec nieoczekiwanym zmianom powodującym niezgodność, jak opisano w przewodniku po pliku Podfile.

W tym fragmencie kodu dozwolone są wersja 4.8.4 i wersje do następnej wersji głównej (major.minor.patch):

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

Na przykład „~> 1.6.7” obejmuje wszystkie wersje od 1.6.7 do 2.0.0, ale nie obejmuje wersji 2.0.0.

Konfiguracja ręczna

Poniższe instrukcje dotyczą dodawania pakietu Cast iOS SDK do projektu bez użycia CocoaPods:

Pobrane

Po pobraniu odpowiedniej biblioteki wykonaj czynności opisane w sekcji Konfiguracja, aby dodać platformę do projektu.

Biblioteki pakietu Cast iOS Sender SDK 4.8.4:

Statyczna Dynamiczna

Instrukcje konfiguracji

Aby zainstalować bibliotekę:

1. Pobierz i rozpakuj odpowiedni pakiet SDK dla swojego projektu.
2. Skonfiguruj dynamiczną bibliotekę GoogleCastSDK:
3. Przeciągnij rozpakowany plik .xcframework do głównego projektu w nawigatorze projektu Xcode (nie do projektu Pods, jeśli go masz). Zaznacz opcję „Copy all items if needed” (Skopiuj wszystkie elementy w razie potrzeby) i dodaj do wszystkich celów.
4. W celu Xcode na karcie General wybierz Embed and Sign w przypadku GoogleCast.xcframework.

Jeśli konfigurujesz bibliotekę dynamiczną, oprócz poprzednich kroków wykonaj te czynności:

1. Skonfiguruj bibliotekę Protobuf z minimalną wersją 3.13.
1. Jeśli Twój projekt korzysta z CocoaPods:
1. Otwórz plik Podfile i usuń google-cast-sdk jeśli jest obecny:

   pod 'google-cast-sdk'

2. Jeśli biblioteka Protobuf nie jest obecna, dodaj ją:

   pod 'Protobuf', '3.13'

3. W folderze głównym projektu uruchom polecenie pod install.
2. Jeśli Twój projekt nie korzysta z CocoaPods:
1. Usuń bieżącą wersję GoogleCastSDK, jeśli jest obecna.
2. Dodaj bibliotekę Protobuf w wersji 3.13 lub nowszej, postępując zgodnie z instrukcjami w repozytorium Protobuf GitHub repo.

Jeśli konfigurujesz bibliotekę statyczną, oprócz poprzednich kroków wykonaj te czynności:

1. W projekcie Xcode dodaj flagi -ObjC -lc++ do Build Settings > Other Linker Flags.
2. Znajdź folder Resources w rozpakowanym katalogu i przeciągnij wszystkie pliki .bundle do projektu obok GoogleCast.xcframework dodanego wcześniej. Zaznacz opcję „Copy all items if needed” (Skopiuj wszystkie elementy w razie potrzeby) i dodaj do wszystkich celów.

Konfiguracja Mac Catalyst

W przypadku aplikacji obsługujących Mac Catalyst użyj dynamicznej biblioteki pakietu Cast SDK. Aby dodać platformę do projektu, wykonaj ręczną konfigurację. Następnie warunkowo wyklucz pakiet Cast SDK z celu Mac jak wspomniano w dokumentacji Apple. Biblioteki statyczne są wstępnie skompilowane pod kątem architektury iOS, co powoduje błąd konsolidatora podczas kompilowania pod kątem celu Mac.