播放组件发包规范

播放组件发包规范

播放组件Nuget包(Nd.VLab.Player)包括与实验播放相关的所有组件、资源和配置文件。具体包括:

  • Nd.VLab.PlayerCore
  • Nd.VLab.PlayerCoreAC
  • Nd.VLab.PlayerCoreUI
  • Nd.VLab.LabModel
  • Nd.VLab.LabDataConvert
  • Nd.VLab.LabFramework
  • Nd.VLab.ResourceCenter
  • Nd.VLab.NDR2.0
  • VLabDownload
  • VLabInterface
  • Nd.VLab.LabStepComponent
  • IonicZipManager
  • Nd.VLab.Zip
  • Nd.VLab.ASEFramework
  • Nd.VLab.ASETool
  • Nd.VLab.Autofac
  • Nd.VLab.NLua
  • Nd.VLab.Interact
  • Nd.VLab.Interact.AC
  • Nd.VLab.MultiLanguage
  • Nd.VLab.IniAnalyze
  • Nd.VLab.LitJson
  • Nd.VLab.NewtonsoftJson
  • Nd.VLab.Localization
  • Nd.VLab.CSharpSQLite
  • Nd.VLab.DOTween
  • Nd.VLab.HighlightingSystem
  • Nd.VLab.MonoWebUtil
  • Nd.VLab.NDBase
  • Nd.VLab.NdGui
  • Nd.VLab.CommandParse
  • Nd.VLab.OpenLabFile
  • Nd.VLab.QuickGraph
  • Nd.VLab.UHyperText
播放组件发包流程
  • 子组件已发布版本(新特性/重大缺陷修复),通知实验播放组件开发同学。
  • 进入vlab-nugetimport仓库,并拉取到最新。
  • 打开ND.VLab.Player.sln解决方案,在Nuget管理器中更新所有子组件Nuget包。
  • 编译一下工程,以执行后处理脚本命令(Post-build event command),方便将Nuget packages拷贝到正确位置,并修改Nd.VLab.Player.nuspec文件。
  • 打开Nd.VLab.Player.nuspec文件,修改版本包版本号和编写组件更新记录。
  • 执行”Nuget打包.bat”。
  • 执行”Nuget上传.bat”。
  • 接口变化需要编写更新记录(https://www.showdoc.cc/VLab?page_id=4516904948748047)。
  • 通知应用开发负责人(创编编辑器、3D播放器、VR播放器),可通过下知照单的方式。
播放组件发包注意事项
  • 版本号发布仓库-vlab-nugetimport(git@git.sdp.nd:vlab-projects/vlab-nugetimport.git)
  • 仓库master分支用于正式版包发布,develop分支用于preview版本包发布。
  • 版本号采用三位数字的形式:主版本号.次版本号.修订号。
  • preview版本号定义示例:1.0.1-preview,preview版本包包含子组件的预览版。
  • 如遇不可兼容升级发布,建议升级主版本号。
  • 较重要的新特性发布,建议升级次版本号。
  • 其它版本发布则升级修订号即可。
  • 如遇增加或删除子组件时,则需要修改后处理脚本(./ND.VLab.Player/BuildTools/.CopyTargetFileToPlayer.py)。
子组件发包流程

仅适用于Nd.VLab.PlayerCore、Nd.VLab.PlayerCoreAC、Nd.VLab.PlayerCoreUI、Nd.VLab.LabModel、Nd.VLab.LabDataConvert、Nd.VLab.ResourceCenter、Nd.VLab.NDR2.0子组件。其它组件可能有自定义发布流程,在此不做描述。

  • Gerrit上review该组件仓库的最新代码提交。
  • 进入子组件仓库拉取最新代码,并切到对应分支,正式版(master分支),preview版本(待发布的特性分支)。
  • master分支不做功能开发,需要合并稳定版本分支(develop)的提交。
  • 打开子组件的解决方案文件,修改所有工程的程序集文件版本号(AssemblyInfo.cs:AssemblyFileVersion),如:1.0.0.0610,其中0610代表6月10日(当前日期)。
  • 尝试编译解决方案和解决编译问题。
  • 将编译后的程序集集成到应用测试工程或单元测试工程进行基本功能、最近修改功能走查。
  • 检查子组件依赖的资源、配置文件是否正确。
  • 打开xx.xx.xx.nuspec文件,修改版本包版本号和编写组件更新记录。
  • 执行”Nuget打包.bat”。
  • 执行”Nuget上传.bat”。
  • 通知播放组件Nuget包(Nd.VLab.Player)发布负责人。
子组件发包注意事项
  • 版本号采用三位数字的形式:主版本号.次版本号.修订号。
  • 如遇不可兼容升级发布,建议升级主版本号。
  • 较重要的新特性发布,建议升级次版本号。
  • 其它版本发布则升级修订号即可。
  • 增加程序集、资源、配置文件需要修改nuspec文件。
  • Nd.VLab.PlayerCore、Nd.VLab.PlayerCoreAC的版本号需要保持同步以方便问题定位,即任意子组件升级,另一组件也跟随一起升级。
  • Nd.VLab.PlayerCoreUI版本包将界面assetbundle资源也包含。

更新记录

2020/06/10 v1.0.0[刘剑(281001)]