Unity 如何制作和发布你的 Package

一、制作你的第一个 Package

Unity Package 不做过多赘述,像 URP 本质上也是一个 Package,在 Unity 中可以通过菜单栏 → Window → Package manager 来管理你当前的所有 Package

本篇文章主要介绍:如何制作并发布属于你的 Package

1.1 Package 主要包含以下内容

你的 Package 所实现的功能/提供的工具本身,其中的内容包括但不限于:

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

除此之外,还需要添加 package 信息文件

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

以及每个包还必须包含一个 Package 清单:package.json 文件,用于声明包体信息,包括名称、版本、依赖和仓库地址等

1.2 Package 目录结构

对于单一 Package:官方手册推荐布局样式

<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

例如 URP Package 的第一层目录如下:

如果你有多个 Package,可以再添加一层,便于管理:

例如上,其中根文件夹用你的名字(作者名字),子文件夹为每个独立的 Package

1.2.1 各个目录里应该放置哪些内容

Editor 文件夹

  • 包含一些只在编辑器中使用的功能,在这里放置的脚本将只在 Unity 编辑器环境中执行
  • 需在 Editor 文件中添加对应的 asmdef 文件

Runtime 文件夹

  • 包含在游戏运行时使用的功能,这里的脚本将在游戏运行时执行
  • 在 Runtime 文件添加对应的 Unity.TestPackage.asmdef

Tests 文件夹或其他文件夹

  • 包含你的测试场景、及其对应的材质、音效、场景等资产等。对于这部分内容,确保移除后不会影响你 package 本身的功能,实际大项目应用该 package 时,可以选择只要 Runtime 和 Editor 部分的内容

1.3 Package 信息清单文件和配置文件

1.3.1 Package 配置清单文件:package.json

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

必要信息

  • name:包名,需满足如下命名规范:①包名起始必须为 com.<company-name>,例如 com.happyengine-clusterlight;②需低于 50 个字符,且仅能包含小写字母、数字、连字符-、下划线_和点.
  • version:版本号,需遵守:主版本.次版本.补丁版本规则即 x.x.x

建议信息

  • displayName:在编辑器中的展示名称
  • description:简介,展示与 Package Manager 窗口中,支持 UTF-8 编码字符
  • unity:支持当前 package 的最小 Unity 版本
  • author:作者信息,可包含 name,email 和 url

其它可选信息:

  • keywords:Package Manager 搜索 API 使用的关键字数组,这可以帮助用户找到相关的包,对于公司内的仓库而言,完全可以不填
  • unityRelease:针对上面的 version,补充指明特定的 Unity 发行版本:例如 44f1
  • dependencies:当前 package 依赖的其它包名及版本,key 为包名,value 为版本,可以有多个,不支持范围语法,例如 "com.happyengine-clusterlight": "1.0.0"
  • documentationUrl:当前 package 对应的文档

一个例子:

{"name": "com.happyengine-clusterlight","version": "1.0.0","displayName": "Hyychen.ClusterLight","description": "移动平台实时动态多点光源方案","unity": "2020.3","documentationUrl": "https://blog.csdn.net/Jaihk662/article/details/137153400","dependencies": {},"keywords": ["Cluster","MultipleLight"],"author": {"name": "Jaihk662","email": "1045376785@qq.com","url": "https://blog.csdn.net/Jaihk662"}
}

1.3.2 License 版权文件

符合法律要求 - Unity 手册

1.3.3 ChangeLog 文件

用于记录当前 package 的每一次更新内容,可以理解为是 git commit log,可以通过类似于 git 工具自动导出,一个简单的例子如下:文件名称必须为 CHANGELOG.md,且同样需要放在 package 的根目录下

# Changelog
## [1.0.0] - 2024-02-29
- ClusterLight ViewSpace 初版完成
## [2.0.0] - 2024-03-04
- 添加了一个室内场景用于测试
- ClusterLight ViewSpace 实现
## [3.0.0] - 2024-03-05
- 修改测试场景的光照及材质表现
## [4.0.0] - 2024-03-11
- 支持 WorldSpace ClusterLight
## [5.0.0] - 2024-03-26
- 支持 CPU 计算 ClusterLight,以适配不支持 ComputeShader 的手机

建议还是要有一份,除非你没有做版本管理 or 只有当前一个版本

1.3.4 Readme 文件

用于展示在你 package 主页的内容,和 Git README.md 文件作用一致,可使用 markdown 编辑器编辑,文件名称必须为 README.md

一般可以只填写注意事项,如果不想专门写的话,里面存放你功能对应的文档链接即可

二、程序集定义和包

包中的 .cs 脚本文件必须与程序集定义文件 .asmdef 关联(在同一目录下),.asmdef 等同于 .Net 生态的 C# 工程,得益于此功能,开发者可以在一个文件夹中自定义程序集。定义明晰的依赖关系,也可以确保脚本更改后,只会重新生成必需的程序集以减少编译时间

2.1 创建你当前 package,Runtime 及 Editor 下的 asmdef 文件

程序集定义 (Assembly Definition) 属性 - Unity 手册

可通过右键 → Assets > Create > Assembly Definition 菜单来创建当前默认的 asmdef 文件

对于 Editor 目录:需要将特定于 Editor 的代码存储在根 Editor 程序集定义文件中:

Editor/[YourCompany].[YourPackageName].Editor.asmdef

asmdef 文件会把其所在文件夹下的脚本打入同一个程序集中,如果一个文件夹及子文件夹中有多个 asmdef 文件,每个脚本被添加到离这个脚本最短路径的 asmdef 中去。如果你搞不清楚一个脚本究竟被包含在了哪个 asmdef 中,只需要选中这个脚本,在 Inspector 面板中就会清楚的看到

同理对于 Runtime 目录,也需要将特定于运行时的代码存储在根运行时程序集定义文件中:

Runtime/[YourCompany].[YourPackageName].Runtime.asmdef

如果你的其它目录中(例如 Test 目录)也包含 CS 脚本,则也需要配置相关的测试程序集:例如

Runtime/[YourCompany].[YourPackageName].Test.asmdef

2.2 asmdef 文件配置信息

程序集定义文件格式 - Unity 手册

只新增 asmdef 是不够的,还需要进行设置,首先是依赖关系

若一程序集内代码有对其他程序集的代码的引用,则必须在.asmdef的 Inspector 中Assembly Definition References选项下添加对该程序集文件的引用,例如你当前的 Editor 极大概率需要依赖其 Runtime asmdef

如果想要将已经预编译好的程序集(dll)关联到 assembly definition file 中,需要勾选上面的 Override References 后再添加对应的 dll

同时对于不同平台的代码,根据代码作用在.asmdef文件的Platforms选项下选定程序集运行平台,例如对于 Editor 的 asmdef 而言,其必然只会在 Editor 下生效,Unity 仅在包含的平台上编译或引用此程序集

如果你的 Runtime 逻辑不区分平台,则保持默认设置 Any Platform

Package 中部分代码想要选择性的参与编译,可以通过在 Assembly Definition File 中 的 Version Define 自定义宏,并选择宏开启的条件,条件一般为:

  1. 在特定的程序集存在的情况下启用宏(图中 Resource 展开选择即可)
  2. 在特定版本的程序集存在的情况下启用宏,如对版本不做限制,输入0.0.0 或留空即可

当然还要注意

  1. 直接在界面中选择 package 可能只能选择当前已经存在的 package,这明显是不科学的,因为启用该宏的 package 可能不存在,此时需要你用文本打开 asmdef 文件直接编辑
  2. 如果确信程序集存在且版本正确,但是宏未启用,请为插件重新生成 vs 项目,具体方式为 Edit → Preferences → External Tools → Regenerate project files

其他一些不是特别重要的配置信息大部分情况下都可以保持默认,例如 Define Constraints,有特殊需求可以直接参考前面 2.1 提供的官方文档的链接

三、发布 or 获取你的 package

3.1 使用本地的 package

注意,用于开发 package 的工程,和你实际安装 package 的工程不能是同一个!也就是 Asset 下和 Packages 下不能出现相同的两份代码,不然会出现重复加载问题。如果想要测试下载你自己开发的 package,可以启用一个空项目

如果你前面对 package 的设置没有问题,就可以测试添加自己的 package 了

  1. 开启一个空项目,或者打开一个正常研发的项目(例如 ROMeta)
  2. 通过 Window → PackageManager 尝试添加你的 package,或者直接修改 Packages 根目录下的 manifset.json 文件

最后进入游戏,检查 package 对应功能是否正确,此时你也可以通过 UPM 找到自己的 package

3.1.1 *你项目里所有的 Package,它们都在哪里

Unity 的 Package Manager - Unity 手册

可以确定的是,这些 package 不会在你的 Asset 文件里,那么它们究竟在哪呢?

你的 package 会默认存储在 library/packagecache/ 目录下,项目是直接读取这个目录的,此时如果你要修改 package 里面的内容(例如修改 URP 源码),就不行,因为 library/packagecache/ 目录更像是一个存储 cache 的地方,如果对应的 package 有更新,那么你修改的内容也会丢失,同时你的项目 git 也不会管理 library 目录

因此,如果你要修改他人的 package 源码,需要将对应的 package 目录挪到和 Assets 同级的 Packages 目录下(其它目录也可,不过需要修改 manifest.json),而非保留在原位置 (library/packagecache/)

当然你也可以放置到其它的自定义位置,只要确保不在 library、Assets 等已有规则的目录中即可,不过此时就需要修改 manifest.json 文件,重新指定其 package 位置,一个格式参考如下

"com.unity.render-pipelines.core": "file:../HappyEnginePackages/com.unity.render-pipelines.core@10.10.1",
"com.unity.render-pipelines.universal": "file:../HappyEnginePackages/com.unity.render-pipelines.universal@10.10.1",
"com.unity.textmeshpro": "file:../HappyEnginePackages/com.unity.textmeshpro@3.0.6",
"com.happyengine-clusterlight": "file:../HappyEnginePackages/com.happyengine-clusterlight@5.0.0",

其对应的位置如下

当然,UPM 还有一个叫做 global cache 的地方,位置为 %LOCALAPPDATA%\Unity\cache,这个地方也会存放 Unity 的 packages 作为 unity 的所有版本所有项目的 cache,在 unity 启动的时候,它会本地启动一个 http server 并会往这个 local server 发请求,然后这个 local server 会从 manifest.json 中读取信息,从你配置的 registry 下载相关的 packages,如果发现 global cache 没有的,它会在那里放一份,如果发现有的,它就会直接从 global cache 里面拷贝一份到打开的项目

因此,如果你某个 package 一直报错,并且和你当前的 Unity 项目无关,可以尝试删除这个目录下的对应 package,并将 library/packagecache/ 也删除后重试,定能解决问题

3.2 发布的 package 需满足的规范

依照具体项目而定

3.3 使用 UPM 发布你的 package

依照具体项目而定

本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如若转载,请注明出处:http://www.mzph.cn/news/830111.shtml

如若内容造成侵权/违法违规/事实不符,请联系多彩编程网进行投诉反馈email:809451989@qq.com,一经查实,立即删除!

相关文章

自制贪吃蛇小游戏

此片文章涉及到到控制台设置的相关操作&#xff0c;虚拟键码&#xff0c;宽字符输出等&#xff0c;有些地方大家可能会看不懂&#xff0c;可以阅读以下文章来进一步了解&#xff1a; 控制台程序设置-CSDN博客 效果展示&#xff1a; QQ2024428-181932 源码已放在文章结尾 目录 …

Graph Neural Networks(GNN)学习笔记

本学习笔记的组织结构是&#xff0c;先跟李沐老师学一下&#xff0c;再去kaggle上寻摸一下有没有类似的练习&#xff0c;浅做一下&#xff0c;作为一个了解。 ———————————0428更新—————————————— 课程和博客看到后面准备主要看两个&#xff1a;GCN和…

ubuntu安装Anaconda安装及conda使用

一. 安装anaconda3详细教程 1、下载镜像 清华大学开源软件镜像站下载地址&#xff1a; https://mirrors.tuna.tsinghua.edu.cn/anaconda/archive/ 下拉到最低端选择Linux&#xff0c;选择最新版&#xff08;32/64位&#xff09;下载。这里我下载的是版本Anaconda3-4.3.30-Linux…

Java中的File类

File类概述和构造方法 File&#xff1a;它是文件和目录路径名的抽象表示 文件和目录是可以通过File封装成对象的 对于File而言&#xff0c;其封装的并不是一个真正存在的文件&#xff0c;仅仅是一个路径名而已&#xff0c;它可以存在&#xff0c;也可以不存在 我们对Fie的操…

大厂常见算法50题-替换空格

专栏持续更新50道算法题&#xff0c;都是大厂高频算法题&#xff0c;建议关注, 一起巧‘背’算法! 文章目录 题目解法一 String类replace方法解法二 遍历替换总结 题目 解法一 String类replace方法 String类自带的replace&#xff0c;方法传入两个char类型的参数&#xff0c;分…

【MySQL 数据宝典】【索引原理】- 004 优化示例-join in exist

一、join 优化原理 1.1 基本连接方式介绍 JOIN 是 MySQL 用来进行联表操作的&#xff0c;用来匹配两个表的数据&#xff0c;筛选并合并出符合我们要求的结果集。 1.2 驱动表的定义 1.2.1 什么是驱动表 多表关联查询时,第一个被处理的表就是驱动表,使用驱动表去关联其他表.驱…

使用 SSH 密钥配置 Git 账号需要以下步骤

1、生成 SSH 密钥&#xff1a; 如果你还没有 SSH 密钥&#xff0c;可以使用以下命令在电脑终端中生成一个新的 SSH 密钥&#xff1a; ssh-keygen -t rsa -b 4096 -f /Users/XXXX/.ssh/id_rsa_my_personal -C "your_emailexample.com" ssh-keygen 是用于生成 SSH 密…

《Fundamentals of Power Electronics》——Buck、Boost、Buck-Boost三个电路的CCM-DCM工作特性总结

Buck、Boost、Buck-Boost这三个电路的CCM-DCM工作特性总结如下表所示&#xff1a; Buck、Boost、Buck-Boost这三个电路工作在DCM模式下电压传输比的对比图如下所示&#xff1a; 由上图可知&#xff0c;Buck-Boost电路的工作特性是一条斜率为的直线&#xff0c;Buck电路和Boost电…

RK3588 - RKNN(Rockchip 神经处理单元)的逆向工程

本文翻译自https://jas-hacks.blogspot.com/2024/02/rk3588-reverse-engineering-rknn.html RK3588 NPU 的内部操作和功能主要隐藏在名为RKNPU2的闭源 SDK 中。由于对大型语言模型 (LLM) 的兴趣以及对transform模型最佳矩阵乘法的追求&#xff0c;想了解 RKNPU SDK 新引入的矩阵…

自动开箱机:提升包装物流效率的关键设备

随着电子商务的飞速发展&#xff0c;物流行业面临着重要的挑战和机遇。如何在保证服务质量的同时&#xff0c;提高物流效率&#xff0c;降低成本&#xff0c;成为摆在物流企业面前的重要课题。在这个背景下&#xff0c;自动开箱机以其高效、精准、省力的特点&#xff0c;正逐渐…

OpenMM——教程学习(1)

如何从零开始做一个蛋白小分子动力学模拟 AmberTools将被用来生成输入文件&#xff0c;OpenMM 将被用来运行模拟&#xff0c;模拟平台为在线百度AI Stuio, 并使用GPU加速。 First thing’s first, 到PDB 蛋白数据库下载一需要模拟的靶点晶体&#xff0c;备用。 1. H web server…

一文讲清:什么是供应商管理?供应商管理怎么做?

供应商管理指的是对供应商的了解、选择、开发、使用和控制等综合性管理工作的总称。其目的在于建立起一个稳定可靠的供应商队伍&#xff0c;为企业生产提供可靠的物资供应。但是企业在进行供应商管理往往面临以下问题&#xff1a; 1、招投标&#xff0c;信息不透明 这主要表…

R语言的基本图形

一&#xff0c;条形图 安装包 install.packages("vcd") 绘制简单的条形图 barplot(c(1,2,4,5,6,3)) 水平条形图 barplot(c(1,2,4,5,6,3),horiz TRUE) 堆砌条形图 > d1<-c("Placebo","Treated") > d2<-c("None",&qu…

你不需要总是在 React 中使用 useState

在我审查的一个拉取请求中&#xff0c;我注意到在许多拉取请求中看到的一种模式。React 组件具有多个 UI 状态&#xff0c;例如 loading、error 和 success。 作者使用了多个 useState 钩子来管理这些状态&#xff0c;这导致代码难以阅读且容易出错&#xff0c;例如&#xff1a…

hadoop命令

hadoop命令 目录 hadoop命令 1.查看文件下面有哪些文件和目录 2.获取文件信息 查看文件内容 3.创建一个文件夹 4.剪切 1&#xff09;从本地hadoop剪切到hdfs并上传到hdfs 2&#xff09;剪切 从hdfs剪切到本地hadoop目录上 5.删除 1&#xff09;递归删除 2&#xff0…

springboot权限验证学习-下

上篇讲了rbac对于菜单的权限&#xff0c;下面准备完成按钮权限以及行数据和列数据权限 权限控制(按钮权限) 权限控制 操作权限就是将操作视为资源&#xff0c;比如删除操作&#xff0c;有些人可以有些人不行。于后端来说&#xff0c;操作就是一个接口。于前端来说&#xff0…

秋招后端开发面试题 - JVM底层原理

目录 JVM底层原理前言面试题Java 对象的创建过程&#xff1f;什么是指针碰撞&#xff1f;什么是空闲列表&#xff1f;/ 内存分配的两种方式&#xff1f;JVM 里 new 对象时&#xff0c;堆会发生抢占吗&#xff1f;JVM 是怎么设计来保证线程安全的&#xff1f;/ 内存分配并发问题…

k8s pod使用sriov

之前的文章中讲了k8s multus的使用&#xff0c;本章节来讲述下如何使用multus来实现sriov的使用。 一、sriov 简介 SR-IOV在2010年左右由Intel提出&#xff0c;但是随着容器技术的推广&#xff0c;intel官方也给出了SR-IOV技术在容器中使用的开源组件&#xff0c;例如&#…

3MF体积设计扩展

3MF 联盟最近宣布了他们最新的体积设计扩展&#xff08;volumetric design extension&#xff09;&#xff0c;用于通过基于体积的描述来编码几何形状和空间多样性属性。 该组织致力于推进 3D 打印的通用规范&#xff0c;目前正在新扩展达到 1.0 之前征求公众反馈。 NSDT工具推…

OpenCV 实现重新映射

返回:OpenCV系列文章目录&#xff08;持续更新中......&#xff09; 上一篇&#xff1a;OpenCV 实现霍夫圆变换 下一篇 :OpenCV实现仿射变换 目标 在本教程中&#xff0c;您将学习如何&#xff1a; 一个。使用 OpenCV 函数 cv&#xff1a;&#xff1a;remap 实现简单的重新…