Configuração para desenvolver com o framework de aplicativo do Google Cast (CAF, na sigla em inglês) para iOS

O framework do Google Cast oferece suporte ao iOS 14 e versões mais recentes e vem em frameworks estáticos e dinâmicos.

Consulte a Referência da API Google Cast para iOS para descrições de todas as classes e métodos.

Observação:novas versões dos XCFrameworks do SDK do Cast para iOS já estão disponíveis, com suporte ao desenvolvimento em computadores Apple Silicon.

Configuração do Xcode

Aviso: como definir a sinalização Apple Clang - Code Generation Optimization Level para -Ofast para "Otimizações mais rápidas e agressivas" vai fazer com que os apps que usam Transmita o SDK do iOS para falhar devido a incompatibilidades com as otimizações. O SDK oferece suporte ao valor padrão -Os para "Mais rápido, o menor".

iOS 14

Aviso do iOS 14: mudanças no iOS 14 as permissões de acesso à rede local afetaram o SDK do Google Cast para iOS em de várias maneiras. Consulte a Mudanças no iOS 14 documento para saber como seu app é afetado.

1. Adicionar o SDK do Cast para iOS 4.8.3 ao projeto

   Se estiver usando CocoaPods, use pod update para adicionar o SDK 4.8.3 ao seu projeto.

   Caso contrário, extrair o SDK manualmente.

   Observação: se você criou um seletor de dispositivos personalizado no app, será necessário para chamar explicitamente o método startDiscovery na GCKDiscoveryManager para iniciar a descoberta de dispositivos. A verificação automática foi desativada por padrão a partir da versão v4.5.0 do SDK do Cast.
2. Adicione NSBonjourServices ao seu Info.plist

   Especifique NSBonjourServices no seu Info.plist para permitem que a descoberta de rede local funcione no iOS 14.

   Você precisará adicionar _googlecast._tcp e _<your-app-id>._googlecast._tcp como serviços para o dispositivo a descoberta funcione corretamente.

   O appID é seu receiverID, que é o mesmo ID definido no GCKDiscoveryCriteria:

   Atualize o exemplo a seguir da definição NSBonjourServices e substitua "ABCD1234" pelo seu appID.

   <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.3 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

No seu projeto, especifique um intervalo para os pods a fim de evitar erros alterações interruptivas, conforme detalhado nas guia de podcast.

Neste snippet, a versão 4.8.3 e as versões até a próxima versão principal (major.minor.patch) são permitidas:

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

Por exemplo, '~> 1.6.7' incluiria todas as versões a partir da 1.6.7 até, mas não incluindo a versão 2.0.0.

Configuração manual

As instruções a seguir são para adicionar o SDK do Cast para iOS ao seu projeto sem usar CocoaPods:

Importante:a partir da versão 4.3.1, O CocoaPods usa bibliotecas estáticas para evitar avisos de símbolo duplicados causados por uma dependência da biblioteca Protobuf compartilhada ao usar os SDKs do Firebase e do Cast juntas. Essa mudança vai resultar em um download maior, mas a versão final não aumenta.

Se a diferença de tamanho for uma preocupação para sua situação, faça o download do biblioteca dinâmica para chegar a um tamanho semelhante às versões do CocoaPods anteriores à 4.3.1; biblioteca.

Downloads

Após fazer o download da biblioteca apropriada abaixo, siga as etapas de configuração para adicionar a estrutura à sua projeto.

Transmita bibliotecas do SDK Sender do iOS 4.8.3:

Estático Dinâmico

Etapas da configuração

Para instalar a biblioteca:

1. Faça o download e extraia o SDK apropriado para seu projeto.
2. Configure a biblioteca dinâmica do GoogleCastSDK:
3. Arraste o arquivo .xcframework descompactado para seu projeto principal no Navegador do projeto do Xcode (não no projeto de pods, se você tiver um). Marque "Copiar todos os itens, se necessário" e adicione a todos os destinos.
4. No destino do Xcode, na guia General, selecione Embed and Sign para GoogleCast.xcframework.

Se você estiver configurando a biblioteca static, siga estas etapas, além de etapas anteriores:

1. Configurar a biblioteca Protobuf com a versão mínima v3.13.
1. Se o projeto usa CocoaPods:
1. Abra o Podfile e remova o google-cast-sdk, se presente:

   pod 'google-cast-sdk'

2. Adicione a biblioteca Protobuf, se ela não estiver presente:

   pod 'Protobuf', '3.13'

3. Execute pod install na pasta raiz do seu projeto.
2. Se o projeto não estiver usando CocoaPods:
1. Remove a versão atual de GoogleCastSDK, se houver.
2. Adicione a biblioteca Protobuf v3.13 ou mais recente. seguindo as instruções Protobuf no GitHub gcloud.
2. No projeto do Xcode, adicione as flags -ObjC -lc++ ao Configurações da versão > Outras sinalizações do vinculador.
3. Localize a pasta "Resources" no diretório descompactado e arrastar GoogleCastCoreResources.bundle, GoogleCastUIResources.bundle e MaterialDialogs.bundle no projeto ao lado do GoogleCast.xcframework que você adicionados anteriormente. Marque "Copiar todos os itens, se necessário" e adicione a todos de destino.

Configuração do Mac Catalyst

Para apps compatíveis com o Mac Catalyst, use a biblioteca dinâmica do SDK do Cast. Siga o processo de configuração manual para adicionar o estrutural ao seu projeto. Em seguida, exclua condicionalmente o SDK do Cast do Mac como mencionado nos Documentação da Apple. Bibliotecas estáticas são pré-compiladas para a arquitetura do iOS, o que faz com que um vinculador ao compilar no destino do Mac.