# @asheeui/native 中文文档

规范地址：https://npmcn.com/package/%40asheeui/native/

版本：2\.9\.2
npm 元数据更新时间：2026-11-07T18:35:45.374Z
中文译文更新时间：2026-11-09T22:25:17.437Z
软件包许可：Apache-2\.0

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

原始 npm 页面：https://www.npmjs.com/package/%40asheeui/native
原文对照：https://npmcn.com/package/%40asheeui/native/?lang=original

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

- 包体积（解压后）：2.1 MB，1129 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- 运行依赖：1 个
- peer 依赖：react ^18\.0\.0 \|\| ^19\.0\.0，nativewind \>=4\.2\.0，react-native \>=0\.78\.0
- 首次发布：2026-10-08T14:30:49.221Z
- 最新版本发布：2026-11-07T18:35:45.183Z
- 近 30 天下载量：1705（2026-10-07 至 2026-11-05，npm 官方下载统计）
- 已发布版本数：11（近 12 个月 11 个）

## 中文简介

反应原生组件与原生Wind风格,共享AsheeUI设计语言和组件合同.

## 安装

```sh
npm install @asheeui/native
```

也可以使用：`pnpm add @asheeui/native`、`yarn add @asheeui/native`、`bun add @asheeui/native`

## README

# @asheui/ 本地语

AsheeUI on React Industrial: 相同的组件词汇,相同的道具合同和 与网络渲染器相同的设计语言,由平台自己建造 组件,所以屏幕表现平台的行为。 造型是原始风云, 和图层,两个渲染器共享 `@asheeui/core`。 。 。 .

## 特征

-   **整套内容** ——58个组件中的每一个组件的相容性 对本地人的矩阵承诺得到落实:布局包、外地家庭、 反馈和状态家族、导航、覆盖、页面外壳和 营销乐队.
-   **一个跨平台的词汇** ——一个组件由同名导入 并使用与其网页对应的相同道具,所以屏幕和页面可以共享 他们的构成.
-   **排版工具包和反应能力** —— 说 `Container`, (中文(简体) ), `Stack`编号 :`HStack`编号 :`VStack`, (中文(简体) ), `Grid`, (中文(简体) ), `Section`, (中文(简体) ), `Split` 财务报告和审定财务报表 `Page` 及其标题、内容和页脚,加 `useBreakpoint` 与纯洁 `resolveBreakpoint` 财务报告和审定财务报表 `resolveGridColumns`。 。 。 .
-   **配置驱动** ——每个组件登记并解决其缺省 通过同样的级联, 渲染器读取, 因此一个值可以在全球设定, 每 组件或每个实例.
-   **平台的无障碍性** ——角色和状态在平台上被表述 拥有词汇,每个组件的测试都证实了这些词汇.
-   **类型脚本第一** ——在每个出口符号上用JSDoc完全打入道具.

## 所需资源

-   反应18.2或更新,或19
-   通过 Expo 或 裸体 项目, 反应本地 0. 78 或 更新
-   原生Wind 4.2或更新,带有 **尾风 CSS 3.x** —— 本地Wind v4 不编译为 Tailwind v4, 这是网页渲染器使用的
-   22.12或较新的发展节点

## 安装

```bash
npm install @asheeui/native
```

软件包期望应用程序能提供平台的工具链,所以 设置可以适应应用程序自己的配置,而不是替换. 三个 文档和一个提供者 :

```js
// babel.config.js — the interop runtime, which is what turns a className into a style
presets: [
  ["babel-preset-expo", { jsxImportSource: "nativewind" }],
  "nativewind/babel",
];

// metro.config.js — the stylesheet NativeWind compiles (import it from App.tsx too)
module.exports = withNativeWind(getDefaultConfig(__dirname), {
  input: "./global.css",
});

// tailwind.config.js — NativeWind's preset, the eight colour roles as the properties the
// provider paints, and the package's own classes; the globs are absolute, so any install
// layout works
const asheeui = require("@asheeui/native/tailwind-preset");

module.exports = {
  presets: [asheeui],
  content: ["./src/**/*.{ts,tsx}", ...asheeui.content],
};
```

然后将应用程序根包入 `AsheeUIProvider` - 网络渲染器使用的同名名称, 配置相同的:轴;组件;调色板(`color`和 `defaultTheme`,它遵循设备的颜色方案(`AsheeNativeProvider` 一样 其平台名称下的组件)。 在第一个屏幕前有三件事值得了解:

-   **不安装 `react-native-css-interop` 你自己来.** 土著Wind 4.2.7号船 它需要的,是你们自己决定的一针,而不是它,每个部件都变成无形的 没有扔.
-   **调色板来自配置,而不是来自 `tailwind.config.js`。 。 。 .** 预设 将每个角色声明为 `rgb(var(--ashee-<role>) / <alpha-value>)` 供应商用品 数值,所以 `theme.extend.colors` 输入角色在构建时修正并停止 如下 `defaultTheme`。提供者接受网络渲染器自己的 `ExternalConfig` 加号 仅限平台 `defaultSize`,所以一个配置对象——键入 `ExternalConfig`,或 `AsheeConfig` 从 `asheeui` ——描述两个渲染器.
-   **一个开发大楼说,当管道没有连接.** 供应商检查 运行时间、编译的样式表以及挂载的预设,并用 因为它找到了; `verifyNativeWind()` 返回与数据相同的诊断.

[原生反应](https://www.asheeui.com/platforms/native) 文档,每个步骤 失败看起来像, 和命令检查他们.

公布的切入点是包根, `@asheeui/native/section-kit` 财务报告和审定财务报表 `@asheeui/native/tailwind-preset`;没有每个组件子路径,所以一个组件是 从根部以名称导入,捆绑则由捆绑者而不是由 导入路径.

## 快开始

```tsx
import { AsheeNativeProvider, Button, Card, Text } from "@asheeui/native";

export function Screen() {
  return (
    <AsheeNativeProvider>
      <Card title="Invoices" description="Three are waiting for approval.">
        <Text>Nothing leaves the device until you send it.</Text>
        <Button onPress={() => undefined}>Approve all</Button>
      </Card>
    </AsheeNativeProvider>
  );
}
```

## 文档

文件是网站,使每个网页成为每一页 `.md` 变式和 作为一体 `llms-full.txt`数字 :

-   [原生反应](https://www.asheeui.com/platforms/native) ——设置,造型管线,平台决定什么
-   [安装](https://www.asheeui.com/getting-started/installation)
-   [配置](https://www.asheeui.com/concepts/configuration)
-   [构成部分](https://www.asheeui.com/components)
-   [无障碍](https://www.asheeui.com/concepts/accessibility)
-   [移徙](https://www.asheeui.com/migration)

## 链接

-   联合国 [https://www.asheeui.com (中文(简体) )](https://www.asheeui.com/)
-   仓库 : [https://github.com/AsheeSoftworks/AsheeUI (英语)](https://github.com/AsheeSoftworks/AsheeUI)
-   问题: [https://github.com/AsheeSoftworks/AsheeUI/issubs (中文(简体) )](https://github.com/AsheeSoftworks/AsheeUI/issues)

## 许可证

AsheeUI根据Apache许可证2.0获得许可 `LICENSE` 使用这个软件包的文件船, 版权和归属通知 `NOTICE` 旁边. [许可证发放](https://www.asheeui.com/project/licensing) 解释重新分配需要什么.

## 常见问题

### @asheeui/native 是什么？

反应原生组件与原生Wind风格,共享AsheeUI设计语言和组件合同\.

### 如何安装 @asheeui/native？

在项目目录运行 npm install @asheeui/native，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：react（^18\.0\.0 \|\| ^19\.0\.0）、nativewind（\>=4\.2\.0）、react-native（\>=0\.78\.0）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

### @asheeui/native 支持 TypeScript 吗？

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

### @asheeui/native 支持 ESM 还是 CommonJS？

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

### @asheeui/native 可以商用吗？

@asheeui/native 使用 Apache-2\.0 许可。宽松许可：允许商业使用、修改和再分发，并附带明确的专利授权；分发时需保留许可与 NOTICE 文件，修改过的文件要注明改动。以上为概括，不构成法律意见，请以许可原文为准。

### @asheeui/native 的下载量有多少？

根据 npm 官方下载统计，@asheeui/native 在 2026/10/07 – 2026/11/05 这 30 天内被下载 1,705 次，日均约 57 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @asheeui/native 还在维护吗？

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