本文介绍如何获取BWAF开发包。
背景信息
BizWorks应用框架(BizWorks Application Framework)发布在BizWorks产品提供的私有仓库中,您需要在应用Maven工程settings.xml
中进行配置来获取。
BizWorks Managed Application的Maven工程,存在以下三类Maven仓库:
公共仓库:获取公网发布的三方包(如Spring等)。如果是专有云环境,可以提供开放特定公网出口或代理的方式访问功能。如果是公有云环境,阿里云提供加速代理功能。
应用私有仓库:当前应用本身
mvn deploy
的目标仓库。通常用于放置应用发布的二方包。BizWorks私有仓库:BWAF是BizWorks产品提供的三方包,目前并没有推到公网,所以需要一个专门的BizWorks私有仓库用于发布BWAF,您可以从这个仓库拉取三方包。
前提条件
BizWorks产品提供的脚手架生成功能生成的Maven工程,自带配置好的settings.xml
不需要额外配置。
下面两种情况,您需要手工配置settings.xml
以获取BWAF开发包:
您使用的不是BizWorks产品生成的脚手架Maven工程。
您使用的是1.11.0之前版本BizWorks产品生成的脚手架Maven工程,需要升级BWAF到1.11.0及以上版本。
说明从1.11.0版本开始,BizWorks对BWAF开发包的发布仓库进行了迁移。
操作步骤
增加指向BWAF仓库的Profile配置。
代码示例如下:
<profiles> <!-- 保持其他既有 profiles ... 增加: --> <profile> <id>bizworks-profile</id> <repositories> <repository> <id>bizworks-repo-release</id> <url>https://packages.aliyun.com/maven/repository/2270952-release-TB0Rsb/</url> <releases> <enabled>true</enabled> <updatePolicy>never</updatePolicy> </releases> <snapshots> <enabled>false</enabled> </snapshots> </repository> </repositories> <pluginRepositories> <pluginRepository> <id>bizworks-repo-release</id> <url>https://packages.aliyun.com/maven/repository/2270952-release-TB0Rsb/</url> <releases> <enabled>true</enabled> <updatePolicy>never</updatePolicy> </releases> <snapshots> <enabled>false</enabled> </snapshots> </pluginRepository> </pluginRepositories> </profile> </profiles>
<activeProfiles> <!-- 保持其他既有 activeProfiles ... 增加: --> <activeProfile>bizworks-profile</activeProfile> </activeProfiles>
增加指向BWAF仓库的Server配置。
代码示例如下:
<servers> <!-- 保持其他既有 servers ... 增加: --> <server> <id>bizworks-repo-release</id> <username>630c5cc22b16b2e74182afd2</username> <password>5fOu8lBhzz6m</password> </server> </servers>
修改
mirror
配置。如果有以下
mirrorOf *
并指向http://bw-nexus.console.bizworks.cn/repository/maven-public/的配置,请删除。<mirrors> <mirror> <id>maven-public</id> <mirrorOf>*</mirrorOf> <name>maven-public</name> <url>http://bw-nexus.console.bizworks.cn/repository/maven-public/</url> </mirror> </mirrors>
增加以下推荐的
mirror
配置,或其他任何可以访问公网Maven仓库的方式。<mirrors> <mirror> <id>basic-mirror</id> <mirrorOf>central,jcenter,!release,!snapshots</mirrorOf> <name>mirror</name> <url>https://maven.aliyun.com/nexus/content/groups/public</url> </mirror> </mirrors>
本地验证
完成上述配置后,您可以在本地运行以下Maven构建命令,验证配置是否正确。
mvn clean package -DskipTests -s settings.xml -X -Dmaven.repo.local=./repository