HOS基础开发平台

# 从 2.1.2 升级到 2.2.0

# 更新时间

2023 年 05 月 12 日

# 更新内容

  1. 修复若干 bug
  2. 优化部分用户体验
  3. 数据字典支持树形结构
  4. 新增业务参数维护
  5. 数据权限支持功能组件、公共权限维护
  6. 页面预置支持公共元素配置
  7. 新增登录后弹窗配置详情参考弹框页配置
  8. 应用名称可配置可扩展详情参考产品名称扩展
  9. 新增节假日功能,详情参考节假日管理
  10. 新增登录页面功能,详情参考登录界面配置
  11. 新增 main.js 中自定义逻辑的入口(biz/bizMain.js)
  12. 增加全局混入(biz/mixins/globalMixin.js)，支持页面初始化自定义逻辑扩展
  13. 增加登录页混入(biz/mixins/loginMixin.js)，支持对登录成功后进行扩展
  14. 增加登出工具类(biz/utils/biz-user-store-util.js)，支持登出时自定义逻辑扩展
  15. 新增业务配置文件(biz/config.js)，可自定义免登录白名单路由
  16. 新增【请求参数序列化】配置
  17. 新增生产环境打包成带版本号的 zip 格式文件（hos-app-web-2.1.2.20230518.zip）
  18. 新增导航栏动态组件入口，支持导航栏加载自定义组件扩展
  19. 优化切换岗位后跳转首页，避免因权限问题导致的 404

# 前端升级步骤

  1. 请到 hos-app-web (opens new window) 代码仓库中master分支或release-2.2.0分支中将源码下载到本地

  2. 如果自己业务工程中 src/sys的代码没有进行过手动修改的话，将该代码进行手动删除，然后将hos-app-web 中src/sys 的代码复制到本地工程即可。

  3. 如果自己业务工程中 src/sys的代码进行过手动修改的话，请自行与hos-app-web 中src/sys 的代码进行比对，手动进行同步并解决冲突代码。

  4. 若项目中未对以下文件进行修改,可直接替换;若有修改,进行对比解决冲突。

    • App.vue 新增mixins选项，支持全局的混入逻辑；
    • main.js 新增 bizMainUtils 方法，可以在src/biz 下的 bizMain.js 中编写插件或者对 Vue 实例进行扩展；
    • permission.js 对路由守卫进行了优化；
    • .env.development 配置,详情请参考 env 配置文件
      • 增加 VUE_APP_GLOBAL_PARAMS_STRINGIFY 配置：全局对入参做序列化处理
    • package.json 安装依赖：升级 hosui：1.1.14

  5. 业务工程中 src/biz 目录下新增以下文件，需要手动复制到hos-app-web 中src/biz 目录下：

    • 新增 mixins 目录；

      • globalMixin.js 用于全局的混入；
      • loginMixin.js 用于登录逻辑的混入；

    • 新增 bizMain.js 文件，可编写插件或者对 Vue 实例进行扩展，是main.js中bizMainUtils 方法的入口；

    • 新增 config.js 文件，定义业务配置；

    • 新增 biz/utils/biz-user-store-util.js 文件，用于扩展登出时业务逻辑；

      img.png

# 后端升级步骤

# 修改 pom 依赖

  1. 在根 pom 文件中修改hos-app-dependencies的版本号为2.2.0-RELEASE
  2. 在根 pom 文件中修改hos-starter-dependencies的版本号为1.0.17-RELEASE
    <dependencyManagement>
    <dependencies>
        <dependency>
            <groupId>com.mediway.hos</groupId>
            <artifactId>hos-starter-dependencies</artifactId>
            <version>1.0.17-RELEASE</version>
            <type>pom</type>
            <scope>import</scope>
        </dependency>
        <dependency>
            <groupId>com.mediway.hos</groupId>
            <artifactId>hos-app-dependencies</artifactId>
            <version>2.2.0-RELEASE</version>
            <type>pom</type>
            <scope>import</scope>
        </dependency>
    </dependencies>
</dependencyManagement>

# 升级数据库

  1. 前往 Gitlab 下载页面（http://119.255.194.80/hos/demo/hos-app-demo/-/tree/2.2.0/project-strcutre/project-strcutre-boot-1/oa-doc/data/mysql/2.2.0） , 用户名/密码：hosuser/99ahivPJt
  2. 下载hos-app-base-2.1.2~2.2.0.sql文件
  3. 执行更新 SQLhos-app-base-2.1.2~2.2.0.sql img.png

← 从2.1.1升级到2.1.2 →