Part 1 - 物联网云平台开发环境搭建

2022-04-28

6分钟阅读时长

【版本】

当前版本号v20250421

版本	修改说明
v20250421	修正部分不完整的步骤
v20230301	增加 ApiDemo 让Postman可以演示
v20230221	更换MQTT服务器为 EMQX，更换客户端为MQTTX
v20220428	初始化版本

任务1 - 物联网云平台开发环境搭建

【任务目的】

掌握安装 Rapid Environment Editor
掌握安装 JDK 并进行配置
掌握安装 IDEA 并进行配置
掌握安装 MariaDB 并进行配置
掌握安装 EMQX 并进行配置
掌握安装 MQTTX 和进行订阅和发布

【任务环境】

内存：至少4G
硬盘：至少空余40G
操作系统: 64位 Windows 系统。

【任务资源】

实验资源下载

【任务步骤】

安装 Rapid Environment Editor

Rapid Environment Editor（下文统称RapidEE)是一个图形化的系统环境变量编辑器。

下载RapidEE_setup.exe，右键选择“以管理员身份运行”，安装过程略。
安装完成以后，打开rapidee.exe，可以看到左侧是系统环境变量，右边是用户环境变量。

安装 JDK

下载安装jdk-8u321-windows-x64.exe，下文以安装JDK到D:\jdk8为例，具体请替换为你的安装路径。安装完成以后会有类似以下的目录结构。

这里|-如果对齐表示同级目录，如果错位表示是上面目录的下一级目录。

d:\jdk8
  |-bin/
  |-lib/
  |-include/
  |-jre/            
  |-legal/
  |-javafx-src.zip  
  |-jmc.txt
  |-src.zip
  |-COPYRIGHT
  |-release
  |-LICENSE
  |-README.html

安装 JDK 完成以后，打开RapidEE，点击“以管理身份重启”，即刻编辑系统环境变量。
右键点击左侧系统变量区域，选择添加环境变量。
新建名为JAVA_HOME变量，变量值为JDK安装路径d:\jdk8（具体请替换为你的安装路径）。

如果提示“变量已经存在”，则可以直接找到JAVA_HOME进行编辑。

在左侧系统变量找到Path变量，新增值%JAVA_HOME%\bin。

如果之前安装有其他版本的JDK，需要移除旧的JDK环境变量，否则JDK无法应用到当前版本。

保存环境变量。
按下Win+R，输入cmd调出 Windows 命令行终端，输入以下代码查看 JDK 版本是否为 1.8。

java -version

参考以上步骤，添加系统变量CLASSPATH。

如果变量已存在，则增加=后面的值。

CLASSPATH=%JAVA_HOME%\lib\dt.jar;%JAVA_HOME%\lib\tools.jar

安装 IDEA

下载安装ideaIC-2022.1.exe，下文以安装到d:\idea为例。
找到d:\idea\bin目录下的idea.exe.vmoptions或idea64.exe.vmoptions，在文件末尾加上以下代码，让 IDEA 默认使用UTF8编码。

-Dfile.encoding=UTF-8

打开idea64.exe，查看是否能够正常启动 IDEA。

安装 Maven

解压maven363-iot.zip，这里以解压到d:\maven363-iot为例。这个 Maven 版本经过老师修改，已经内置了一个 repos 文件夹，作为 jar 包仓库（Repository）。

d:\maven363-iot
  |-bin/      
  |-boot/     
  |-conf/     
  |-lib/      
  |-LICENSE   
  |-NOTICE    
  |-README.txt
  |-repos/

解压本地仓库包repos.zip到d:\maven363-iot\repos目录下。
编辑d:\maven363-iot\conf\settings.xml文件。在约54行复制本地仓库（localRepository）路径配置，并注意修改为你的 Maven 的实际安装路径。

<localRepository>D:/maven363-iot/repos</localRepository>

注意：标签必须放到 XML 的注释标签外面。

编辑d:\maven363-iot\conf\settings.xml文件。在约148行<mirrors>标签内增加远程仓库镜像地址。开发过程中依赖的 Jar 包可以通过配置从此地址下载。

如果电脑可以联网，可以修改指向阿里云的仓库镜像。

<mirror>
  <id>nexus-aliyun</id>
  <mirrorOf>*</mirrorOf>
  <name>Nexus aliyun</name>
  <url>http://maven.aliyun.com/nexus/content/groups/public</url>
</mirror>

编辑d:\maven363-iot\bin\mvn.cmd 文件，找到第1行，修改JAVA_HOME为你的JDK安装路径。

set "JAVA_HOME=d:/jdk8"

进入RapidEE，修改系统环境变量，配置以下环境变量。

新增

MAVEN_HOME=D:\maven363-iot

PATH环境变量增加以下值

%MAVEN_HOME%\bin

打开 Windows 的命令行终端，运行以下命令，测试是否有Maven的版本输出。

mvn -version

正常能够看到类似以下信息

安装 MariaDB

MariaDB 是 MySQL 的一个复刻，由社区开发，有商业支持，旨在继续保持在 GNU GPL下开源。MariaDB 的开发是由 MySQL 的一些原始开发者领导的，他们担心甲骨文公司收购 MySQL 后会有一些隐患。MariaDB打算保持与MySQL的高度兼容性，确保具有库二进制奇偶校验的直接替换功能，以及与MySQL API和命令的精确匹配。
来源：https://zh.wikipedia.org/wiki/MariaDB

MariaDB打算保持与MySQL的高度兼容性，确保具有库二进制奇偶校验的直接替换功能，以及与MySQL API和命令的精确匹配

如果之前安装有其他版本的MySQL，需要关闭后台的 MySQL 服务，以免 MariaDB 安装失败。

>在`控制面板\所有控制面板项\管理工具`找到服务MySQL或者MySQL5，停止服务，并将启动类型改为`手动`。

下载安装mariadb-10.4.13-winx64.msi，安装过程略，注意设置的 root 密码自己要记住。

安装 HeidiSQL

HeidiSQL 是一个免费的MySQL/MariaDB数据库的图形化客户端，同类型的产品有 Navicat（收费）、SQLyog、MySQL Workbench等。

解压HeidiSQL_11.1_64_Portable.zip 到指定目录下，例如d:\heidisql。
运行heidisql.exe，启动客户端。
尝试输入IP地址、用户名为root、密码(参考步骤19 root 密码)连接数据库，看是否能够连接成功。

安装 Postman

安装Postman，安装过程略。
解压apidemo.zip，双击运行startApiDemo.bat，会启动一个 Web 应用程序http://localhost:8181。
打开 Postman 使用Get方法访问链接 http://localhost:8181/uppercase?input=abc，这是可以把input参数的值转换为大写的一个API。
把input参数修改为其他的小写单词，再访问查看返回结果会发生什么变化。