一、如何发布

1.1 简介

发布是将开发完成的版本部署到线上的操作，包含训练和部署的过程：训练会生成DUI内核资源及产品配置资源，供开发者进行真机测试或批量装机；部署则将数据应用到分支，客户端根据分支号获取版本更新服务。

分支： 分支代表运行环境，多个版本可以在不同环境并行运行。
分支号： 分支号用于指定不同的运行环境及设备组，是设备获取对应更新资源的唯一识别编号；在分支管理页面可以看到。




分支名称： 分支名称是对分支号的补充描述，在产品的发布列表页可以看到。

1.2 版本发布

第一步 在完成开发页面，您可以点击【立即发布】按钮进入发布流程；




或者在开发版本列表点击【发布】按钮，进入发布流程；




也可以在版本详情中点击【立即发布】，进入发布流程。




第二步 填写发布所需的信息，包括版本号，版本分支以及版本说明（非必填）。完成后，点击“下一步”，进入版本信息确认页面。




建议：

1）版本号大于之前的版本号；

2）版本号位数保持一致；

3）版本说明应充分写明该版本的核心内容及关键变更；

4）建议先将版本部署至测试分支，经充分的真机测试/内部测试后再切换分支到正式环境。

 

第三步 在此页面，您可以在提交发布前再一次浏览当前待发布版本的所有配置信息，确认无误后点击【确认并提交】按钮。随后版本进入发布中的状态，系统自动触发训练与部署。

第四步 提交发布后，会自动返回发布版本列表页。鉴于产品版本发布需要对产品资源和技能进行训练，需要花费一定的时间，您可在发布列表页通过发布进度条了解当前发布进度。

如果受到网络影响导致发布时间过长，超出DUI服务限制，发布状态会变成【发布超时】，在该状态下，您可以选择取消发布，重新开发版本。

 

二、发布版本管理

2.1 简介

您可以管理已发布的版本：通过对版本号以及分支的管理，实现对客户端版本的管理。

版本和分支关系如下：
1）产品的语音交互系统发布时，会将版本数据部署到分支，客户端根据分支号获取版本更新服务；
2）原分支上若有版本，发布时会被新发布的版本替换掉；
3）一个分支只能填充一个已发布的版本，但一个已发布的版本可以应用到多个分支上；
4）客户端测试时，只能选择更新到分支上最新的版本；
5）客户端暂不支持更新到指定的历史版本，因此，请尽量遵循新版本优于旧版本的原则进行此操作。

2.2 版本管理

如下图，您可以在发布管理页面对已发布的版本进行管理。




第一步 点击【选择分支】，您可以根据需要将此版本应用到其它分支。即该版本可以同时在多个分支上运行。




第二步 版本已经应用到分支后，就可以点击发布版本列表上【下载】按钮，跳转对应版本的下载页。您可以手动将资源包安装到设备端；也可以在设备端自动下载安装某分支上最新版本的资源包。

2.3 分支管理

平台提供对分支号进行增、删、改、查操作。
在产品详情页面，点击左侧的【发布管理】，进入发布版本列表，点击右上角【分支管理】，进入分支管理页面，可以看到产品下的所有分支，并且对分支进行管理。

2.3.1 新建分支

开发者可以在系统默认正式分支和测试分支的基础上，根据需要自行创建分支：
第一步 点击右上角新建分支按钮。


第二步 在出现的弹窗中，填写分支名称和分支号。保存后完成分支的新建。

2.3.2 选择版本

在分支管理页面，可以选择将已发布的版本应用到分支上。 点击右侧【选择版本】按钮，出现选择版本的弹窗。

1）选择的版本将替换原来分支上的版本。

2）选择范围只包括已发布的版本。

2.4 复制与删除

DUI全链路语音交互对话平台也支持常用的管理功能。版本详情页面点击右上角【更多操作】，可对该版本进行【复制】或【删除】操作。

复制规则

控制台上可以选择复制版本，复制成新版本或者另存为新产品，复制需要遵循如下规则：

1）复制生成的新版本或者新产品需要输入名称，且名称不可与已有的版本或产品重复；

2）复制操作需要有开发产品版本的操作权限。

 

删除规则
控制台上允许删除创建的语音交互版本，删除需遵循如下规则：
1）项目组管理员可以删除本项目组下版本，包括已发布和未发布的；
2）项目组成员、外部协作者和分配了删除权限的开发者，只能删除自己创建的、不在分支上的版本。


删除分支上的版本
在产品详情页，查看要删除的版本是否在分支上：
1）版本V1.1.1不在分支上，可以直接删除；
2）版本V1.1.2在正式分支上，无法直接删除，需要联系项目组管理员进行删除操作。



注意：未发布的版本不会被应用到分支。

三、下载与测试

3.1 版本资源下载

版本发布成功后，您可以将资源包集成到SDK。

注意：嵌入式操作系统无产品资源包下载。

Android SDK集成
iOS SDK集成
嵌入式 SDK集成

3.2 移动端体验

平台提供Android和iOS系统下产品版本的移动端体验。您可以下载DUI DEV APP，在移动端设备上进行产品对话效果的测试。
注意：版本只有发布后，才能进行移动端体验。


第一步 在产品详情页，点击左侧的“发布管理”，进入发布版本列表页。




第二步 点击版本列表的某一行，或者点击右侧按钮“查看”，可以进入对应版本的版本详情页。




第三步 在版本详情页，点击右上角“移动端体验”按钮，在打开的弹窗中下载DUI DEV APP，使用APP扫码体验。




第四步 安装好APP后，使用APP扫描产品资源二维码；资源下载成功后，就可以在移动端体验该产品功能。

3.3 真机测试

如需测试设备相关功能效果，您可以将资源包手动下载安装到离线的设备，或通过SDK联网下载资源包。