# 资产套件版本后端高开定制开发与部署指南

# 一、文档说明

本文档旨在为开发者提供资产套件版本后端高开定制的完整流程指导，包括从示例项目获取、开发环境配置，到定制化开发、项目打包及部署的全流程操作说明，助力开发者高效完成资产后端的定制开发工作。

# 二、下载示例项目

# （一）目的

获取初始代码框架，为后续的自定义开发提供基础支撑，减少从零搭建项目的工作量。

# （二）操作步骤

点击下方链接下载项目压缩包：下载示例项目

# （三）项目结构说明

本项目为标准的 eos 项目，不包含具体业务代码，所有依赖均通过 pom 文件进行引入，便于开发者在此基础上进行定制化开发。

# 三、导入项目到开发工具

# （一）目的

在本地开发环境中正确配置项目，确保项目能够正常加载和运行，为后续开发工作做好准备。

# （二）操作步骤

安装项目所需的开发工具（如 IntelliJ IDEA 等）以及相关依赖。
打开安装好的 IDE，通过“打开项目”功能选择下载的项目文件夹，将项目导入到 IDE 中。
下载 EOS_Platform_8.3.3_Private_Medium_Develop.zip,使用此介质中的 repository 作为 maven 仓库文件夹

导入 Maven 项目：在 IDE 中找到 Maven 面板，点击“刷新”按钮，让 IDE 自动识别并导入项目的 Maven 依赖。同时，需要修改 Maven 的 settings.xml 文件，以保证项目依赖能够正确下载，避免出现报错。

相关配置参考如下（需将部分远程仓库没有的依赖 jar 单独手动放置到仓库目录下）：下载依赖 jar

<?xml version="1.0" encoding="UTF-8"?>
<settings xmlns="http://maven.apache.org/SETTINGS/1.0.0"
          xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
          xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.0.0 http://maven.apache.org/xsd/settings-1.0.0.xsd">
    <mirrors>
        <mirror>
            <id>mirror</id>
            <mirrorOf>central,jcenter,!aliyun-rdc-releases,!aliyun-rdc-snapshots</mirrorOf>
            <name>mirror</name>
            <url>https://maven.aliyun.com/nexus/content/groups/public</url>
        </mirror>
    </mirrors>
    <profiles>
        <profile>
            <id>primeton</id>
            <repositories>
                <repository>
                    <id>central</id>
                    <url>https://maven.aliyun.com/nexus/content/groups/public</url>
                    <releases>
                        <enabled>true</enabled>
                    </releases>
                    <snapshots>
                        <enabled>false</enabled>
                    </snapshots>
                </repository>
                <repository>
                    <id>snapshots</id>
                    <url>https://maven.aliyun.com/nexus/content/groups/public</url>
                    <releases>
                        <enabled>false</enabled>
                    </releases>
                    <snapshots>
                        <enabled>true</enabled>
                    </snapshots>
                </repository>
                <repository>
                    <id>aliyun-rdc-releases</id>
                    <url>https://packages.aliyun.com/maven/repository/2208165-release-FizKV7/
                    </url>
                    <releases>
                        <enabled>true</enabled>
                    </releases>
                    <snapshots>
                        <enabled>false</enabled>
                    </snapshots>
                </repository>
                <repository>
                    <id>aliyun-rdc-snapshots</id>
                    <url>https://packages.aliyun.com/maven/repository/2208165-snapshot-deBt2F/
                    </url>
                    <releases>
                        <enabled>false</enabled>
                    </releases>
                    <snapshots>
                        <enabled>true</enabled>
                    </snapshots>
                </repository>
                <repository>
                    <id>pentaho-public</id>
                    <name>Pentaho Public</name>
                    <url>https://repo.orl.eng.hitachivantara.com/artifactory/pnt-mvn/</url>
                    <releases>
                        <enabled>true</enabled>
                        <updatePolicy>never</updatePolicy>
                    </releases>
                    <snapshots>
                        <enabled>true</enabled>
                        <updatePolicy>never</updatePolicy>
                    </snapshots>
                </repository>
            </repositories>
            <pluginRepositories>
                <pluginRepository>
                    <id>central</id>
                    <url>https://maven.aliyun.com/nexus/content/groups/public</url>
                    <releases>
                        <enabled>true</enabled>
                    </releases>
                    <snapshots>
                        <enabled>false</enabled>
                    </snapshots>
                </pluginRepository>
                <pluginRepository>
                    <id>snapshots</id>
                    <url>https://maven.aliyun.com/nexus/content/groups/public</url>
                    <releases>
                        <enabled>false</enabled>
                    </releases>
                    <snapshots>
                        <enabled>true</enabled>
                    </snapshots>
                </pluginRepository>
                <pluginRepository>
                    <id>aliyun-rdc-releases</id>
                    <url>https://packages.aliyun.com/maven/repository/2208165-release-FizKV7/
                    </url>
                    <releases>
                        <enabled>true</enabled>
                    </releases>
                    <snapshots>
                        <enabled>false</enabled>
                    </snapshots>
                </pluginRepository>
                <pluginRepository>
                    <id>aliyun-rdc-snapshots</id>
                    <url>https://packages.aliyun.com/maven/repository/2208165-snapshot-deBt2F/
                    </url>
                    <releases>
                        <enabled>false</enabled>
                    </releases>
                    <snapshots>
                        <enabled>true</enabled>
                    </snapshots>
                </pluginRepository>
            </pluginRepositories>
        </profile>
    </profiles>
    <activeProfiles>
        <activeProfile>primeton</activeProfile>
    </activeProfiles>
    <servers>
        <server>
            <id>aliyun-rdc-releases</id>
            <username>623db7e13c6b5273a0764cb4</username>
            <password>UP1dH-IITR[I</password>
        </server>
        <server>
            <id>aliyun-rdc-snapshots</id>
            <username>623db7e13c6b5273a0764cb4</username>
            <password>UP1dH-IITR[I</password>
        </server>
    </servers>
</settings>

# 四、项目开发

# （一）目的

基于示例项目框架，根据实际业务需求进行定制化代码开发，实现资产后端的个性化功能。

# （二）操作步骤

直接在已导入 IDE 的当前项目中，按照业务需求进行代码编写、功能实现等开发工作。

# 五、打包项目

# （一）目的

将开发完成的项目代码及相关资源文件进行打包，生成可在服务器上部署的文件。

# （二）操作步骤

执行 Maven 打包命令：在 IDE 的 Maven 面板中，找到“install”命令并执行，项目将自动进行编译、打包，生成可部署的 jar 文件。
部署替换：将生成的 com.primeton.data.dam.standalone.boot-7.5.0.jar 文件，替换服务器上相同名称的 jar 文件，然后重启应用，完成项目部署。

# 六、本地启动注意事项

# （一）修改 mybatis.mapper-locations 配置

找到项目中的 application-dqms.properties 文件。
将其中的 mybatis.mapper-locations 属性值修改为本地 mapper 文件夹的绝对路径。

mapper 文件夹可从 standalone 介质中获取，路径为{standalone_path}/server/damp/lib/mapper。

配置示例：

mybatis.mapper-locations=file:/Users/xxx/Downloads/mapper/**/*Mapper.xml
mybatis.mapper-locations=file:D:/xxx/mapper/**/*Mapper.xml

# （二）修改 public-resource.database.library.path 配置

打开 application-pubresmng.properties 文件。
将 public-resource.database.library.path 属性值修改为本地 pubresmng_ext_lib 文件夹的绝对路径。

pubresmng_ext_lib 文件夹可从 standalone 介质中获取，路径为{standalone_path}/server/pubresmng_ext_lib。

配置示例：

public-resource.database.library.path=/Users/xxx/Downloads/pubresmng_ext_lib
public-resource.database.library.path=D:/xxx/pubresmng_ext_lib

← 资产低开流程配置开发说明 EOS微服务应用部署到资产套件版指南 →