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

2022-04-28
6分钟阅读时长

【版本】

当前版本号v20230301

版本修改说明
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)是一个图形化的系统环境变量编辑器。

  1. 下载RapidEE_setup.exe,右键选择“以管理员身份运行”,安装过程略。

  2. 安装完成以后,打开rapidee.exe,可以看到左侧是系统环境变量,右边是用户环境变量

安装 JDK

  1. 下载安装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
  1. 安装 JDK 完成以后,打开RapidEE,点击“以管理身份重启”,即刻编辑系统环境变量。

  2. 右键点击左侧系统变量区域,选择添加环境变量。

  3. 新建名为JAVA_HOME变量,变量值为JDK安装路径d:\jdk8(具体请替换为你的安装路径)。

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

  1. 在左侧系统变量找到Path变量,新增值%JAVA_HOME%\bin
如果之前安装有其他版本的JDK,需要移除旧的JDK环境变量,否则JDK无法应用到当前版本。
  1. 保存环境变量。

  2. 按下Win+R,输入cmd调出 Windows 命令行终端,输入以下代码查看 JDK 版本是否为 1.8。

java -version

  1. 参考以上步骤,添加系统变量CLASSPATH

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

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

安装 IDEA

  1. 下载安装ideaIC-2022.1.exe,下文以安装到d:\idea为例。
  2. 找到d:\idea\bin目录下的idea.exe.vmoptionsidea64.exe.vmoptions,在文件末尾加上以下代码,让 IDEA 默认使用UTF8编码。
-Dfile.encoding=UTF-8
  1. 打开idea64.exe,查看是否能够正常启动 IDEA。

安装 Maven

  1. 解压maven363-iot.zip,这里以解压到d:\maven363-iot为例。这个 Maven 版本经过老师修改,已经内置了一个 repos 文件夹,作为 jar 包仓库(Repository)。
d:\maven363-iot
  |-bin/      
  |-boot/     
  |-conf/     
  |-lib/      
  |-LICENSE   
  |-NOTICE    
  |-README.txt
  |-repos/       
  1. 解压本地仓库包repos.zipd:\maven363-iot\repos目录下。

  2. 编辑d:\maven363-iot\conf\settings.xml文件。在约54行复制本地仓库(localRepository)路径配置,并注意修改为你的 Maven 的实际安装路径。

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

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

  1. 编辑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>

  1. 编辑d:\maven363-iot\bin\mvn.cmd 文件,找到第1行,修改JAVA_HOME为你的JDK安装路径。
set "JAVA_HOME=d:/jdk8"
  1. 进入RapidEE,修改系统环境变量,配置以下环境变量。
  • 新增
MAVEN_HOME=D:\maven363-iot
  • PATH环境变量增加以下值
%MAVEN_HOME%\bin
  1. 打开 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,停止服务,并将启动类型改为`手动`。

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

安装 HeidiSQL

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

  1. 解压HeidiSQL_11.1_64_Portable.zip 到指定目录下,例如d:\heidisql

  2. 运行heidisql.exe,启动客户端。

  3. 尝试输入IP地址用户名为root、密码(参考步骤19 root 密码)连接数据库,看是否能够连接成功。

安装 Postman

  1. 安装Postman,安装过程略。

  2. 解压apidemo.zip,双击运行startApiDemo.bat,会启动一个 Web 应用程序http://localhost:8181

  3. 打开 Postman 使用Get方法访问链接 http://localhost:8181/uppercase?input=abc,这是可以把input参数的值转换为大写的一个API。

  4. input参数修改为其他的小写单词,再访问查看返回结果会发生什么变化。

安装 EMQX

  1. 下载emqx-5.0.14-windows-amd64.tar.gz,解压到安装目录下,例如d:\emqx

  2. 进入安装目录的bin目录下,新建一个文本文件,并命名为0-start-emqx.bat,作为 EMQX 的启动脚本。

cd d:
cd %~dp0
emqx start
  1. 同样在bin目录下,新建一个文本文件,并命名为0-stop-emqx.bat,作为 EMQX 的启动脚本。
cd d:
cd %~dp0
emqx stop
  1. 双击脚本0-start-emqx.bat启动EMQX。MQTT 服务器默认监听在tcp://localhost:1883

  2. 访问 EMQX 的管理控制台(EMQX Dashboard)

  3. 输入默认用户名 admin 与默认密码 public,登录进入 Dashboard。

安装 MQTTX

  1. 下载MQTTX-Setup-1.7.3-x64.exe,进行安装,安装过程略。

  2. 启动 MQTTX,新建连接。

  3. 输入 MQTT 代理地址、用户名和密码进行连接。

  4. 订阅一个主题/iot/cloud/thermometer001/receive

  5. 向主题/iot/cloud/thermometer001/receive发布消息

Hello MQTTX

  1. 查看订阅主题是否收到消息

扫码或长按识别访问