# 获取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样例代码下载   
![](https://support.huaweicloud.com/devg3-mrs/zh-cn_image_0279895871.png)
下载压缩包到本地后解压，即可获取各组件对应的样例代码工程。
![](https://support.huaweicloud.com/devg3-mrs/public_sys-resources/note_3.0-zh-cn.png)
MRS服务3.1.2-LTS版本获取样例工程请参考[通过开源镜像站获取样例工程](https://support.huaweicloud.com/devg-lts-mrs/mrs_07_010002.html)。
 #### 配置华为开源镜像仓
华为提供开源镜像站（网址为<https://mirrors.huaweicloud.com/>），各服务样例工程依赖的jar包都可在华为开源镜像站下载，剩余所依赖的开源jar包请直接从Maven中央库或者其他用户自定义的仓库地址下载。
![](https://support.huaweicloud.com/devg3-mrs/public_sys-resources/note_3.0-zh-cn.png)
本地环境使用开发工具下载依赖的jar包前，需要确认以下信息。
- 确认本地环境网络正常。 打开浏览器访问：华为提供开源镜像站（网址为<https://mirrors.huaweicloud.com/>），查看网站是否能正常访问。如果访问异常，请先开通本地网络。
  
- 确认当前开发工具是否开启代理。下载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>
       ```
       ![](https://support.huaweicloud.com/devg3-mrs/public_sys-resources/note_3.0-zh-cn.png)
       - 华为开源镜像站不提供第三方开源jar包下载，请配置开源镜像后，额外配置第三方Maven镜像仓库地址。
       
       - 使用IntelliJ IDEA开发工具时，可单击"File \> Settings \> Build, Execution, Deployment \> Build Tools \> Maven"查看当前"settings.xml"文件放置目录。 ![](https://support.huaweicloud.com/devg3-mrs/zh-cn_image_0000001209279722.png)
         
         
     
     - **配置方法二** ：修改"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>
   ```