构建电视 Expo 应用

修改电视的依赖

🌐 Modify dependencies for TV

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

🌐 In package.json, modify the react-native dependency to use the TV repo.

{
  %%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。这可以避免项目依赖之间可能发生的冲突，同时仍然完全支持所有项目的移动开发。

添加电视配置插件

🌐 Add the TV config plugin

安装后，该插件将在以下任一情况下修改电视项目：

🌐 When installed, the plugin will modify the project for TV when either:

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

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

🌐 Verify that this plugin appears in app.json:

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

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

🌐 To see additional information on the plugin's actions during prebuild, you can set debug environment variables before running prebuild. (See also our documentation on Expo CLI environment variables.)

运行预构建

🌐 Run prebuild

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

🌐 Set the EXPO_TV environment variable, and run prebuild to make the TV modifications to the project.

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

为 Android TV 构建

🌐 Build for Android TV

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

🌐 Start an Android TV emulator and use the following command to start the app on the emulator:

为 Apple TV 构建

🌐 Build for Apple TV

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

🌐 Run the following command to build and run the app on an Apple TV simulator:

还原电视更改并为手机构建

🌐 Revert TV changes and build for phone

你可以通过取消设置 EXPO_TV 并再次运行预构建，将 TV 的更改恢复回手机开发：

🌐 You can revert the changes for TV and go back to phone development by unsetting EXPO_TV and running prebuild again:

为电视和手机创建 EAS 构建配置文件

🌐 Create EAS Build profiles for both TV and phone

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

🌐 Since the TV build can be driven by the value of an environment variable, it is easy to set up EAS Build profiles that build from the same source but target TV instead of phone.

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

🌐 The following example eas.json shows how to extend existing profiles (development and preview) to create TV profiles (development_tv and 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 应用商店构建的凭证

🌐 Credentials for tvOS App Store builds

tvOS 使用与 iOS 及其他 Apple 平台相同的应用包 ID 和分发证书。但是，tvOS 不使用与 iOS 相同的配置描述文件。

🌐 tvOS uses the same bundle IDs and distribution certificates as iOS and other Apple platforms. However, tvOS does not use the same provisioning profiles as iOS.

由于网络上的 EAS 工具和 EAS CLI 只创建 iOS 配置文件，因此 tvOS 项目需要一些额外的步骤。你有两种方式可以继续进行：

🌐 Since the EAS tooling on the web and in EAS CLI only creates iOS provisioning profiles, some extra steps are required for tvOS projects. There are two ways for you to proceed:

1. 如果一个项目只针对 tvOS，你可以将凭证存储在 EAS 中。创建打包 ID，并在项目的网站上上传分发证书，就像你为 iOS 项目所做的那样。然后，你应该访问苹果开发者网站，并使用 EAS 创建的打包 ID 在那里创建一个 tvOS 配置描述文件。然后将该配置文件下载到你的电脑，并上传到项目的 你的 EAS 项目网站。参见 应用凭证指南。
2. 如果一个项目同时面向 tvOS 和 iOS，你应该为 tvOS 使用本地凭据，因为 EAS 存储的凭据将被你的 iOS 构建使用。