Unity工具—制作与使用Package

mastertravels77 · 发表于 2023-2-13 18:29

本文讲解如何制作 UPM 包，并通过本地和 Git 导入项目，参考官方手册，实际项目可参考本人制作的工具包 GRUnityTools
原文地址：Unity工具—制作与使用Package
Unity Package Manager

UPM 是 Unity 提供的包管理系统，可快速便捷地下载和更新 Unity 功能，和发现与共享用户自定义组件

Unity Editor 下可在 Window > Package Manager 打开 UPM 窗口并安装官方包或通过 URL 添加自定义包
在项目路径下 ./Packages/manifest.json，显示了所有依赖包名和版本，可根据格式添加自己所需的包

制作 Package

内容

Package 可包含

C# 脚本
程序集 Assembly
原生插件 Plugin
模型、贴图、动画和音频等其他资产

也可添加其他信息文件

修改日志 CHANGELOG.md
说明文件 README.md
版权声明 LICENSE.md
文档 Document~ （文件夹名后加~可使工程忽略该文件夹，文档仍是 md）

另外每个包还包含一个 Package 清单，package.json，用于声明包体信息，包括名称、版本、依赖和仓库地址等
命名规范

包名起始必须为com.<company-name>，例如com.unity.timeline
若在 UI 显示则需低于50个字符，否则可低于214个字符
仅包含小写字母、数字、连字符-、下划线_和点.
为表明命名空间，可在命名空间后缀加点。如com.unity.2d.animation和com.unity.2d.ik

文件布局

官方手册推荐布局样式
<root>
  ├── package.json
  ├── README.md
  ├── CHANGELOG.md
  ├── LICENSE.md
  ├── Editor
  │ ├── Unity.[YourPackageName].Editor.asmdef
  │ └── EditorExample.cs
  ├── Runtime
  │ ├── Unity.[YourPackageName].asmdef
  │ └── RuntimeExample.cs
  ├── Tests
  │ ├── Editor
  │ │ ├── Unity.[YourPackageName].Editor.Tests.asmdef
  │ │ └── EditorExampleTest.cs
  │ └── Runtime
  │       ├── Unity.[YourPackageName].Tests.asmdef
  │       └── RuntimeExampleTest.cs
  └── Documentation~
   └── [YourPackageName].md另外对于一个工程多个 Package 的情况，可用如下布局
<root>
  ├── Packages
      ├── YourPackageName
      │    ├── package.json
      │    ├── README.md
      │    ├── CHANGELOG.md
      │    ├── LICENSE.md
      │    ├── Editor
      │    │    ├── Unity.[YourPackageName].Editor.asmdef
      │    │    └── EditorExample.cs
      │    ├── Runtime
      │    │    ├── Unity.[YourPackageName].asmdef
      │    │    └── RuntimeExample.cs
      │    ├── Tests
      │    │    ├── Editor
      │    │    │    ├── Unity.[YourPackageName].Editor.Tests.asmdef
      │    │    │    └── EditorExampleTest.cs
      │    │    └── Runtime
      │    │             ├── Unity.[YourPackageName].Tests.asmdef
      │    │             └── RuntimeExampleTest.cs
      │    └── Documentation~
   │          └── [YourPackageName].md
      └── YourAnotherPackage
            ├── Editor
            ├── Runtime
            ├── Tests
            └── Documentation~Package 配置清单

每个 Package 需有一个package.json文件，用于配置 Package 信息，在 Package 导入项目后，这些信息会在 Package Manager 窗口展示出来
必要信息

name

包名，依据上述命名规范

version

版本号，需遵守主版本.次版本.补丁版本规则即 x.x.x
建议信息

下述信息并非强制，但建议添加以更易提供他人使用

displayName

在编辑器中的展示名称

description

简介，展示与 Package Manager 窗口中，支持 UTF-8 编码字符

unity

支持 Unity 最小版本，主版本号.次版本号如 2018.3
其他信息

unityRelease

指明某些特定 Unity 发行版本

dependencies

json中以键值对出现的依赖包名和版本，如&#34;com.unity.some-package&#34;: &#34;1.0.0&#34;

keywords

关键词数组

type

内部使用类型

author

作者信息，可包含name、email 和 url
{
  &#34;name&#34;: &#34;com.unity.example&#34;,
  &#34;version&#34;: &#34;1.2.3&#34;,
  &#34;displayName&#34;: &#34;Package Example&#34;,
  &#34;description&#34;: &#34;This is an example package&#34;,
  &#34;unity&#34;: &#34;2019.1&#34;,
  &#34;unityRelease&#34;: &#34;0b5&#34;,
  &#34;dependencies&#34;: {
&#34;com.unity.some-package&#34;: &#34;1.0.0&#34;,
&#34;com.unity.other-package&#34;: &#34;2.0.0&#34;
},
&#34;keywords&#34;: [
&#34;keyword1&#34;,
&#34;keyword2&#34;,
&#34;keyword3&#34;
  ],
  &#34;author&#34;: {
&#34;name&#34;: &#34;Unity&#34;,
&#34;email&#34;: &#34;unity@example.com&#34;,
&#34;url&#34;: &#34;https://www.unity3d.com&#34;
  }
}Assembly Definition 文件

包中的.cs脚本文件必须与程序集定义文件 .asmdef关联（在同一目录下），.asmdef等同于 .Net 生态的 C# 工程
若一程序集内代码有对其他程序集的代码的引用，则必须在.asmdef的 Inspector 中Assembly Definition References选项下添加对该程序集文件的引用
同时对于不同平台的代码，根据代码作用在.asmdef文件的Platforms选项下选定程序集运行平台
对.asmdef文件命名建议依据公司.功能.平台划分，示例  ：

Editor 平台代码：Editor/MyCompany.MyFeature.Editor.asmdef
Runtime 代码：Runtime/MyCompany.MyFeature.Runtime.asmdef
测试代码：Tests/Editor/MyCompany.MyFeature.Editor.Tests.asmdef和Tests/Editor/MyCompany.MyFeature.Runtime.Tests.asmdef

发布与使用 Package

提供压缩包
发布到 Git，通过Package Manager 导入
搭建 Package 注册服务器，使用 npm 发布

Git 发布 Package

将完整项目或单一 Package 目录上传 Git
将 Package 所在目录拆分到单独分支
为该分支打标签（打版本号）
提交远端

实际操作

假设一个项目有两个包包目录: Assets/Packages/FirstPackage 和 Assets/Packages/SecondPackage
# 使用 Git 命令，将第一个包拆分到分支 FirstPackage 分支，分支名可任意命名，但为他人使用方便最好与包名相同
git subtree split --prefix=Assets/Packages/FirstPackage --branch FirstPackage
# 为该分支打版本 Tag，Tag 也可自由命名，同样为方便使用，打版本号
# 因举例该项目存在两个包因此版本前加分支名作为前缀，若仅单一包可只打版本号
# 注：版本号与package.json中统一，避免混乱
git tag FirstPackage@1.0.0 FirstPackage
# 分支和 Tag 推送远端
git push origin FirstPackage --tagsGit 导入

在需导入的项目路径下./Packages/manifest.json文件中dependencies下添加包名和Git URL 组成的键值对，URL 后需加 # 和 Package 的分支名、标签或提交，如

{
  &#34;dependencies&#34;: {
&#34;com.company.firstpackage&#34;: &#34;https://github.com/company/PackageSample.git#FirstPackage&#34;
}
} 2. 或者使用 Package Manager 窗口中的 + 按钮，Add package from git URL，直接添加上述样式的的 Git 地址
3. 其他链接形式可参考官方手册
本地导入

MacOS 绝对地址
{
  &#34;dependencies&#34;: {
&#34;com.company.firstpackage&#34;: &#34;file:/Users/company/Assets/Packages/FirstPackage&#34;
  }
}Windows 绝对地址
{
  &#34;dependencies&#34;: {
&#34;com.company.firstpackage&#34;: &#34;file:C:/Users/company/Assets/Packages/FirstPackage&#34;
  }
}相对地址
{
  &#34;dependencies&#34;: {
&#34;com.company.secondpackage&#34;: &#34;file:../Packages/secondpackage&#34;
  }
}参考

https://www.jianshu.com/p/153841d65846

stonstad · 发表于 2023-2-13 18:34

请问Package下面自己开发的工具脚本可以进行代码混淆吗？

		自动登录	找回密码
密码			立即注册