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

O framework do Cast é compatível com o iOS 16 e versões mais recentes e está disponível em frameworks estáticos e dinâmicos.

Consulte a referência da API Google Cast para iOS para ver 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, oferecendo suporte ao desenvolvimento em computadores Apple Silicon.

Configuração do Xcode

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

1. Adicionar o SDK do Cast para iOS 4.8.6 ao seu projeto

   Se estiver usando o Gerenciador de pacotes do Swift, atualize o pacote google-cast-ios-sdk para a versão 4.8.6.

   Caso contrário, extraia o SDK manualmente.

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

   Especifique NSBonjourServices no seu Info.plist para permitir que a descoberta de rede local seja bem-sucedida.

   Você precisa adicionar _googlecast._tcp e _<your-app-id>._googlecast._tcp como serviços para que a descoberta de dispositivos funcione corretamente.

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

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

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

3. Adicione NSLocalNetworkUsageDescription ao seu Info.plist

   Recomendamos que você personalize a mensagem mostrada no prompt de rede local adicionando uma string de permissão específica do app no arquivo Info.plist do app para o NSLocalNetworkUsageDescription, como para descrever a descoberta do Cast 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 vai aparecer como parte da caixa de diálogo de acesso à rede local do iOS, conforme mostrado no modelo.

   
4. Relançar o app na App Store da Apple

   Recomendamos que você também lance novamente seu app usando a versão 4.8.6 assim que possível.

Configuração do Gerenciador de Pacotes do Swift

A maneira recomendada de integrar o Google Cast é usando o Gerenciador de pacotes do Swift (SPM, na sigla em inglês). O pacote do SDK do Cast para iOS está disponível no repositório do GitHub google-cast-ios-sdk.

Para adicionar o SDK do Cast para iOS ao seu projeto no Xcode:

1. No Xcode, selecione File > Add Packages....
2. Insira o URL do repositório: https://github.com/googlecast/google-cast-ios-sdk.
3. Selecione as regras de controle de versões. Por exemplo, selecione Até a próxima versão principal com uma versão mínima de 4.8.6 para receber atualizações compatíveis sem alterações interruptivas inesperadas.
4. Clique em Adicionar pacote.
5. Selecione o produto GoogleCastDynamic ou GoogleCastStatic e adicione-o ao destino do app.

Aviso: adicione apenas um dos produtos GoogleCastDynamic ou GoogleCastStatic ao destino. Não adicione as duas variantes do SDK ao mesmo app.

Escolher uma variante de framework

O pacote do SDK do Cast para iOS oferece dois produtos:

• GoogleCastDynamic: o framework dinâmico. Ele inclui todos os recursos necessários para os componentes de interface do Cast e não requer sinalizações de vinculador adicionais. Os apps compatíveis com o Mac Catalyst precisam usar o framework dinâmico. Para mais informações, consulte Configuração do Mac Catalyst.
• GoogleCastStatic: o framework estático. Ele requer as etapas de configuração adicionais descritas em Configuração de framework estático.

Configuração de framework estático

Os frameworks estáticos não podem incluir pacotes de recursos. Como resultado, o Gerenciador de pacotes do Swift não pode agrupar automaticamente os recursos necessários para os componentes da interface do Cast (como imagens da interface, storyboards e arquivos de localização) com o produto GoogleCastStatic. Se você adicionar GoogleCastStatic ao destino, siga estas etapas:

1. No projeto do Xcode, adicione as flags -ObjC -lc++ a Build Settings > Other Linker Flags.
2. Se o app usa os componentes de interface do Cast, adicione manualmente os pacotes de recursos ao projeto:
   1. Baixe a biblioteca estática em Downloads. Verifique se a versão da biblioteca estática corresponde à versão do pacote que você adicionou.
   2. Localize a pasta Resources no diretório descompactado e arraste todos os arquivos .bundle para o projeto do Xcode. Marque "Copy all items if needed" e adicione a todos os destinos.

Observação: ao atualizar o pacote google-cast-ios-sdk para uma nova versão, substitua os pacotes de recursos no projeto pelos pacotes da biblioteca estática da mesma versão.

Configuração do CocoaPods

Aviso: o suporte ao CocoaPods foi descontinuado. A versão 4.8.6 é a última atualização publicada no CocoaPods. As atualizações seguintes vão estar disponíveis usando o Gerenciador de pacotes do Swift e vão continuar disponíveis para download direto.

Configuração manual

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

Importante: a partir da versão 4.8.4, se você estiver usando outra biblioteca que depende do Protobuf (como o Firebase), o uso da biblioteca estática vai aumentar o tamanho final do app.

Recomendamos que você use a biblioteca estática para evitar possíveis problemas de compatibilidade de versão com o Protobuf. No entanto, se a diferença de tamanho for uma preocupação para sua situação, faça o download da biblioteca dinâmica.

Downloads

Depois de baixar a biblioteca adequada abaixo, siga as etapas de configuração para adicionar o framework ao seu projeto.

Bibliotecas do SDK do Cast para iOS 4.8.6:

Estático Dinâmico

Etapas da configuração

Para instalar a biblioteca:

1. Baixe e extraia o SDK adequado para seu projeto.
2. Configure a biblioteca dinâmica GoogleCastSDK:
3. Arraste o .xcframework descompactado para o projeto principal no navegador de projetos do Xcode. Marque "Copy all items if needed" 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 dinâmica, siga estas etapas além das anteriores:

1. Remova a versão atual de GoogleCastSDK, se houver.
2. Adicione a biblioteca Protobuf v3.13 ou mais recente, seguindo as instruções encontradas no repositório do Protobuf no GitHub.

Se você estiver configurando a biblioteca estática, siga estas etapas além das anteriores:

1. No projeto do Xcode, adicione as flags -ObjC -lc++ a Build Settings > Other Linker Flags.
2. Localize a pasta "Resources" no diretório descompactado e arraste todos os arquivos .bundle para o projeto ao lado do GoogleCast.xcframework que você adicionou anteriormente. Marque "Copy all items if needed" e adicione a todos os destinos.

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 framework ao seu projeto. Em seguida, exclua condicionalmente o SDK do Cast do destino do Mac, conforme mencionado na documentação da Apple (link em inglês). As bibliotecas estáticas são pré-compiladas para a arquitetura do iOS, o que causa um erro de vinculador ao criar para o destino do Mac.