eXist-db 5.3.0新建web应用与4.3.1旧应用迁移问题咨询

一、新建应用操作（基于generator-exist） #

eXist-db 5.x版本正式移除了eXide内置的「Application/New Application」按钮，官方推荐使用yeoman生态的generator-exist工具完成应用创建、部署全流程，操作步骤如下：

• 步骤1：安装前置依赖
  首先在本地环境安装14.0及以上版本的Node.js，安装完成后自动附带npm包管理器。
• 步骤2：安装工具链
  运行如下命令全局安装yeoman和generator-exist：
  npm install -g yo generator-exist
• 步骤3：初始化应用项目
  新建一个空文件夹作为应用的本地源码目录，进入该目录后运行：
  yo exist
  按照交互提示依次填写应用ID、应用名称、版本号、作者信息，以及你搭建的5.3.0实例的连接配置（实例地址、端口、管理员账号、密码）即可完成项目初始化。
• 步骤4：部署到数据库
  初始化完成的项目内置了部署脚本，直接运行如下命令即可将应用自动打包并上传部署到你的5.3.0实例中：
  npm run deploy
  部署完成后刷新eXist-db的dashboard页面即可看到新建的应用。日常开发时可以运行npm run watch，工具会自动监听本地文件变更，增量同步到数据库，无需手动重复执行部署命令。

二、4.3.1版本应用迁移到5.3.0全新实例操作 #

你采用全新实例部署的方式可以避免很多原地升级带来的兼容问题，迁移按如下步骤操作即可：

• 步骤1：导出旧版本应用包
  登录4.3.1版本的eXist-db dashboard，进入包管理器页面，找到需要迁移的应用，点击「导出」按钮，即可得到后缀为.xar的应用安装包。如果应用关联了/db/apps路径之外的业务数据，可以通过eXide的导出功能，将对应数据集合导出为XML或ZIP格式的备份文件。
• 步骤2：兼容性校验调整
  打开导出的.xar包（可以直接用压缩软件解压），找到根目录下的expath-package.xml配置文件，将其中eXist-db核心依赖的版本限制调整为适配5.x版本，避免安装时出现依赖不匹配报错。如果你的应用用到了旧版本的废弃函数，需要同步修改为5.3.0支持的对应函数。
• 步骤3：安装到新实例
  登录5.3.0版本的dashboard，进入包管理器页面，点击「上传」按钮选择调整好的.xar包，等待安装完成即可。如果安装过程提示依赖缺失，可以先在包管理器的公共仓库中安装对应依赖包后再重新安装你的应用。
• 步骤4：迁移业务数据
  如果之前导出了独立的业务数据备份，可以通过5.3.0版本的eXide导入功能，将备份数据导入到对应的数据库路径下，导入完成后校验数据完整性和权限配置，确保应用可以正常读写数据。

内容的提问来源于stack exchange，提问作者Roman