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 é fornecido em frameworks estáticos e dinâmicos.

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

Configuração do Xcode

iOS 14

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

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

    Caso contrário, extraia o SDK manualmente.

  2. Adicionar NSBonjourServices ao Info.plist

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

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

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

    Atualize o exemplo de definição de NSBonjourServices a seguir 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.

    Cast Local Network Access permissions dialog image
  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 12

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 projeto, especifique um intervalo para os pods a fim de evitar alterações interruptivas inesperadas, conforme detalhado no guia de pods.

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

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

Por exemplo, "~> 1.6.7" incluiria todas as versões de 1.6.7 até a versão 2.0.0, mas não inclusive.

Configuração manual

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

Downloads

Depois de fazer o download da biblioteca apropriada abaixo, siga as etapas de configuração para adicionar o framework ao seu projeto.

Bibliotecas 4.8.1 do SDK do remetente do iOS do Cast:

Estática Dinâmica

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 GoogleCastSDK dinâmica:
  3. Arraste o .xcframework descompactado para o projeto principal no navegador de projetos do Xcode (não para o projeto de pods, se houver um). Marque "Copiar todos os itens, se necessário" e adicione a todos os destinos.
  4. No seu destino do Xcode, na guia General, selecione Embed and Sign para GoogleCast.xcframework.

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

  1. Configure a biblioteca Protobuf com a versão mínima v3.13.
    1. Se o projeto usa o CocoaPods:
      1. Abra o Podfile e remova o google-cast-sdk, se houver: 
        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 projeto.
    2. Se o projeto não estiver usando CocoaPods:
      1. Remove a versão atual do GoogleCastSDK, se houver.
      2. Adicione a biblioteca Protobuf v3.13 ou posterior seguindo as instruções encontradas no repositório do Protobuf no GitHub (em inglês).
  2. No projeto do Xcode, adicione as sinalizações -ObjC -lc++ a Build Settings > Other Linker Flags.
  3. Localize a pasta "Recursos" no diretório descompactado e arraste GoogleCastCoreResources.bundle, GoogleCastUIResources.bundle e MaterialDialogs.bundle para o projeto, ao lado do GoogleCast.xcframework que você adicionou anteriormente. Marque "Copiar todos os itens, se necessário" 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 a estrutura ao projeto. Em seguida, exclua condicionalmente o SDK do Cast do destino Mac, conforme mencionado na documentação da Apple. Bibliotecas estáticas são pré-compiladas para a arquitetura do iOS, o que causa um erro do vinculador ao criar no destino Mac.

Próxima
Privacidade