在UNITY中开发和使用自定义的Package

1.Package项目结构要求

unity对于自定义Package有结构要求,大概如下:

使用的是Unity2021.3.7版本

1.1.要点说明

1. package.json – 必要的,清单文件.可自行学习具体内容;该文件必须在自定义的package文件夹的根目录下.

内容示例:
{
  "name": "com.**.**",
  "displayName": "**",
  "description": "**",
  "version": "1.0.0",
  "unity": "2021.3.7",
  "author": "**",
  "license": "MIT"
}

2.创建项目

建议先新建空unity项目,然后在Assets下创建一个问价夹用做Package的根目录.大致如下:

 - Assets
   - PackageRoot(这是示例,可自定义文件夹名称) 
     - package.json
     - Editor
     - RunTime

然后按照正常项目开发即可.

3.将Package引入新项目

3.1.本地引入

在新项目进行一下操作:
Window->Package Manager->面板左上角加号->Add package from disk->选择package.json

3.2.从git引入

3.2.1.先将完整package项目上传git

1. 打开Package项目Assets的上级文件夹
2. 创建并编辑好.gitignore文件
3. 右键->Git Bash Here->依次输入以下命令

git init  // 在当前选择文件夹下初始化git配置
git add . // 添加当前文件夹下的所有文件到暂存区(.ignore文件标记的除外)
git commit -m "提交描述" // 添加描述,并将暂存区内容提交至本地仓库 
git branch -M main //创建名为main的分支
git remote add origin git地址
// 将本地仓库关联到远程仓库 origin表示远程仓库,即主仓库 这里的git地址是项目的http地址
git push -u origin main //将本地仓库推送到远程仓库的main分支           

3.2.2.为PackageRoot创建upm分支

git subtree split --prefix=Assets/PakcageRoot --branch upm //生成upm分支,将Assets/PakcageRoot目录放到upm分支
git tag FinalVersion upm //给upm分支打标签为FinalVersion(可自定义)
git push origin upm --tags //将带tag的upm推送上远程服务器

3.2.3.拉取package

Window->Package Manager->面板左上角加号->Add package from git URL->输入url如下:
其中"#FinalVersion" 表示使用3.2.2中tag对应版本

https://github.com/***/***.git#FinalVersion

3.2.4.后续维护和更新Package

1. package项目维护完成后
2. 更新package.json中version
3. 打开Assets上级目录->右键->选择Git Bash Here->依次输入以下指令即可.

git add .
git commit -m "提交描述"
git push -u origin main
git subtree split --prefix=Assets/DebugUI --branch upm
git tag *** upm  //可以                           
git push origin upm --tags  //将带有tags的upm分支推送到远程服务器，覆盖oring upm分支 

3.3.新项目中查看package代码

Edit->Preferences->External Tools->勾选Git packages->Regenerate project files