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

El framework de Cast admite iOS 14 y versiones posteriores, y está disponible en los 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 todos los métodos.

Nota: Ya están disponibles las versiones nuevas de XCFrameworks del SDK de Cast para iOS, que admiten el desarrollo en computadoras Apple Silicon.

Configuración de Xcode

Advertencia: Configura la marca Apple Clang - Code Generation Optimization Level a -Ofast para las “Optimizaciones más rápidas y agresivas” hará que las apps que usen la Transmite el SDK de iOS para que falle debido a incompatibilidades con las optimizaciones. El SDK admite el valor predeterminado -Os para “Más rápido, menor”.

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 la Cambios en iOS 14 para ver cómo se ve afectada tu app.

1. Agrega el SDK de Cast para iOS 4.8.3 a tu proyecto

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

   De lo contrario, extraer el SDK de forma manual.

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

   Especifica NSBonjourServices en tu Info.plist para permitirá que el descubrimiento de redes locales sea exitoso en iOS 14.

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

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

   Actualiza la siguiente definición de ejemplo de NSBonjourServices y Reemplaza “ABCD1234” con el ID de tu app.

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

3. Agrega NSLocalNetworkUsageDescription a tu Info.plist

   Te recomendamos que personalices el mensaje que se muestra en la pestaña Local Mensaje de red agregando una cadena de permiso específica de la app al Info.plist para el NSLocalNetworkUsageDescription, como para describir la transmisión y otros servicios de descubrimiento, como DIAL.

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

   Este mensaje aparecerá como parte del diálogo de Acceso a la red local de iOS como que se muestra en la simulación.

   
4. Vuelve a lanzar la app en la App Store de Apple

   También te recomendamos que vuelvas a lanzar la app con la versión 4.8.3, como lo antes posible.

iOS 13

Advertencia de iOS 13: Apple los cambios en los permisos de iOS 13 y Xcode 11 afectaron SDK de varias maneras. Consulta la Cambios en iOS 13 para saber cómo se verá afectada tu app.

iOS 12

Advertencia de iOS 12: Si está en desarrollo con Xcode 10, el permiso de "Acceder a información de Wi-Fi" se requiere para para descubrir dispositivos de transmisión y conectarse a ellos.

Asegúrate de que el interruptor Access WiFi Information en Capabilities del destino esté activada en “Activada”.

Además, tu perfil de aprovisionamiento deberá ser compatible con el servicio Access Wi-Fi Information. Esto se puede agregar Portal para desarrolladores de Apple.

Configuración de CocoaPods

La forma recomendada de integrar Google Cast es usar CocoaPods. Para la integración, usa el google-cast-sdk CocoaPods.

Para comenzar, sigue la guía de introducción.

Cuando CocoaPods esté configurado, sigue el guía de uso de CocoaPods a fin de que se cree tu Podfile y que tu proyecto esté listo para usarse con Google Cast de Google Cloud.

Este es un ejemplo de cómo agregar CocoaPod google-cast-sdk a tu 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

En tu proyecto, debes especificar un rango para tus Pods para evitar eventos cambios rotundos, como se detalla en el guía de podfile.

En este fragmento, la versión 4.8.3 y las versiones posteriores versiones principales (major.minor.patch):

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

Por ejemplo, “~> 1.6.7' incluiría todas las versiones a partir de la 1.6.7, pero no incluida la versión 2.0.0.

Configuración manual

Las siguientes instrucciones te indican cómo 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 advertencias de símbolos duplicados causados por un Dependencia compartida de la biblioteca Protobuf cuando se usan los SDK de Firebase y Cast entre sí. Si bien este cambio dará lugar a una descarga más grande, la app final el tamaño no aumentará.

Si te preocupa la diferencia de tamaño, descarga la para obtener un tamaño similar a las versiones anteriores a la 4.3.1 de CocoaPods biblioteca.

Descargas

Después de descargar la biblioteca adecuada, sigue las pasos de configuración para agregar el framework a tu en un proyecto final.

Transmite las bibliotecas del SDK de Sender de iOS 4.8.3:

Estática Dinámica

Pasos para la configuración

Para instalar la biblioteca, haz lo siguiente:

1. Descarga y extrae el SDK adecuado para tu proyecto.
2. Configura la biblioteca dinámica de GoogleCastSDK:
3. Arrastra el .xcframework descomprimido a tu proyecto principal en Navegador de proyectos de Xcode (no en el proyecto de Pods, si tienes uno) Marca la opción "Copiar todos los elementos si es necesario" y agrégalos a todas las orientaciones.
4. En la pestaña General de la orientación de Xcode, selecciona Embed and Sign para GoogleCast.xcframework.

Si configuras la biblioteca estática, sigue estos pasos además de los pasos anteriores:

1. Cómo configurar la biblioteca de Protobuf con la versión mínima v3.13.
1. Si en tu proyecto se usa CocoaPods, haz lo siguiente:
1. Abre tu Podfile y quita el elemento 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 superior. siguiendo las instrucciones que se encuentran en la GitHub de protobuf repo.
2. En el proyecto de Xcode, agrega las marcas -ObjC -lc++ al Configuración de compilación > Otras marcas del vinculador.
3. Ubica la carpeta Recursos en el directorio descomprimido y arrastrar GoogleCastCoreResources.bundle, GoogleCastUIResources.bundle y MaterialDialogs.bundle en tu proyecto junto a la GoogleCast.xcframework agregados anteriormente. Marca "Copiar todos los elementos si es necesario" y agrégalos a todos los destinos.

Configuración de Mac Catalyst

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