Configuración para el desarrollo con el framework de aplicaciones de Cast (CAF) para iOS

El framework de Cast es compatible con iOS 12 y versiones posteriores, y viene en frameworks estáticos y dinámicos.

Consulta la referencia de la API de Google Cast para iOS para obtener descripciones de todas las clases y los métodos.

Ten en cuenta que los dispositivos de transmisión más recientes admiten el modo de invitado para iOS, pero los dispositivos de generación anterior no lo son. Para obtener más información, consulta Modo de invitado: dispositivos de transmisión compatibles.

Nota: Ya están disponibles las versiones Beta del SDK de Cast para iOS XCFrameworks, que admiten el desarrollo en computadoras Apple M1. Consulta XCFramework (Beta) para obtener más detalles.

Configuración de Xcode

Advertencia: Si configuras la marca Apple Clang - Code Generation Optimization Level como -Ofast para "Optimizaciones agresivas y rápidas", las apps que usan el SDK de Cast para iOS fallarán debido a incompatibilidades con las optimizaciones. El SDK admite el valor predeterminado -Os para “Más rápido y más pequeño”.

iOS 14

Advertencia sobre iOS 14: Los cambios en los permisos de acceso a la red local de iOS 14 afectaron al SDK de Google Cast para iOS de varias maneras. Consulta el documento de cambios de iOS 14 para ver cómo se ve afectada tu app.

1. Cómo agregar el SDK de Cast para iOS 4.7.0 a tu proyecto

   Si usas CocoaPods, usa pod update para agregar el SDK 4.7.0 a tu proyecto.

   De lo contrario, extrae el SDK de forma manual.

   Nota: Si creaste un selector de dispositivos personalizado en tu app, deberás llamar explícitamente al método startDiscovery en la clase GCKDiscoveryManager para iniciar el descubrimiento de dispositivos. El análisis automático se inhabilitó de forma predeterminada a partir de la versión 4.5.0 del SDK de Cast.
2. Agrega NSBonjourServices a tu Info.plist

   Especifica NSBonjourServices en Info.plist para permitir que el descubrimiento de red local se realice correctamente en iOS 14.

   Deberás agregar _googlecast._tcp y _<your-app-id>._googlecast._tcp como servicios para que el descubrimiento de dispositivos funcione correctamente.

   El appID es tu receptorID, que es el mismo ID que se define en tu GCKDiscoveryCriteria.

   Actualiza la siguiente definición de ejemplo de NSBonjourServices y reemplaza “ABCD1234” con tu 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.7.0 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.

The google-cast-sdk and google-cast-sdk-no-bluetooth CocoaPods are available for download.

Use the google-cast-sdk-no-bluetooth if your app does not require guest mode or you do not wish to require Bluetooth® permission.

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, '12.0'

def target_pods
  pod 'google-cast-sdk'
end

target 'CastVideos-objc' do
  target_pods
end
target 'CastVideos-swift' do
  target_pods
end

A continuación, se muestra un ejemplo de cómo agregar el CocoaPod google-cast-sdk-no-bluetooth a tu Podfile:

use_frameworks!

platform :ios, '12.0'

def target_pods
  pod 'google-cast-sdk-no-bluetooth'
end

target 'CastVideos-objc' do
  target_pods
end
target 'CastVideos-swift' do
  target_pods
end

Para tu proyecto, debes especificar un rango para tus pods a fin de evitar cambios rotundos inesperados, como se detalla en la guía del podfile.

En este fragmento, se permite la versión 4.7.0 y las versiones posteriores a la siguiente versión principal (major.minor.patch):

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

Por ejemplo, “~> 1.6.7” incluiría todas las versiones de 1.6.7 y posteriores, pero no así las 2.0.0.

Configuración manual

Las siguientes instrucciones son para agregar el SDK de Cast para iOS a tu proyecto sin usar CocoaPods:

Punto clave: A partir de la versión 4.3.1, CocoaPods usa bibliotecas estáticas para evitar las advertencias de símbolos duplicados causadas por una dependencia de biblioteca compartida de Protobuf cuando se usan los SDK de Firebase y Cast juntos. Si bien este cambio dará lugar a una descarga más grande, el tamaño final de la app no aumentará.

Si la diferencia de tamaño es importante para tu situación, descarga la biblioteca dinámica para obtener un tamaño similar al de las versiones anteriores a la 4.3.1 de la biblioteca de CocoaPods.

Descargas

Después de descargar la biblioteca adecuada a continuación, sigue los pasos de configuración para agregar el marco de trabajo a tu proyecto. Los requisitos de configuración son los mismos para XCFrameworks que los marcos de trabajo heredados heredados.

Se proporcionaron bibliotecas sin modo de invitado para situaciones en las que tu app no requiere la función o si no deseas solicitar permisos de Bluetooth®, que se introdujeron en iOS 13. Consulta el documento de cambios de iOS 13 para obtener más información.

Nota: En este momento, las bibliotecas dinámicas del SDK de iOS no contienen código de bits.

Marco universal

Bibliotecas del SDK de remitentes de Cast para iOS 4.7.0:

Advertencia: Con las versiones más recientes de Xcode, no se podrán compilar las bibliotecas dinámicas debido a que ahora se está aplicando una sola arquitectura por marco de trabajo. Para solucionar este problema, usa el XCFramework correspondiente o, como solución temporal, establece la marca Validate Workspace en YES en la pestaña Configuración de compilación de Xcode.

Estática con el modo de invitado Estática sin modo de invitado

Dinámico con el modo de invitado Dinámico sin modo de invitado

XCFramework (Beta)

A partir de la versión 4.7.1, el SDK de Cast para iOS es compatible con XCFrameworks, lo que permite el desarrollo en computadoras Apple M1 y depuraciones con el simulador de M1 para iOS.

Actualmente, estas bibliotecas están en versión Beta. Notifica cualquier problema que encuentres en la Herramienta de seguimiento de errores del SDK de Cast.

Bibliotecas XCFramework 4.7.1 del SDK de remitentes de iOS para Cast:

XCFramework estático con modo de invitado XCFramework estático sin modo de invitado

XCFramework dinámico con modo de invitado XCFramework dinámico sin modo de invitado

Pasos para la configuración

Para instalar una de las bibliotecas static, haz lo siguiente:

1. Descarga y descomprime el SDK estático apropiado para tu proyecto.
2. Configura la biblioteca de Protobuf con la versión mínima v3.13.
1. Si tu proyecto usa CocoaPods, haz lo siguiente:
1. Abre tu Podfile y quita el google-cast-sdk si está presente:

   pod 'google-cast-sdk'

2. Agrega la biblioteca Protobuf si no está presente:

   pod 'Protobuf', '3.13'

3. Ejecuta pod install en la carpeta raíz de tu proyecto.
2. Si tu proyecto no usa CocoaPods, haz lo siguiente:
1. Quita la versión actual de GoogleCastSDK, si está presente.
2. Agrega la biblioteca de Protobuf v3.13 o una versión posterior según las instrucciones que se encuentran en el repositorio de GitHub de Protobuf.
3. Arrastra el archivo .framework o .xcframework descomprimido al proyecto principal en el navegador del proyecto de Xcode (no al proyecto de pods, si tienes uno). Marque la opción "Copiar todos los elementos si es necesario" y agréguelos a todos los objetivos.
4. En el proyecto de Xcode, agrega las marcas -ObjC -lc++ a Build Settings > Other Linker Flags.
5. Haz clic con el botón derecho en GoogleCast.framework o GoogleCast.xcframework en tu proyecto y selecciona “Show In Finder”.
6. Arrastra los elementos GoogleCastCoreResources.bundle y GoogleCastUIResources.bundle al proyecto junto a los elementos GoogleCast.framework o GoogleCast.xcframework que agregaste anteriormente, marca la opción “Copiar todos los elementos si es necesario” y agrégalos a todos los destinos.

Para instalar una de las bibliotecas dinámicas, haz lo siguiente:

1. Descarga y descomprime el SDK dinámico adecuado para tu proyecto.
2. Configura la biblioteca dinámica de GoogleCastSDK:
1. Si tu proyecto usa CocoaPods, haz lo siguiente:
1. Abre tu Podfile y quita:

   pod 'google-cast-sdk'

2. Ejecuta pod install en la carpeta raíz de tu proyecto.
2. Si tu proyecto no usa CocoaPods, quita la biblioteca actual de Google Cast.
3. Arrastra el archivo .framework o .xcframework descomprimido al proyecto principal en el navegador del proyecto de Xcode (no al proyecto de pods, si tienes uno). Marque la opción "Copiar todos los elementos si es necesario" y agréguelos a todos los objetivos.
4. En tu destino de Xcode, en la pestaña General, selecciona Embed and Sign para GoogleCast.framework o GoogleCast.xcframework.

Configuración de Mac Catalyst

Para las apps compatibles con Mac Catalyst, usa la biblioteca dinámica del SDK de Cast. Sigue el proceso de configuración manual para agregar el marco de trabajo a tu proyecto. Luego, excluye condicionalmente el SDK de Cast del destino de Mac, como se menciona en la documentación de Apple. Las bibliotecas estáticas se compilan previamente para la arquitectura de iOS, lo que genera un error de vinculador cuando se compila con el destino de Mac.

Cómo publicar tu app en App Store

Antes de publicar la app en App Store, debes ejecutar la secuencia de comandos de shell strip_unused_archs.sh para quitar las arquitecturas sin usar del paquete de aplicación. Esta secuencia de comandos está en el SDK de Cast para iOS.