Console

Settings

Sign out

Notifications

Alexa

亚马逊应用商店

AWS

文档

Support

My Cases

Console

Fire OS文档

主页

开发

测试

应用发布

盈利

用户参与

设备规格

资源

开始使用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日