获取MRS应用开发样例工程

MRS样例工程构建流程

MRS样例工程构建流程包括三个主要步骤：

1. 下载样例工程的Maven工程源码和配置文件，请参见样例工程获取地址。
2. 配置华为镜像站中SDK的Maven镜像仓库，请参见配置华为开源镜像仓。
3. 根据用户自身需求，构建完整的Maven工程并进行编译开发。

样例工程获取地址

• MRS服务1.8.x版本的样例工程下载地址为：https://github.com/huaweicloud/huaweicloud-mrs-example/tree/mrs-1.8。
• MRS服务1.9.x版本的样例工程下载地址为：https://github.com/huaweicloud/huaweicloud-mrs-example/tree/mrs-1.9。
• MRS服务2.0.x版本和2.1.x版本的样例工程下载地址为：https://github.com/huaweicloud/huaweicloud-mrs-example/tree/mrs-2.0。
• MRS服务3.0.2版本的样例工程下载地址为：https://github.com/huaweicloud/huaweicloud-mrs-example/tree/mrs-3.0.2。
• MRS服务3.1.0版本的样例工程下载地址为：https://github.com/huaweicloud/huaweicloud-mrs-example/tree/mrs-3.1.0。
• MRS服务3.1.5版本的样例工程下载地址为：https://github.com/huaweicloud/huaweicloud-mrs-example/tree/mrs-3.1.5。

图1 样例代码下载

下载压缩包到本地后解压，即可获取各组件对应的样例代码工程。

MRS服务3.1.2-LTS版本获取样例工程请参考通过开源镜像站获取样例工程。

配置华为开源镜像仓

华为提供开源镜像站，各服务样例工程依赖的jar包都可在华为开源镜像站下载，剩余所依赖的开源jar包请直接从Maven中央库或者其他用户自定义的仓库地址下载。

本地环境使用开发工具下载依赖的jar包前，需要确认以下信息。

• 确认本地环境网络正常。

  打开浏览器访问：华为提供开源镜像站，查看网站是否能正常访问。如果访问异常，请先开通本地网络。

• 确认当前开发工具是否开启代理。下载jar包前需要确保开发工具代理关闭。

  比如以2020.2版本的IntelliJ IDEA开发工具为例，单击“File > Settings > Appearance & Behavior > System Settings > HTTP Proxy”，选择“No proxy”，单击“OK”保存配置。

开源镜像配置方式如下所示：

1. 使用前请确保您已安装JDK 1.8及以上版本和Maven 3.0及以上版本。
2. 配置Maven配置文件。
   • 如果想要覆盖Maven配置文件，在华为开源镜像站（https://mirrors.huaweicloud.com/），选择“华为SDK > HuaweiCloud SDK”，下载华为开源镜像站提供的“settings.xml”文件，覆盖至“<本地Maven安装目录>/conf/settings.xml”文件即可。
   • 如果不想覆盖Maven配置文件，可以参考以下方法手动修改“settings.xml”配置文件或者组件样例工程中的“pom.xml”文件，配置镜像仓地址。
     • 配置方法一：修改“settings.xml”配置文件。

       手动在“settings.xml”配置文件的“mirrors”节点中添加以下开源镜像仓地址：

       <mirror>
           <id>repo2</id>
           <mirrorOf>central</mirrorOf>
           <url>https://repo1.maven.org/maven2/</url>
       </mirror>

       在“settings.xml”配置文件的“profiles”节点中添加以下镜像仓地址：

       <profile>
           <id>huaweicloudsdk</id>
           <repositories>
               <repository>
                   <id>huaweicloudsdk</id>
                   <url>https://repo.huaweicloud.com/repository/maven/huaweicloudsdk/</url>
                   <releases><enabled>true</enabled></releases>
                   <snapshots><enabled>true</enabled></snapshots>
               </repository>
           </repositories>
       </profile>

       在“settings.xml”配置文件的“activeProfiles”节点中添加如下profile地址：

       <activeProfile>huaweicloudsdk</activeProfile>

       

       • 华为开源镜像站不提供第三方开源jar包下载，请配置开源镜像后，额外配置第三方Maven镜像仓库地址。
       • 使用IntelliJ IDEA开发工具时，可单击“File > Settings > Build, Execution, Deployment > Build Tools > Maven”查看当前“settings.xml”文件放置目录。

         

     • 配置方法二：修改“pom.xml”配置文件。
       请直接在二次开发工程样例工程中的“pom.xml”文件添加如下镜像仓地址：

           <repositories>
       
               <repository>
                   <id>huaweicloudsdk</id>
                   <url>https://mirrors.huaweicloud.com/repository/maven/huaweicloudsdk/</url>
                   <releases><enabled>true</enabled></releases>
                   <snapshots><enabled>true</enabled></snapshots>
               </repository>
       
               <repository>
                   <id>central</id>
                   <name>Maven Central</name>
                   <url>https://repo1.maven.org/maven2/</url>
               </repository>
       
           </repositories>

3. 配置Maven默认编码和JDK。在“settings.xml”配置文件的“profiles”节点中添加以下内容：

   <profile>
   <id>JDK1.8</id>
   <activation>
   <activeByDefault>true</activeByDefault>
   <jdk>1.8</jdk>
   </activation>
   <properties>
   <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
   <project.reporting.outputEncoding>UTF-8</project.reporting.outputEncoding>
   <maven.compiler.encoding>UTF-8</maven.compiler.encoding>
   <maven.compiler.source>1.8</maven.compiler.source>
   <maven.compiler.target>1.8</maven.compiler.target>
   <maven.compiler.compilerVersion>1.8</maven.compiler.compilerVersion>
   </properties>
   </profile>