如何解决tvOS目标嵌入watchOS内容不被允许的编译错误？

问题原因 #

当你给iOS目标添加watchOS App目标后，Xcode默认会把watchOS App嵌入到iOS目标中，但你的tvOS目标和iOS目标出现了错误关联——tvOS目标被错误设置为也嵌入这个watchOS App，而tvOS平台明确禁止嵌入非tvOS平台的内容，因此触发编译报错。

解决方法 #

1. 打开项目设置，选中你的tvOS目标
2. 切换到「General」标签页，找到「Frameworks, Libraries, and Embedded Content」区域
3. 找到名为My-iOS-Target Watch App.app的条目，点击左侧减号（-）删除它
4. 确认iOS目标的相同区域里，watchOS App的嵌入设置是正确的（仅iOS目标需要嵌入，macOS和tvOS目标都不能有）
5. 执行清理操作（快捷键Cmd+Shift+K），然后重新编译所有目标

多平台开发最佳实践 #

• 目标严格隔离：每个平台目标的依赖、嵌入内容完全独立，绝对不要给tvOS/watchOS目标嵌入其他平台的App或框架——tvOS不允许嵌入非tvOS内容，watchOS也仅允许和配对的iOS目标关联
• 共享代码用框架封装：把列表、详情视图这类通用UI逻辑，以及业务模型代码放到单独的共享框架中，四个平台目标统一引用这个框架，避免跨目标直接复用代码导致的依赖混乱
• 平台专属逻辑用条件编译：针对不同平台的特性做适配，比如watchOS的紧凑布局、tvOS的遥控器导航支持，用#if os(iOS)、#if os(watchOS)、#if os(tvOS)这类条件编译语句区分实现
• 单独管理watchOS目标：watchOS App仅和对应的iOS目标绑定，不要让macOS/tvOS目标和watchOS目标产生任何依赖或嵌入关联
• 定期检查编译配置：添加新平台目标后，逐一核对每个目标的「Frameworks, Libraries, and Embedded Content」设置，确保没有错误引入跨平台内容

内容的提问来源于stack exchange，提问作者JamesDerrick248