本文介紹如何獲取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