Version: 6000.3
语言: 中文
将测试添加到包
包清单文件

为包创建示例

从 Unity 编辑器版本 2019.1 开始,您可以将示例添加到包中。示例可能是一段示例代码,一些着色器在 GPU 上运行的程序。更多信息
请参阅术语表
以及纹理、一些动画或您通常可以在项目的Assets文件夹。

打开 包管理器(Package Manager) 窗口并选择包含示例的包时,包的详细信息面板中会出现 导入(Import) 按钮,其中包含包中每个示例。选择“导入”时,包管理器会将该示例的整个子文件夹结构复制到项目的Assets文件夹。

要将样品添加到包中:

  1. 将资产文件或示例 C# 代码文件放在 Samples~ 文件夹下。一个包中可以有多个样品;每个子文件夹Samples~文件夹有一个示例。

    注意:波浪号字符 () 告诉 Unity 忽略~Samples~文件夹。此类文件夹不会使用.meta文件。

  2. samples数组package.json清单文件。

示例文件的位置

您可以在Samples~文件夹。例如,包含着色器示例的包可能如下所示:

MyPackage
  ├── package.json
  └── Samples~
        ├── SamplesHDRP
        │    ├── Textures
        │    |     ├── MossyRock.bmp
        │    |     └── SandyRock.bmp
        │    └── Shader
        │          ├── Lit Texture Blend HDRP.ShaderGraph
        │          └── Lit Vertex Color HDRP.ShaderGraph
        └── SamplesStandard
        │    ├── Textures
        │    |     ├── MossyRock.bmp
        │    |     └── SandyRock.bmp
        │    └── Shader
        │          ├── StandardTextureBlend.shader
        │          └── StandardVertexColor.shader
        └── SamplesUniversalRP
             ├── Textures
             |     ├── MossyRock.bmp
             |     └── SandyRock.bmp
             └── Shader
                   ├── Lit Texture Blend URP.ShaderGraph
                   └── Lit Vertex Color URP.ShaderGraph

将样本包含在清单中

添加一个名为samplespackage.json文件。对于每个示例,添加一个 JSON 对象,至少包含displayNamepath到 samples 文件夹:

钥匙 描述
displayName 示例在“包管理器”窗口中的包详细信息中显示的名称。
description 示例演示或包含的内容的简要描述。这只是为了包清单每个包都有一个清单,该清单向包管理器提供有关包的信息。清单包含包的名称、版本、用户说明、对其他包的依赖关系(如果有)以及其他详细信息等信息。更多信息
请参阅术语表
.描述不会显示在界面中,甚至不会作为工具提示显示。
path Samples~文件夹到示例的根文件夹。

例如,使用与示例文件位置示例相同的结构,samples部分类似于以下内容:

{
    "samples": [
        {
            "displayName": "HDRP Shaders",
            "description": "Contains sample shaders for the High Definition render pipeline",
            "path": "Samples~/SamplesHDRP"
        },
        {
            "displayName": "URP Shaders",
            "description": "Contains sample shaders for the Universal render pipeline",
            "path": "Samples~/SamplesUniversalRP"
        },
        {
            "displayName": "Standard RP Shaders",
            "description": "Contains sample shaders for the Standard render pipeline",
            "path": "Samples~/SamplesStandard"
        }
    ]
}
将测试添加到包
包清单文件