为包创建样本
包含可选样本,可帮助Users学习包和导入示例内容。
阅读时间3 分钟最后更新于 8 天前
从 Unity Editor 版本 2019.1 开始,您可以向包添加样本。样本可以是示例代码、一些着色器和 Textures、一些动画或通常在 Project 的 Folder 下查找的任何其他文件。
Assets当您 Open Package Manager 窗口并选择包含样本的包时,包中的每个样本的细节面板中都会显示一个导入按钮。当您选择导入时,包管理器会将该样本的整个子文件夹结构复制到项目的 Folder 下。
Assets要向包添加样本:
-
将资源文件或示例 C# 代码文件放在 Samples~ 文件夹下。一个包中可以有多个样本;Folder 的每个子文件夹都有一个样本。
Samples~
样本文件的位置
您可以在包的 Folder 子文件夹下添加样本 Assets。例如,具有着色器样本的包可能如下所示:
Samples~MyPackage ├── package.json └── Samples~ ├── SamplesHDRP │ ├── Textures │ | ├── MossyRock.bmp │ | └── SandyRock.bmp │ └─ 着色器 │ ├── 光照纹理混合 HDRPrGraph │ └── Lit Vertex Color HDRP.ShaderGraph └── SamplesStandard │ ├── Textures │ | ├── MossyRock.bmp │ | └── SandyRock.bmp │ └─ 着色器 │ ├── StandardTextureBlend.shader │ └── StandardVertexColor.shader └── SamplesUniversalRP ├──Textures | ├── MossyRock.bmp | └── SandyRock.bmp └── Shader ├──光照纹理混合 URP.ShaderGraph └── Lit Vertex Color URP.ShaderGraph
在清单中包含样本
将名为 的 json Array 添加到 文件。对于每个样本,将至少包含和的 json Object 添加到样本文件夹:
samplespackage.jsondisplayNamepath密钥 | 描述 |
|---|---|
| 在 包管理器 窗口中的细节细信息中显示的样本Name。 |
| 样本演示或包含的内容的简要描述。这仅用于包清单。描述不会出现在界面中,甚至作为工具提示。 |
| 从 |
例如,使用与样本文件位置示例相同的结构,部分如下所示:
samples{ "samples": [ { "displayName":“HDRP 着色器”, "description": "包含高清渲染管道的样本着色器", "path":"Samples~/SamplesHDRP" }, { "displayName":“URP 着色器”, "description": "包含通用渲染管道的样本着色器", "path":"Samples~/SamplesUniversalRP" }, { "displayName":“标准 RP 着色器”, "description": "包含标准渲染管道的样本着色器", "path":"Samples~/SamplesStandard" } ]}