rn_common

rn_common 是 RN 公共基础库，存放稳定复用能力：

• 公共 UI 组件 (不经常修改的)
• 通用类型与工具函数
• 可沉淀的基础能力（如统计、APM、网络基础封装）

环境准备

nvm use
yarn install

建议 Node 版本与 .nvmrc 保持一致。 v24.12.0

开发流程

1. 在 src/ 下新增或修改组件/工具。
2. 在 src/index.ts 统一导出对外 API。
3. 本地执行检查与构建：

yarn typecheck
yarn build

目录结构

rn_common/
  src/
    components/         # 组件
    utils/              # 工具
    index.ts
  dist/                 # 构建产物（发布目标）
  package.json
  tsconfig.json
  README.md

构建与发布策略

本仓库采用“只发布构建产物”的策略：

• package.json 中 main/module/types/react-native 指向 dist/*
• files 只包含 dist
• prepublishOnly 自动执行 yarn build

构建命令：

yarn build

发布前检查

npm whoami
yarn typecheck
yarn build
npm pack --dry-run

npm pack --dry-run 重点确认 tarball 中只有 dist/*（以及 npm 默认元文件，如 package.json、README.md）。

发布到 npmjs

首次发布 scoped 包需带 --access public：

npm publish --access public

如果版本已存在，先升级版本再发布：

npm version patch
npm publish --access public

2FA / Token 常见错误（E403）

如果报错：

Two-factor authentication or granular access token with bypass 2fa enabled is required

说明当前发布身份不满足权限：

使用 Granular Access Token（推荐 CI）

1. 在 npm 网站创建 granular token。
2. 给该 scope/package 开启 publish 权限。
3. 开启 bypass 2FA（用于发布）。
4. 本地配置 token：

npm config set //registry.npmjs.org/:_authToken=YOUR_TOKEN
npm publish --access public

给业务仓接入（rn_shove 示例）

本地联调：

"@taole_rn/rn-common": "file:../rn_common"

发布版本接入：

"@taole_rn/rn-common": "^0.1.0"

在 rn_common 下已执行：

yarn typecheck（tsc --noEmit） yarn build（rimraf dist + tsc）

修改版本号

package.json 修改版本号 src/index.ts 修改 commonVersion