本文介绍如何获取BWAF开发包。

背景信息

BizWorks应用框架(BizWorks Application Framework)发布在BizWorks产品提供的私有仓库中,您需要在应用Maven工程settings.xml中进行配置来获取。

BizWorks Managed Application的Maven工程,存在以下三类Maven仓库:1
  • 公共仓库:获取公网发布的三方包(如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开发包的发布仓库进行了迁移。

操作步骤

  1. 增加指向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>
  2. 增加指向BWAF仓库的Server配置。
    代码示例如下:
    
        <servers>
                    <!-- 保持其他既有 servers ... 增加: -->
            <server>
                <id>bizworks-repo-release</id>
                <username>630c5cc22b16b2e74182afd2</username>
                <password>5fOu8lBhzz6m</password>
            </server>
        </servers>
  3. 修改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