@cdx-ui/ 本地语
Forge UI的原生(Metro/ Expo)平台集成——嵌入了Forge的Expo配置插件
字体和Metro配置包。 保留 @cdx-ui/styles 财务报告和审定财务报表 @cdx-ui/components
平台中立,所以网络主机从不偶然地拉出博览会或字体二进制.
没有根导出 — 仅是子路径
这个包裹船 没有 . 条目。一个赤裸的 import '@cdx-ui/native' 解析失败
设计:每个子路径拥有自己的依赖生命周期,而根管将重新聚合
它们进入了这个软件包要删除的完全的阻塞点.
| 条目 | 出口 | 依赖寿命周期 |
|---|---|---|
@cdx-ui/native (配置插件) | Expo 配置插件, 通过 app.plugin.js | 构建时间 —— 说 expo/config-plugins (可选对等点),字体文件 |
@cdx-ui/native/metro | withForgeMetroConfig, (中文(简体) ), ForgeMetroConfigOptions | 构建时间 —— 说 metro-config, (中文(简体) ), uniwind/metro (可选同伴) |
@cdx-ui/native/fonts | useForgeFonts (折旧) | 运行时间 无 |
构建时间依赖被宣布为可选的对等方, 永远不要根 dependencies所以没有
此软件包将构建工具拖入运行时间安装中.
存储器的架构文件记录了下面的全部决定 "平面融合包".
安装
npm install @cdx-ui/native
同伴依赖性 — 安装您使用的子路径 。 以下平台同行
可选; react 需要(^18.2.0 || ^19.0.0) (中文(简体) ).
| 端点 | 版本 | 要求为: | 可选 |
|---|---|---|---|
react | ^18.2.0 || ^19.0.0 | @cdx-ui/native/fonts | 没有 |
expo | >=52.0.0 | 配置插件 | 对 |
react-native | >=0.76.0 | 配置插件的本地代码 | 对 |
metro-config | >=0.80.0 | @cdx-ui/native/metro | 对 |
uniwind | >=1.0.0 | @cdx-ui/native/metro | 对 |
字体 — 配置插件
将插件添加到您的 Expo 配置并重建本地应用程序( E)npx expo prebuild,或任何
expo run:* / EAS 建筑:
{
"expo": {
"plugins": ["@cdx-ui/native"]
}
}
它嵌入了每个字体家族, Forge 符号可以命名——每个可选择的显示家族,以及
Android单人家庭——每个家庭登记为 一个家庭带着所有的脸,这是
怎样 font-medium, (中文(简体) ), font-semibold, (中文(简体) ), font-bold 财务报告和审定财务报表 italic 选择真实的相貌 :
- iOS系统 ——面相文件被捆绑并列出于
UIAppFontsiOS通过家庭将他们分类 每个文件中的名称,所以 React Industrial 从fontFamily, (中文(简体) ),fontWeight财务报告和审定财务报表fontStyle。 。 。 . - 机器人 – 每个家族成为用 React Indust 字体注册的 XML 字体家族
管理器, React Industrial 唯一将数值重和斜体重应用于自定义的路径
字体。 系统
Roboto家庭登记方式相同 所以font-medium财务报告和审定财务报表font-semibold达到真正的系统加权数,而不是倒入正轨.
IOS上的身体和单个家族是系统字体,不需要嵌入. 字体为
cSS 变量层在 @cdx-ui/styles,包括a ThemeOverride 开关
运行时显示家族——插件没有FI配置意识.
插件需要开发构建; Expo Go 无法装入配置插件 。 它写着它的Android
自行登记 MainApplication 块,所以它与一个 expo-font 插件条目
为应用程序自己的字体配置 .
网络不受影响。 浏览器应用程序注册字体 @cdx-ui/styles/fonts 并且不应安装
这个包裹.
从 useForgeFonts
useForgeFonts 运行时已装入字体 expo-font,将每张相片登记为
分出家族——一种在Android上无法携带重量或斜体的形状. 它现在已贬值
总是报告 { loaded: true, error: null }。添加插件,重建,并删除钩和任何
打开闸门 loaded。 。 。 .
@cdx-ui/native/metro
withForgeMetroConfig 用Forge UI的造型层配置来包裹地铁配置. 它必须
成为 最外侧 如果你编了多个地铁配置包,请打包.
const { getDefaultConfig } = require('expo/metro-config');
const { withForgeMetroConfig } = require('@cdx-ui/native/metro');
const config = getDefaultConfig(__dirname);
module.exports = withForgeMetroConfig(config, {
cssEntryFile: './global.css',
generatedTypesFile: './uniwind-types.d.ts',
});
| 选项 | 类型 | 目的 |
|---|---|---|
cssEntryFile | string | CSS 条目文件的路径( 例如 ). './global.css') (中文(简体) ). |
generatedTypesFile | string | 生成 Tailwind 类定义的可选路径 . |
今天是Uniwind的代表。 如果造型层被换掉, 只有这个的内部 函数变化 — 消费 Metro 配置保持不变.
网络主机
通过 Metro 的 Expo web 捆绑, 所以一个 Expo-web 构建导入 @cdx-ui/native/metro这是一个
已接受的平台轴后果。 非 Expo 网络主机( Vite, Next.js) 不需要
子路径: 他们必须通过自己的网页字体路径加载字体( name@font-face 规则或网络字体
直接配置 Tailwind .
相关软件包
| 软件包 | 拥有 |
|---|---|
@cdx-ui/styles | 设计代号、CSS文物、主题工具(平台中立) |
@cdx-ui/components | 有样式的跨平台组件(平台中性) |