构建用于电视的 Expo 应用

为 TV 修改依赖项

在 package.json 中，修改 react-native 依赖项以使用 TV 仓库。

{
  %%placeholder-start%%... %%placeholder-end%%
  "dependencies": {
    %%placeholder-start%%... %%placeholder-end%%
    "react-native": "npm:react-native-tvos@0.85-stable"
    %%placeholder-start%%... %%placeholder-end%%
  }
}

{
  %%placeholder-start%%... %%placeholder-end%%
  "dependencies": {
    %%placeholder-start%%... %%placeholder-end%%
    "react-native": "npm:react-native-tvos@0.83-stable"
    %%placeholder-start%%... %%placeholder-end%%
  },
  "expo": {
    "install": {
      "exclude": ["react-native"]
    }
  }
}

警告 如果你在 monorepo 中有多个 Expo 项目，并且其中一个项目已修改为支持 TV，那么所有项目都应按此处所述修改为使用 React Native TV 包，即使其中某些项目并未配置为目标 TV。这样可以避免项目依赖之间可能产生的冲突，同时仍然为所有项目完全支持移动端开发。

添加 TV 配置插件

安装后，当满足以下任一条件时，插件会将项目修改为 TV 版本：

• 环境变量 EXPO_TV 被设置为 1
• 插件参数 isTV 被设置为 true

请确认该插件出现在 app.json 中：

{
  "plugins": ["@react-native-tvos/config-tv"]
}

若要在 prebuild 期间查看插件操作的更多信息，可以在运行 prebuild 之前设置 debug 环境变量。（另请参阅我们关于 Expo CLI 环境变量 的文档。）

运行 prebuild

设置 EXPO_TV 环境变量，并运行 prebuild 以对项目进行 TV 修改。

注意：建议使用 --clean 参数，如果项目中已存在 Android 和 iOS 目录，则这是必需的。

为 Android TV 构建

启动 Android TV 模拟器，并使用以下命令在模拟器上启动应用：

为 Apple TV 构建

运行以下命令，在 Apple TV 模拟器上构建并运行应用：

撤销 TV 更改并为手机构建

你可以通过取消设置 EXPO_TV 并再次运行 prebuild，撤销 TV 的更改并回到手机开发：

为 TV 和手机创建 EAS Build 配置

由于 TV 构建可以由环境变量的值来驱动，因此很容易设置 EAS Build 配置，使其从相同源码构建，但目标是 TV 而不是手机。

下面的 eas.json 示例展示了如何扩展现有配置（development 和 preview）以创建 TV 配置（development_tv 和 preview_tv）。

{
  "cli": {
    "version": ">= 5.2.0"
  },
  "build": {
    "base": {
      "distribution": "internal",
      "ios": {
        "simulator": true
      },
      "android": {
        "buildType": "apk",
        "withoutCredentials": true
      },
      "channel": "base"
    },
    "development": {
      "extends": "base",
      "android": {
        "gradleCommand": ":app:assembleDebug"
      },
      "ios": {
        "buildConfiguration": "Debug"
      },
      "channel": "development"
    },
    "development_tv": {
      "extends": "development",
      "env": {
        "EXPO_TV": "1"
      },
      "channel": "development"
    },
    "preview": {
      "extends": "base",
      "channel": "preview"
    },
    "preview_tv": {
      "extends": "preview",
      "env": {
        "EXPO_TV": "1"
      },
      "channel": "preview"
    }
  },
  "submit": {}
}

tvOS App Store 构建的凭据

tvOS 使用与 iOS 和其他 Apple 平台相同的 bundle ID 和分发证书。不过，tvOS 不使用与 iOS 相同的 provisioning profile。

由于 Web 端和 EAS CLI 中的 EAS 工具链只会创建 iOS provisioning profile，因此 tvOS 项目需要额外步骤。你有两种方式可以继续：

1. 如果项目仅面向 tvOS，你可以将凭据存储在 EAS 中。像 iOS 项目一样，在项目网站上创建 bundle ID，并上传分发证书。然后，你应前往 Apple 的开发者网站，使用 EAS 创建的 bundle ID 创建一个 tvOS provisioning profile。接着将该 profile 下载到你的电脑，并上传到项目的 EAS 项目网站。请参阅 应用凭据指南。

2. 如果项目同时面向 tvOS 和 iOS，你应为 tvOS 使用 本地凭据，因为 iOS 构建会需要 EAS 中存储的凭据。