Configuration pour le développement avec le framework d'application Cast (CAF) pour iOS

Le framework Cast est compatible avec iOS 15 et versions ultérieures. Il est disponible en frameworks statiques et dynamiques.

Consultez la documentation de référence de l'API Google Cast pour iOS pour obtenir la description de toutes les classes et méthodes.

Configuration de Xcode

iOS 14

1. Ajoutez le SDK Cast pour iOS 4.8.4 à votre projet

   Si vous utilisez CocoaPods, exécutez pod update pour ajouter le SDK 4.8.4 à votre projet.

   Sinon, intégrez le SDK manuellement.

2. Ajoutez NSBonjourServices à votre Info.plist

   Spécifiez NSBonjourServices dans votre Info.plist pour que la détection du réseau local fonctionne sur iOS 14.

   Vous devrez ajouter _googlecast._tcp et _<your-app-id>._googlecast._tcp en tant que services pour que la détection des appareils fonctionne correctement.

   L'appID correspond à votre receiverID, qui est le même ID que celui défini dans votre GCKDiscoveryCriteria.

   Mettez à jour l'exemple de définition NSBonjourServices suivant et remplacez "ABCD1234" par votre appID.

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

3. Ajoutez NSLocalNetworkUsageDescription à votre Info.plist

   Nous vous recommandons vivement de personnaliser le message affiché dans l'invite Réseau local en ajoutant une chaîne d'autorisation spécifique à l'application dans le fichier Info.plist de votre application pour le NSLocalNetworkUsageDescription. Vous pouvez ainsi décrire la détection Cast et d'autres services de détection, comme DIAL.

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

   Ce message s'affichera dans la boîte de dialogue Accès au réseau local d'iOS, comme illustré dans la maquette.

   
4. Publiez à nouveau votre application sur l'App Store d'Apple

   Nous vous recommandons également de publier à nouveau votre application à l'aide de la version 4.8.4 dès que possible.

iOS 13

iOS 12

Assurez-vous que le commutateur Access WiFi Information (Accéder aux informations Wi-Fi) de la section Capabilities (Fonctionnalités) de la cible est défini sur "On" (Activé).

De plus, votre profil de provisionnement devra être compatible avec la fonctionnalité Access WiFi Information (Accéder aux informations Wi-Fi). Vous pouvez l'ajouter dans le portail des développeurs Apple.

Configuration de CocoaPods

La méthode recommandée pour intégrer Google Cast consiste à utiliser CocoaPods. Pour l'intégration, utilisez le google-cast-sdk CocoaPods.

Pour commencer, suivez le guide de démarrage.

Une fois CocoaPods configuré, suivez le guide d'utilisation de CocoaPods pour créer votre Podfile et préparer votre projet à être utilisé avec le SDK Google Cast.

Voici un exemple d'ajout du CocoaPod google-cast-sdk à votre Podfile :

use_frameworks!

platform :ios, '15.0'

def target_pods
  pod 'google-cast-sdk'
end

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

Pour votre projet, vous devez spécifier une plage pour vos pods afin d'éviter les modifications destructives inattendues , comme indiqué dans le guide Podfile.

Dans cet extrait, la version 4.8.4 et les versions jusqu'à la version majeure suivante (majeure.mineure.correctif) sont autorisées :

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

Par exemple, "~> 1.6.7" inclurait toutes les versions à partir de 1.6.7 jusqu'à la version 2.0.0, mais pas cette dernière.

Configuration manuelle

Les instructions suivantes permettent d'ajouter le SDK Cast pour iOS à votre projet sans utiliser CocoaPods :

Téléchargements

Après avoir téléchargé la bibliothèque appropriée ci-dessous, suivez la procédure de configuration pour ajouter le framework à votre projet.

Bibliothèques du SDK de l'expéditeur Cast pour iOS 4.8.4 :

Statique Dynamique

Procédure de configuration

Pour installer la bibliothèque :

1. Téléchargez et extrayez le SDK approprié pour votre projet.
2. Configurez la bibliothèque dynamique GoogleCastSDK :
3. Faites glisser le fichier décompressé .xcframework dans votre projet principal dans le navigateur de projet Xcode (pas dans le projet Pods si vous en avez un). Cochez "Copy all items if needed" (Copier tous les éléments si nécessaire), puis ajoutez-les à toutes les cibles.
4. Dans votre cible Xcode, sous l'onglet General, sélectionnez Embed and Sign pour GoogleCast.xcframework.

Si vous configurez la bibliothèque dynamique, procédez comme suit en plus des étapes précédentes :

1. Configurez la bibliothèque Protobuf avec la version minimale v3.13.
1. Si votre projet utilise CocoaPods :
1. Ouvrez votre Podfile et supprimez google-cast-sdk s'il est présent :

   pod 'google-cast-sdk'

2. Ajoutez la bibliothèque Protobuf si elle n'est pas présente :

   pod 'Protobuf', '3.13'

3. Exécutez pod install dans le dossier racine de votre projet.
2. Si votre projet n'utilise pas CocoaPods :
1. Supprimez la version actuelle de GoogleCastSDK si elle est présente.
2. Ajoutez la bibliothèque Protobuf version 3.13 ou ultérieure, en suivant les instructions du dépôt GitHub Protobuf.

Si vous configurez la bibliothèque statique, procédez comme suit en plus des étapes précédentes :

1. Dans votre projet Xcode, ajoutez les options -ObjC -lc++ à Build Settings > Other Linker Flags (Paramètres de compilation > Autres options de l'éditeur de liens).
2. Recherchez le dossier Resources dans le répertoire décompressé, puis faites glisser tous les fichiers .bundle dans votre projet à côté du GoogleCast.xcframework que vous avez ajouté précédemment. Cochez "Copy all items if needed" (Copier tous les éléments si nécessaire), puis ajoutez-les à toutes les cibles.

Configuration de Mac Catalyst

Pour les applications compatibles avec Mac Catalyst, utilisez la bibliothèque dynamique du SDK Cast. Suivez la procédure de configuration manuelle pour ajouter le framework à votre projet. Excluez ensuite le SDK Cast de la cible Mac de manière conditionnelle, comme indiqué dans la documentation Apple. Les bibliothèques statiques sont précompilées pour l'architecture iOS, ce qui provoque une erreur de l'éditeur de liens lors de la compilation par rapport à la cible Mac.