物件播放器大包发包说明
<p>[toc]</p>
<table>
<thead>
<tr>
<th>最后更新日期</th>
<th>2024-05-21</th>
</tr>
</thead>
<tbody>
<tr>
<td>作者</td>
<td>QFord、LJX、ZYY</td>
</tr>
<tr>
<td>V1.0.0</td>
<td>创建文档</td>
</tr>
</tbody>
</table>
<h2>1.组件规范</h2>
<p><strong>[注意]</strong>当前组件已采用UPM版本，如下图所示：
<img src="https://www.showdoc.com.cn/server/api/attachment/visitFile?sign=d641149f1802ce8a82c14dfc10ec36d0&amp;file=file.png" alt="" /></p>
<h3>1.1 组件版本规范</h3>
<p><strong>正常版本号</strong>：物件播放器组件使用3位版本号，[MajorVersion].[MinorVerion].[BugFix]
比如"2.5.1"，</p>
<p><strong>注意，新增版本计划时，版本号应从第2位增加</strong></p>
<p>MajorVersion--当功能有较大的变动，导致无法兼容，比如升级U3D2023，大的重构等
MinorVerion---新增功能
BugFix--------修复BUG而出的版本</p>
<h3>1.2 依赖引擎组件版本</h3>
<p>目前物件播放器依赖的组件参见下面的列表，依赖组件的版本号和按照之前方式和习惯增加</p>
<table>
<thead>
<tr>
<th>组件编码</th>
<th>当前版本号</th>
</tr>
</thead>
<tbody>
<tr>
<td>com.nd.vlab-baseinteraction-adapter</td>
<td>1.1.1-pre1</td>
</tr>
<tr>
<td>com.nd.vlab-baseinteraction</td>
<td>1.1.1-pre2</td>
</tr>
<tr>
<td>com.nd.vlab-interactability</td>
<td>3.6.10-pre1</td>
</tr>
<tr>
<td>com.nd.vlab-interact</td>
<td>2.9.9-pre1</td>
</tr>
<tr>
<td>com.nd.vlab-interactabilityinterface</td>
<td>1.0.1-pre1</td>
</tr>
<tr>
<td>com.nd.vlab-vrhands</td>
<td>0.2.2-pre3</td>
</tr>
<tr>
<td>com.nd.vlab.engine.chemistry</td>
<td>1.25.12-pre1</td>
</tr>
<tr>
<td>com.nd.vlab.engine.physics</td>
<td>3.0.7-pre1</td>
</tr>
<tr>
<td>com.nd.vlab.effect</td>
<td>3.2.27-URP-pre1</td>
</tr>
<tr>
<td>com.nd.vlab.generalability</td>
<td>3.13.90-pre2</td>
</tr>
<tr>
<td>com.nd.vlab.engine.binding</td>
<td>0.2.3-pre1</td>
</tr>
</tbody>
</table>
<h3>1.3 依赖组件版本更新</h3>
<p><strong>修改物件播放器工程目录下的package.json文件</strong>
<img src="https://www.showdoc.com.cn/server/api/attachment/visitFile?sign=62431e84aff7733ca8553c460c453da0&amp;file=file.png" alt="" /></p>
<h3>1.4 关于未来器材的版本依赖</h3>
<p><strong>在接入物件播放器之前，影响播放器外壳能检索到器材版本的是器材Meta文件中MinPlayerVersion和MinEngineVersion这两个字段。
接入物件播放器后，MinPlayerVersion这个字段就不在需要了，未来的播放器外壳会把PlayerVersion固定在最后一个版本不在变更。只对EngineVersion进行变更</strong></p>
<p><img src="https://www.showdoc.com.cn/server/api/attachment/visitFile?sign=597580156b4ac79bb11420f82d4d239d&amp;file=file.png" alt="" /></p>
<h2>2 组件代码仓库管理和发包规范</h2>
<h3>2.1 组件仓库</h3>
<p><strong>SDP地址 [SDP](<a href="https://d.101.com/modules/componentDll/detail.html?appId=652dfad729d65d021d015d30">https://d.101.com/modules/componentDll/detail.html?appId=652dfad729d65d021d015d30</a> "SDP")</strong>
复制gerrit地址后下载到本地，如果没有权限请联系七佛</p>
<h3>2.2 分支使用</h3>
<ol>
<li>develop分支用于出开发版本或预览版</li>
<li>特性分支必须在feature目录下，比如feature/1.2.3-f-SupportRtl</li>
</ol>
<h3>2.3 开发环境说明</h3>
<p><strong>详细说明点击下面链接地址</strong>
[开放环境说明地址](<a href="https://www.showdoc.com.cn/eleeditor/10667153791499298">https://www.showdoc.com.cn/eleeditor/10667153791499298</a> "开放环境说明地址")</p>
<h3>2.4 构建和发布-[高]</h3>
<p><strong>必须从SDP构建和发布UPM包,目前物件播放器已经UPM改造完成，只需要在管理平台进行点击构建。</strong></p>
<p>[入口地址](<a href="https://vlab-mes-web.sdp.101.com/">https://vlab-mes-web.sdp.101.com/</a>#/ "入口地址")</p>
<p><img src="https://www.showdoc.com.cn/server/api/attachment/visitFile?sign=6518f5c7686acdb23879182aa05a4f97&amp;file=file.png" alt="" /></p>
<pre><code>选择生产线：未来实验室基础组件研发
开发负责人：选择自己，注意这里选谁，单据就会下单到谁
是否需要测试：这里选择否
然后填上其余必要信息</code></pre>
<p><img src="https://www.showdoc.com.cn/server/api/attachment/visitFile?sign=40489f3c557584cad69c7c1ad04f2df5&amp;file=file.png" alt="" /></p>
<p>提交后就可以下单到负责人，下单后的构建单据如下图所示：</p>
<p><img src="https://www.showdoc.com.cn/server/api/attachment/visitFile?sign=7c0f229fe972c7c21dd45484737477f2&amp;file=file.png" alt="" /></p>
<p><strong>点击构建即可开始构建UPM包</strong></p>
<h3>2.5 构建结果确认</h3>
<p>待构建成功后，可以到这个地址查看UPM包是否存在，如果存在就可以在Unity的PackageManager中看到对应的包
<a href="http://nexus.sdp.nd/repository/unity-upm/">http://nexus.sdp.nd/repository/unity-upm/</a></p>
<p><img src="https://www.showdoc.com.cn/server/api/attachment/visitFile?sign=0ca3ddb1f67ffc08e370976ffa1bf833&amp;file=file.png" alt="" /></p>
<h2>3、物件播放器包导入</h2>
<h3>3.1设置UPM URL</h3>
<pre><code>1.菜单点击window
2.找到package manager选项打开
3.点击package manager上方的齿轮图标
4.设置完成后点击Apply</code></pre>
<pre><code>&quot;name&quot;: &quot;SDP&quot;,
&quot;url&quot;: &quot;http://nexus.sdp.nd/repository/unity-upm&quot;,
&quot;scopes&quot;: [&quot;com.nd&quot;]</code></pre>
<p><img src="https://www.showdoc.com.cn/server/api/attachment/visitFile?sign=5ae6d03b43db899f911a50c50cf929ee&amp;file=file.png" alt="" /></p>
<h3>3.2 通过unity菜单导入</h3>
<pre><code>1.菜单栏点击window，找到Package Manager
2.点击＋号按钮，选择Add package by name
3.输入com.nd.vlab-equipmentplayer，点击Add按钮
4.会默认下载一个版本，下载成功后，点击See other version展开，选中版本，点击窗口右下处的Update to xxxxx</code></pre>
<p>图1
<img src="https://www.showdoc.com.cn/server/api/attachment/visitFile?sign=31096b8d9ddf050ec91e3b80384236c2&amp;file=file.png" alt="" />
图2
<img src="https://www.showdoc.com.cn/server/api/attachment/visitFile?sign=e8a5be344f97cdaa497e0b66c1f3967d&amp;file=file.png" alt="" />
图3
<img src="https://www.showdoc.com.cn/server/api/attachment/visitFile?sign=b13dea7dc2b5c2b2421cad139d572318&amp;file=file.png" alt="" /></p>
<h3>3.3 通过修改配置文件导入</h3>
<p><img src="https://www.showdoc.com.cn/server/api/attachment/visitFile?sign=2419fd26426973980159d89a49c73116&amp;file=file.png" alt="" /></p>
<pre><code>manifest中
&quot;dependencies&quot;字段下添加
&quot;com.nd.vlab-equipmentplayer&quot;: &quot;0.0.9-pre0&quot;</code></pre>
<pre><code>packages-lock中
&quot;dependencies&quot;字段下添加
&quot;com.nd.vlab-equipmentplayer&quot;: {
&quot;version&quot;: &quot;0.0.9-pre0&quot;,
&quot;depth&quot;: 0,
&quot;source&quot;: &quot;registry&quot;,
&quot;dependencies&quot;: {},
&quot;url&quot;: &quot;http://nexus.sdp.nd/repository/unity-upm&quot;
}</code></pre>