如何用Unity构建含tvOS与iOS双目标的Xcode项目？

一、先做对初始化流程 #

别先建tvOS项目再加iOS目标，反过来——先构建iOS项目，再添加tvOS目标。Unity对iOS的基础配置更完整，以此为基础扩展tvOS目标，冲突会少很多。

• 构建iOS项目时，Unity Player Settings里必须选IL2CPP作为脚本后端（Mono不支持tvOS），Target SDK设为Device SDK。

二、手动添加tvOS后的关键配置修正 #

统一基础构建设置 #

• 两个目标的Base SDK都选最新版本，Deployment Target保持一致（比如iOS 15+、tvOS 15+）。
• 架构都设为ARM64，tvOS不要选ARM64e。
• 两个目标的Enable Bitcode都开为YES（Apple双平台要求）。

修正Unity文件的目标关联 #

• 在Xcode项目导航栏里，逐个检查Libraries、UnityFramework下的文件：
  • iOS专属文件（比如依赖UIKit的类）不要勾选tvOS目标的Target Membership；
  • 通用的Unity核心文件（比如UnityEngine相关）要同时勾选两个目标。
• 单独处理tvOS的Info.plist：添加TVOS_SUPPORTS_SIRI_REMOTE键并设为YES，移除iOS专属权限（比如NSCameraUsageDescription这类tvOS不需要的条目）。

调整编译与链接选项 #

• 两个目标的Other C Flags和Other Linker Flags要拆分平台专属项：iOS保留-framework UIKit，tvOS替换为-framework TVUIKit，通用框架（比如UnityFramework）保持一致。

三、崩溃排查核心方向 #

• 先抓崩溃日志：用Xcode连设备看Console，如果日志显示dyld: Library not loaded，说明某个库没正确关联到tvOS目标，检查Linked Frameworks and Libraries和Embedded Binaries。
• 脚本兼容性检查：Unity代码里的iOS专属API（比如UIApplication）必须加条件编译：

  #if UNITY_IOS && !UNITY_TVOS
      // iOS专属逻辑
  #endif
  

  tvOS专属逻辑用#if UNITY_TVOS包裹，避免跨平台调用不存在的API。
• UnityFramework依赖验证：tvOS目标的UnityFramework在Build Phases里，Embed Frameworks要包含正确的框架，Copy Files阶段的目标必须设为Frameworks。

四、用脚本简化流程（避免手动遗漏） #

写个Unity的PostProcessBuild脚本，自动在iOS构建完成后添加tvOS目标，减少手动操作的错误。核心示例：

using UnityEditor;
using UnityEditor.Callbacks;
using UnityEngine;
using System.IO;
using UnityEditor.iOS.Xcode;

public class DualPlatformBuildProcessor
{
    [PostProcessBuild(999)]
    public static void AddTVOSTarget(BuildTarget target, string buildPath)
    {
        if (target != BuildTarget.iOS) return;

        var projPath = Path.Combine(buildPath, "Unity-iPhone.xcodeproj/project.pbxproj");
        var pbxProj = new PBXProject();
        pbxProj.ReadFromFile(projPath);

        // 创建tvOS应用目标
        string tvTargetId = pbxProj.AddTarget("Unity-tvOS", "tvOS Application", "com.yourcompany.yourapp");
        // 复制iOS目标的基础配置，再调整tvOS专属设置（比如架构、SDK版本）
        // 自动关联通用Unity文件到tvOS目标
        // ...

        pbxProj.WriteToFile(projPath);
    }
}

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