开发者控制台

开始使用React Native (Fire TV)

亚马逊Fire TV支持React Native，这是一个利用React网页开发框架的开源移动应用开发框架。React Native最初在2020年加入了对电视的部分支持。从那时起，React Native维护人员开始将模块拆分成单独的存储库，以便更好地维护。因此，维护人员将电视支持转移到了一个名为React Native tvOS的专用项目中。

react-native-tvos项目是React Native主存储库的开源分支，专门为使现有的React Native应用在电视上运行而量身定制。该项目提供对电视的支持，例如焦点管理和访问React Native应用的可触摸控件。

对于新的React Native应用，您可以使用Expo，这是一套受欢迎的开源开发者工具和服务，用于构建和部署React Native应用。有关如何使用Expo的更多详细信息，请参阅为电视构建Expo应用（仅提供英文版）。

要详细了解您在构建React Native应用时可用的功能、设计和策略，请参阅开始使用React Native构建电视应用（仅提供英文版）。

先决条件
- 配置Android Studio
构建您的Fire TV应用
- 在Android TV模拟器上运行您的项目
- 在Fire TV设备上运行您的项目
相关主题

先决条件

开始使用React Native需要以下项目：

Node.js：使用Node.js作为JavaScript运行时环境。
npm或Yarn：为JavaScript安装这些程序包管理器。
Android Studio：使用Android Studio作为IDE，以在本地编译和运行Fire OS应用。

配置Android Studio

您必须配置Android Studio及其命令行工具。

配置Android Studio

设置您的ANDROID_HOME环境变量。有关操作系统的具体说明，请参阅如何设置环境变量。
从Virtual Device Manager安装Android TV模拟器。

构建您的Fire TV应用

要使用React Native为Fire TV构建应用，您必须创建安装了expo程序包的新项目。

创建新项目

在命令提示符下，创建安装了expo程序包的新React Native项目。
```
npx create-expo-app FireTVDemo -e with-tv
```

在Android TV模拟器上运行您的项目

您可以在Android TV模拟器上启动和运行您的项目。

在TV模拟器上运行项目

在命令提示符处，列出可用的Android虚拟设备 (AVD)。
```
emulator -list-avds
```
启动Android TV模拟器。
```
emulator -avd <TV模拟器的名称>
```
导航到项目目录。
```
cd FireTVDemo
```
使用npx运行应用。
```
npx expo start -a
```

您的应用使用本地开发服务器和Expo Go在avd模拟器上运行。您不必创建Android构建版本。

在Fire TV设备上运行您的项目

要在Fire TV设备上运行项目，必须首先让构建版本以电视为目标。

在Fire TV设备上运行项目

在您的app.json中，将isTV属性设置为true。

{
  "expo": {
    "plugins": [
      [
        "@react-native-tvos/config-tv",
        {
          "isTV": true,
        }
      ]
    ],
    "name": "FireTVDemo",
    "slug": "FireTVDemo"
  }
}

连接Fire TV。有关说明，请参阅通过ADB连接到Fire TV (Fire TV)。
使用adb检查您的设备是否已连接。
```
adb devices -l
```
将返回已连接设备的列表。
导航到项目目录。
```
cd FireTVDemo
```
在目标设备上运行开发构建版本（例如，-d AFTSS）。
```
cd FireTVDemo
npx expo run:android -d <设备名称>
```

您已将开发构建版本安装在设备上的android目录中。您可以通过在Android清单文件中检查您的应用是否正在使用的Android Leanback功能来验证您的Android构建版本是否针对电视进行了优化。

Last updated: 2025年7月22日