react-native-gesture-handler

开放Beta测试文档 作为预发布开放Beta测试的一项内容，亚马逊提供了此技术文档。随着亚马逊收到反馈并对功能进行迭代，所描述的这些功能可能会发生变化。有关最新功能的信息，请参阅发布说明。

@amazon-devices/react-native-gesture-handler是一个声明式API，向React Native公开平台原生触摸和手势系统。

React Native Gesture Handler提供原生驱动的手势管理API，用于在React Native中构建最佳的触摸型体验。

使用此库后，手势不再由JavaScript响应器系统控制，而是在用户界面线程中对其进行识别和跟踪。

它使触摸交互和手势跟踪不仅流畅，而且可靠、确定性强。

这是一个系统部署的库，可供适用于Vega的React Native应用使用，无需单独的安装过程。它作为自动链接库进行部署，您的应用在运行时会链接到该库。只能在库和为其构建的适用于Vega的React Native版本之间保证兼容性。

当您升级用于构建应用的适用于Vega的React Native版本时，最佳实践是同时升级它所依赖的库的版本。

有关此库及其API的更多信息，请参阅Software Mansion官方文档中的https://docs.swmansion.com/react-native-gesture-handler/docs/（仅提供英文版）。

安装

在package.json文件中添加JavaScript库依赖项。

已复制到剪贴板。

"dependencies": {
      ...
      "@amazon-devices/react-native-gesture-handler": "~2.0.0"
}

Vega上的手势处理程序库提供了对官方文档中列出的所有手势类型和原生组件的支持。

手势类型	描述
平移	一种连续的手势处理程序，可以识别平移（拖动）手势并跟踪其移动。
点击	一种离散的手势处理程序，可识别一次或多次点击。
长按	一种离散的手势处理程序，当按下相应视图足够长的时间时会激活。
旋转	一种连续的手势处理程序，可以识别旋转手势并跟踪其移动。
捏合	一种连续的手势处理程序，可识别捏合手势。它允许跟踪两根手指之间的距离，并使用该信息来缩放内容。
快速滑动	一种离散的手势处理程序，当动作距离足够长和足够快时就会激活。
手动	一种没有特定激活标准或事件数据集的简单手势。应用开发者必须使用手势状态管理器在其应用逻辑中以编程方式处理状态。

原生组件	描述
RNGestureHandlerButton	手势处理程序库提供可以充当按钮的原生组件。这些组件可以被视为RN核心中`TouchableHighlight`或`TouchableOpacity`的替代者。

程序包名称	亚马逊NPM库版本	Vega OS内部版本号	Vega SDK版本	发布说明
`@amazon-devices/react-native-gesture-handler`	2.0.0+2.13.0	`OS 1.1 (201010435950)`	0.19
`@amazon-devices/react-native-gesture-handler`	2.0.0+2.13.0	`OS 1.1 (201010438050)`	0.20

有关其他库的信息，请参阅支持的第三方库和服务。

Last updated: 2025年9月30日