UPM 包创建、编辑和发布工具。支持 Inspector 可视化编辑、npm 发布、asmdef 自动同步。
npm install com.azathrix.upm-editor
Unity Package Manager 编辑器工具,用于创建、编辑和发布 UPM 包
Edit > Project Settings > Package Manager
Scoped Registries 中添加:
Azathrix
https://registry.npmjs.org
com.azathrix
Save
Window > Package Manager
My Registries
UPM Editor 并安装
Window > Package Manager
+ > Add package from git URL...
https://github.com/Azathrix/UpmEditor.git#latest
Packages 目录下执行:
bash
npm install com.azathrix.upm-editor
`
使用方法
$3
菜单: Azathrix > UPM Editor > 创建 UPM
创建包时可选择生成:
- Runtime/ 目录(含 .asmdef)
- Editor/ 目录(含 .asmdef)
- Tests/ 目录(含测试 .asmdef)
- Documentation~/ 目录
- README.md / CHANGELOG.md / LICENSE.md
$3
在 Project 窗口中选中 UPM 包目录,Inspector 会显示编辑界面:
- 修改包名、版本、描述等基本信息
- 管理依赖项和关键词
- 添加/删除目录和文件
- 点击"保存"按钮保存更改
修改包名后保存会自动更新所有 asmdef 文件的名称和命名空间。
$3
1. 在 Inspector 中点击"发布"按钮,或菜单 Azathrix > UPM Editor > 发布 UPM
2. 选择 Registry 类型(npm 官方 / Verdaccio / 自定义)
3. 确认 npm 登录状态
4. 选择打包方式(普通打包 / Unity 签名打包)
5. 点击"发布"
#### 发布到 npm 官方
1. 先在终端登录:npm login
2. 如果启用了 2FA,需要创建 Access Token:
- 登录 https://www.npmjs.com → Access Tokens
- 创建 Granular Access Token,勾选 "bypass 2FA"
- 运行:npm config set //registry.npmjs.org/:_authToken=你的token
3. 在发布窗口选择 "NpmOfficial",点击发布
$3
在 Project 窗口中右键文件夹:
- Move to Packages: 将 Assets 下的包移动到 Packages
- Move to Assets: 将 Packages 下的包移动到 Assets
- Create Package Here: 在当前目录创建新包
命名规范
包名和程序集名的转换规则:
- com.company.name1.name2 → Company.Name1.Name2
- com.company.name1-name2 → Company.Name1Name2`