# @webority/mobile-ui 中文文档

规范地址：https://npmcn.com/package/%40webority/mobile-ui/

版本：0\.119\.0
npm 元数据更新时间：2026-11-02T21:05:38.643Z
中文译文更新时间：2026-11-02T21:53:18.443Z
软件包许可：SEE LICENSE IN LICENSE\.txt

本文由上游 README 机器翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40webority/mobile-ui
原文对照：https://npmcn.com/package/%40webority/mobile-ui/?lang=original
项目主页：https://www.webority.com/

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：19.1 MB，1925 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- 运行依赖：1 个
- peer 依赖：expo \>=57\.0\.0，react ^19\.1\.0，expo-image \>=57\.0\.0，expo-haptics \>=57\.0\.0，react-native \>=0\.81\.0，react-hook-form ^7\.55\.0，expo-file-system \>=57\.0\.0，react-native-svg \>=15\.0\.0，@webority/canvas-kit 0\.119\.0，@webority/mobile-core 0\.119\.0，react-native-worklets \>=0\.10\.0，react-native-reanimated ^4\.0\.0，@react-navigation/native \>=7\.0\.0，react-native-gesture-handler ^2\.21\.0 \|\| ^3\.0\.0，@react-navigation/bottom-tabs \>=7\.0\.0，react-native-safe-area-context \>=5\.4\.0，react-native-keyboard-controller \>=1\.21\.9
- 首次发布：2026-10-04T07:10:10.196Z
- 最新版本发布：2026-11-02T21:05:38.444Z
- 已发布版本数：102（近 12 个月 102 个）

## 中文简介

美丽的，动画的，可访问的React Native组件，主题和web项目的表单引擎。

## 安装

```sh
npm install @webority/mobile-ui
```

也可以使用：`pnpm add @webority/mobile-ui`、`yarn add @webority/mobile-ui`、`bun add @webority/mobile-ui`

## README

# @webority /移动ui

77个动画的，可访问的React Native组件，具有完整的主题系统（浅色和深色），钩子， 和一个不依赖的表单引擎。平台层（HTTP、授权、配置、日志）存在于其中 [`@webority/mobile-core`](https://www.npmjs.com/package/@webority/mobile-core).

```bash
npm install @webority/mobile-ui
```

主题：颜色、半径和字体来自共享的web token。应用程序将其品牌和设置传递给ThemeProvider（参见docs/mobile/migration-to-0.89.md）。

没有外部运行时依赖 `@webority/mobile-core`。需要 `react-native-gesture-handler`， `react-native-reanimated` 和 `react-native-safe-area-context` 作为 同行, `expo-file-system`,在那里 `AuthedImage` 保存其下载的图像； `react-native-haptic-feedback` 是可选的。渐变使用React Native自己的 `experimental_backgroundImage`，因此不需要梯度库。

完整的文档位于存储库的 `docs/` 目录中。

## 常见问题

### @webority/mobile-ui 是什么？

美丽的，动画的，可访问的React Native组件，主题和web项目的表单引擎。

### 如何安装 @webority/mobile-ui？

在项目目录运行 npm install @webority/mobile-ui，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：expo（\>=57\.0\.0）、react（^19\.1\.0）、expo-image（\>=57\.0\.0）、expo-haptics（\>=57\.0\.0）、react-native（\>=0\.81\.0）、react-hook-form（^7\.55\.0）、expo-file-system（\>=57\.0\.0）、react-native-svg（\>=15\.0\.0）、@webority/mobile-core（0\.119\.0）、react-native-worklets（\>=0\.10\.0）、react-native-reanimated（^4\.0\.0）、react-native-gesture-handler（^2\.21\.0 \|\| ^3\.0\.0）、react-native-safe-area-context（\>=5\.4\.0）、react-native-keyboard-controller（\>=1\.21\.9）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

### @webority/mobile-ui 支持 TypeScript 吗？

支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

### @webority/mobile-ui 支持 ESM 还是 CommonJS？

同时提供 ES Module 与 CommonJS 入口，import 和 require\(\) 都可以使用，打包工具会自动选择合适的版本。

### @webority/mobile-ui 可以商用吗？

@webority/mobile-ui 使用 SEE LICENSE IN LICENSE\.txt 许可。许可条款写在包内的独立文件中，请阅读该文件确认可否商用。以上为概括，不构成法律意见，请以许可原文为准。

### @webority/mobile-ui 还在维护吗？

最新版本 0\.119\.0 发布于 2026/11/03（今天）；至今共发布 102 个版本，其中过去 12 个月发布了 102 个；首次发布于 2026/10/04。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。