如何在嵌入式Unity包的package.json中添加Git包依赖？

Unity完全支持将Git托管的包作为嵌入式包的依赖，你之前遇到的问题是因为依赖的写法不符合Unity的要求，下面是具体的解决方法：

问题原因说明 #

• 直接填写Git原始URL报错SemVer格式问题：Unity要求Git地址依赖必须附带版本标识（标签、分支或Commit哈希），不能只用裸URL
• 写版本号1.1.4找不到包：该包未上传至Unity官方注册表或你配置的自定义注册表，Unity无法通过版本号自动检索到

正确实现方式 #

方式1：修改package.json添加带标识的Git依赖 #

打开你的嵌入式包的package.json，在dependencies字段中按照以下格式添加依赖：

"dependencies": {
  "com.itisnajim.socketiounity": "git+https://github.com/itisnajim/SocketIOUnity.git#v1.1.4"
}

• #v1.1.4对应仓库的版本标签（该仓库已打v1.1.4标签，必须和仓库实际标签一致）
• 如果需要指定分支，可替换为分支名，比如#main；指定特定Commit则替换为Commit哈希值，比如#a1b2c3d
• 注意依赖包名必须和目标仓库package.json中的name字段完全一致（SocketIOUnity的包名是com.itisnajim.socketiounity）

保存文件后，Unity会自动触发依赖拉取，完成后即可正常使用该包。

方式2：通过Unity Package Manager手动添加 #

1. 打开Unity编辑器，点击顶部菜单Window > Package Manager
2. 点击Package Manager左上角的+按钮，选择Add package from git URL...
3. 输入带版本标识的Git地址，比如https://github.com/itisnajim/SocketIOUnity.git#v1.1.4，点击Add
4. 等待Unity拉取完成后，这个包会被自动识别为你的嵌入式包的可依赖项

注意事项 #

• 确保你的网络可以正常访问目标Git仓库
• 如果目标仓库的package.json配置不符合Unity包规范，可能会出现拉取失败，此时需要检查仓库的package.json是否包含name、version等必填字段

内容的提问来源于stack exchange，提问作者Royi Bernthal