as

Settings
Sign out
Notifications
Alexa
亚马逊应用商店
AWS
文档
Support
Contact Us
My Cases
开发
测试
应用发布
盈利
用户参与
设备规格
资源

为现有React Native项目添加电视支持 (Fire TV)

为现有React Native项目添加电视支持 (Fire TV)

如果您正在启动React Native裸项目,那么确保您的项目针对电视进行配置的最简单方法是使用React Native社区CLI模板(仅提供英文版)。

npx @react-native-community/cli@latest init TVTest --template @react-native-tvos/template-tv

这样将使用react-native-tvos创建项目并为Android和tvOS创建所有所需的配置。否则,必须手动设置配置。react-native-tvos是React Native的一个分支。

提供特定于设备的体验

如果您已有React Native项目,您可以通过配置提供特定于设备的体验,从而增加对于电视的支持。

将现有的React Native项目配置为支持TV

  1. 更新package.json依赖项。

    "react-native": "npm:react-native-tvos@latest"
    

    这使您的项目能够使用react-native-tvos

  2. 将Leanback启动器添加到您的Android清单文件中。

    <intent-filter>
      <category android:name="android.intent.category.LEANBACK_LAUNCHER" />
    </intent-filter>
    

    Android TV应用必须声明启动器活动。如果您的应用没有声明,则无法在Google Play上发现该应用。安装后,它也不会被识别为出现在系统主屏幕上的电视应用(该应用只在以下位置中可见:Settings [设置] > Apps [应用] > All Apps [所有应用])。

  3. 声明不需要android.hardware.touchscreenandroid.hardware.faketouch功能。

    <uses-feature android:name="android.hardware.touchscreen" android:required="false" />
    <uses-feature android:name="android.hardware.faketouch" android:required="false" />
    
  4. 声明您的应用是为Android TV而构建。

    <uses-feature android:name="android.software.leanback" android:required="false" />
    
  5. 更新iOS项目文件project.pbxproj,根据此代码差异片段定义对tvOS的支持。

  6. 更新Podfile。

    - platform :ios, min_ios_version_supported
    + platform :tvos, min_ios_version_supported
    

    这样可以确保您的项目针对tvOS进行配置。


Last updated: 2025年7月22日