使用 Cast 应用框架 (CAF) 开发 iOS 版应用的设置

Cast 框架支持 iOS 14 及更高版本，并且提供静态和动态框架。

如需了解所有类和方法的说明，请参阅 Google Cast iOS API 参考文档。

注意：现在，我们推出了新版 Cast iOS SDK XCFrameworks，它们支持在 Apple Silicon 计算机上进行开发。

Xcode 设置

警告： 如果将 Apple Clang - Code Generation Optimization Level 标志设置为 -Ofast（以实现“最快、最激进的优化”），则会导致使用 Cast iOS SDK 的应用因与优化不兼容而崩溃。SDK 支持“最快、最小”的默认值 -Os。

iOS 14

iOS 14 警告：对 iOS 14 本地网络访问权限所做的更改已在多方面影响了 Google Cast iOS SDK。请参阅 iOS 14 变更文档，了解您的应用受到了哪些影响。

1. 将 Cast iOS SDK 4.8.3 添加到您的项目

   如果使用 CocoaPods，请使用 pod update 将 4.8.3 SDK 添加到您的项目中。

   否则，请 手动拉取 SDK。

   注意：如果您在应用中构建了自定义设备选择器，则需要对 GCKDiscoveryManager 类显式调用 startDiscovery 方法以启动设备发现。从 Cast SDK v4.5.0 版开始，默认情况下自动扫描功能处于停用状态。
2. 将 NSBonjourServices 添加到 Info.plist

   在 Info.plist 中指定 NSBonjourServices，以允许在 iOS 14 上成功进行本地网络发现。

   您需要将 _googlecast._tcp 和 _<your-app-id>._googlecast._tcp 都添加为服务，以便设备发现功能正常运行。

   appID 是您的 receiverID，与 GCKDiscoveryCriteria 中定义的 ID 相同。

   更新以下示例 NSBonjourServices 定义，并将“ABCD1234”替换为您的应用 ID。

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

3. 将 NSLocalNetworkUsageDescription 添加到 Info.plist

   我们强烈建议您在应用的 Info.plist 文件中为 NSLocalNetworkUsageDescription 添加应用专用权限字符串，以自定义“本地网络”提示中显示的消息，例如描述 Cast 发现功能和其他发现服务（例如 DIAL）。

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

   此消息将显示在 iOS 本地网络访问权限对话框中，如模拟内容所示。

   
4. 将应用重新发布到 Apple App Store

   我们还建议您尽快使用 4.8.3 重新发布应用。

iOS 13

iOS 13 警告：Apple 对 iOS 13 和 Xcode 11 的权限变更在多方面影响了 Google Cast iOS SDK。请参阅 iOS 13 变更文档，了解您的应用将受到哪些影响。

iOS 12

iOS 12 警告：如果使用 Xcode 10 进行开发，则必须具有“访问 Wi-Fi 信息”功能，才能发现和连接到 Cast 设备。

确保目标的功能部分中的访问 Wi-Fi 信息开关已设为“开启”。

此外，您的配置文件还需要支持访问 Wi-Fi 信息功能。您可以在 Apple Developer 门户中添加此信息。

CocoaPods 设置

集成 Google Cast 的推荐方法是使用 CocoaPods。如需进行集成，请使用 google-cast-sdk CocoaPods。

如需开始使用，请按照入门指南操作。

设置 CocoaPods 后，请按照 CocoaPods 使用指南创建 Podfile，并使项目能够与 Google Cast SDK 搭配使用。

以下示例展示了如何将 google-cast-sdk CocoaPod 添加到 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

对于您的项目，您应为 pod 指定一个范围，以防止意外的破坏性更改，如 podfile 指南中所详述。

在此代码段中，允许使用版本 4.8.3 及不高于下一个主要版本 (major.minor.patch) 的版本：

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

例如，“>= 1.6.7”将涵盖 1.6.7 及更高版本（但不包括 2.0.0 版本）。

手动设置

以下说明介绍了如何在不使用 CocoaPods 的情况下将 Cast iOS SDK 添加到您的项目中：

要点：从版本 4.3.1 开始，CocoaPods 使用静态库，以避免在将 Firebase 和 Cast SDK 搭配使用时因共享 Protobuf 库依赖项而导致重复符号警告。虽然这项更改会增加下载大小，但最终应用大小不会增加。

如果大小差异对您而言很重要，请下载动态库，以使其大小与 4.3.1 之前版本的 CocoaPods 库大致相当。

下载内容

下载下面的相应库后，请按照设置步骤将框架添加到您的项目中。

Cast iOS Sender SDK 4.8.3 库：

静态 动态

设置步骤

如需安装该库，请执行以下操作：

1. 下载并解压缩适用于您的项目的 SDK。
2. 设置动态 GoogleCastSDK 库：
3. 将解压缩的 .xcframework 拖动到 Xcode 项目导航器中的主项目中（不要拖动到 Pods 项目，如果有）。 选中“Copy all items if needed”（根据需要复制所有内容），然后将其添加到所有目标。
4. 在 Xcode 目标的 General 标签页下，为 GoogleCast.xcframework 选择 Embed and Sign。

如果您要设置静态库，除了上述步骤之外，还需要执行以下步骤：

1. 设置最低版本为 v3.13 的 Protobuf 库。
1. 如果您的项目使用 CocoaPods：
1. 打开 Podfile 并移除 google-cast-sdk（如果存在）：

   pod 'google-cast-sdk'

2. 添加 Protobuf 库（如果不存在）：

   pod 'Protobuf', '3.13'

3. 在项目的根文件夹中运行 pod install。
2. 如果您的项目不使用 CocoaPods：
1. 移除当前版本的 GoogleCastSDK（如果存在）。
2. 按照 Protobuf GitHub 代码库中的说明添加 Protobuf 库 v3.13 或更高版本。
2. 在 Xcode 项目中，依次前往 Build Settings > Other Linker Flags，然后将标志 -ObjC -lc++ 添加到该位置。
3. 在解压缩的目录中找到“Resources”文件夹，然后将 GoogleCastCoreResources.bundle、GoogleCastUIResources.bundle 和 MaterialDialogs.bundle 拖动到项目中您之前添加的 GoogleCast.xcframework 旁边。选中“Copy all items if needed”（根据需要复制所有项），然后将其添加到所有目标。

Mac Catalyst 设置

对于支持 Mac Catalyst 的应用，请使用 Cast SDK 的动态库。 按照手动设置流程将框架添加到您的项目。然后，按照 Apple 文档中所述，从 Mac 目标中有条件地排除 Cast SDK。静态库针对 iOS 架构进行了预编译，这会导致针对 Mac 目标进行构建时出现链接器错误。