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. Adicione NSLocalNetworkUsageDescription à sua Info.plist

   Recomendamos que você personalize a mensagem exibida no campo Solicitação de rede adicionando uma string de permissão específica ao comando Info.plist para o NSLocalNetworkUsageDescription, como para descrever o Cast descoberta e outros serviços de descoberta, como DIAL.

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

   Essa mensagem aparecerá como parte da caixa de diálogo "Acesso à rede local do iOS" como mostrados na simulação.

   
4. Lançar seu app novamente na App Store da Apple

   Recomendamos também lançar o app novamente usando a versão 4.8.3 assim que possível.

iOS 13

Aviso do iOS 13: Apple As mudanças nas permissões para iOS 13 e Xcode 11 afetaram o Google Cast para iOS SDK de várias formas. Consulte a Mudanças no iOS 13 documento para saber como seu app vai ser afetado.

iOS 12

Aviso do iOS 12: se você estiver desenvolvendo usando o Xcode 10, o link "Acessar informações Wi-Fi" é necessário para para descobrir e se conectar a dispositivos de transmissão.

Verifique se a opção Acessar informações do Wi-Fi em Capacidades do destino seja definida como "Ativada".

Além disso, seu perfil de provisionamento precisará ser compatível com a rede Access Wi-Fi Information. Isso pode ser adicionado no Portal do desenvolvedor da Apple.

Configuração do CocoaPods

A forma recomendada de integrar o Google Cast é usar CocoaPods Para integração, use o método google-cast-sdk CocoaPods.

Para começar, siga as guia de primeiros passos.

Depois de configurar o CocoaPods, siga as como usar o guia de CocoaPods para criar o Podfile e preparar o projeto para uso com o Google Cast SDK do Vertex AI Pipelines.

Veja um exemplo de como adicionar o CocoaPod google-cast-sdk ao seu 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

Para seu projeto, especifique um intervalo para os pods para evitar mudanças quebradas inesperadas, conforme detalhado no guia de podfiles.

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 em um projeto de IA.

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