多平台器材资源后台自动打包指南

前言

目前虚拟实验室中器材的开发已经不只局限于PC平台,现在还有安卓pad平台器材版本的适配开发工作,未来还会有IOS平台的播放器需要适配。目前的开发流程是在PC环境下做开发,开发完成后再导出器材资源到安卓环境进行器材打包,由于项目工程庞大,每次切换工程环境都要消耗非常多的时间,导致人力浪费。为了解决多平台切换打包导致的开发时间增加的问题因此基于jenkins开发实现了后台自动化打包工具。

实现原理

该工具基于Jenkins持续集成工具开发而来。后台自动打包的流程图大致如下:

使用方式

服务器地址

http://192.168.112.163:8080

目前服务器部署在个人的电脑上,后续可能会迁移到专门的电脑进行,请关注该页面对应的服务器地址

使用流程(以打包pc平台资源包为例)

  1. 修改器材模型的Meta.json,并推送到develop

  2. 在浏览器中输入上面的服务器地址打开jenkins服务器,登录你的账号,第一次登录需要自行注册一个账号

  3. 登录之后,点击MyViews按钮就可以看到你所能看到的所有项目

  4. 器材资源自动构建的项目是EquipRes,点击进入就能看到目前正在执行的任务

  5. 可以选择对应的构建任务查看构建信息和日志

  6. 构建成功会显示蓝色的圆,失败显示为红色,如果发现构建失败可以使用BuildElement方式(下面会讲到)手动进行构建,还是失败的话请联系唐绍军(635438)处理。

  7. 成功构建后,器材资源包会出现在工作空间中对应的器材编码的文件夹下,不同平台放在不同的平台文件夹中,从这里点击对应的资源即可下载到本地。

  8. 这里可以看到已经成功生成了集气瓶的器材包

器材构建方式

目前支持两种构建方式:

1.BuildCommit

由jenkins服务器监听gitlab通知,当发生推送事件时执行自动构建
构建执行的条件是:

  • 推送了修改到指定的分支,不同的分支推送会构建不同平台的器材资源包,目前包括以下两个分支
分支 对应构建平台
develop PC平台
forArt/Android 安卓平台
  • 推送的修改中包含器材模型资源的版本信息文件Meta.json,后台会根据这个文件自动构建对应的器材资源包。
2.BuildElement

由开发同学自行设置执行的构建方式,通过指定要构建的器材编码和对应的平台,直接构建对应的器材资源包,但自动构建由于未知原因失败时,或者你想要构建服务器搭建之前的器材时,这个方式将会是很有用的。使用步骤如下:

  1. 在jenkins中打开EquipRes的job界面
  2. 点击Build With Parameters,选择BuildElement构建方式并输入对应参数

    3.最后点击开始构建,进行器材打包