Setup for Developing with the Cast Application Framework (CAF) for iOS

The Cast framework supports iOS version 8 and later, and is a dynamic framework.

Note that newer generation Cast devices support guest mode for iOS but older generation devices do not. For details, see Guest Mode - Supported Cast Devices.

Download library

Download the Google Cast iOS Sender SDK. See the Google Cast iOS API Reference for descriptions of all classes and methods.

Xcode setup

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.

In your Xcode project, set the Other Linker Flags in Build Settings to: -ObjC -lc++.

In your Xcode project, add the following framework libraries (linked, not embedded):

  • Accelerate.framework
  • AudioToolbox.framework
  • AVFoundation.framework
  • CFNetwork.framework
  • CoreBluetooth.framework
  • CoreData.framework
  • CoreGraphics.framework
  • CoreMedia.framework
  • CoreText.framework
  • Foundation.framework
  • GoogleCast.framework
  • MediaAccessibility.framework
  • MediaPlayer.framework
  • QuartzCore.framework
  • Security.framework
  • SystemConfiguration.framework
  • UIKit.framework

The libraries appear in your project as follows:

Next, add the dynamic GoogleCast.framework to the Embedded Binaries section of the General tab in the target's settings. Do not remove GoogleCast.framework from the Linked Frameworks and Libraries section; it must still be in there as well.

Ensure that the Runpath Search Paths setting of the Build Settings in the project's settings is set to "@executable_path/Frameworks".

Ensure that the settings in the Embed Frameworks section of Build Phases lists the GoogleCast.framework.

You are now done setting up Xcode.

Publishing your app to App Store

Before publishing your app to the App Store, you need to run shell script to strip unused architectures from the app bundle. This script is in the Cast SDK for iOS.