功能入口:API管理应用 / 选中某个项目 / 项目管理菜单 / 项目版本管理
项目版本管理功能模块提供对项目级别的版本管理,可新增、删除、对比项目级版本。在创建项目版本号的时候会对整个项目的部分模块数据进行快照保存。可用于每次迭代发布打全局版本号,可以进行项目对比以便于后续查看每次迭代产生变更的差异,我们也可以在API的历史记录查看每次迭代该API有没有产生变化,产生变化的内容,甚至我们可以把已经打了版本号的旧项目版本进行恢复,恢复不会覆盖当前项目版本任何内容,恢复是把旧项目版本的内容复制为一个全新的项目。
创建项目版本号
版本号:是项目唯一的
备注:我们可以填写一些我们需要强调该版本内容的信息,或提示类的,方便大家看到该版本号可以迅速记起一些相关内容,也便于让后续的其他工作人员对每个版本的差异性有一个大概的了解
复制为新项目
复制为新项目不会覆盖当前项目数据,他是一个数据独立隔离概念,把一个历史版本数据复制为一个全新的项目,跟当前项目互不影响,是一个独立的项目
-
进入API项目-其他-版本管理,可以看到当前项目版本列表
-
我们可以对某一个历史版本进行一个复制操作
-
点击某个版本号操作栏下方的复制为新项目选项,确定
导出
导出版本项目跟导出项目是相同的概念,对一个项目的数据进行打包导出为一个文件
不同的是版本项目导出让你可以选择某一个历史版本的数据进行导出
-
进入API项目,其他,版本管理,我们可以看到当前项目的所有版本号
-
选择某个版本号操作栏下的导出
-
选择数据类型,确定
版本API文档对比
在项目-其他-版本管理当中可以对已有的版本API文档进行对比,查看不同版本迭代中的差异性,支持跨项目对比和当前项目对比
当前项目版本号对比
-
进入项目,其他,版本管理,选择版本API文档对比选项
-
我们可以选择当前项目不同版本号进行对比,对比俩个版本API的差异化
原版本选项为旧版,对比版本选项为新版本。
进行对比,会得到对比版本较原版本,新增、删除、修改的内容都会展示出来
跨项目版本号对比
在当前项目-其他-版本管理-版本API文档对比当中我们可以选择跨项目进行对比
如:我们把v5版本复制为一个新的项目,我们可以在当前项目(v6版本)跟他进行一个对比
编辑版本
-
进入API项目,左侧最下方tab栏,其他-版本管理
-
选择编辑,可以对版本的备注信息进行一个编辑
删除版本
删除项目版本,会同步删除API历史记录中被删除掉的版本号记录,但API不会被删除
-
进入API项目,左侧最下方tab栏,其他-版本管理
-
选择删除,可以对某个版本记录进行一个删除