【版本】
当前版本号v20230301
版本 | 修改说明 |
---|---|
v20230301 | 增加 ApiDemo 让Postman可以演示 |
v20230221 | 更换MQTT服务器为 EMQX,更换客户端为MQTTX |
v20220428 | 初始化版本 |
【实验名称】实验1 - 物联网云平台开发环境搭建
【实验目的】
- 掌握安装 Rapid Environment Editor
- 掌握安装 JDK 并进行配置
- 掌握安装 IDEA 并进行配置
- 掌握安装 MariaDB 并进行配置
- 掌握安装 EMQX 并进行配置
- 掌握安装 MQTTX 和进行订阅和发布
【实验环境】
- 内存:至少4G
- 硬盘:至少空余40G
- 操作系统: 64位 Windows 系统。
【实验资源】
链接:https://pan.baidu.com/s/1N5g1gZNrDGJgkfRjNCN_Fg
提取码:80bn
【实验步骤】
安装 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
。
保存环境变量。
按下
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和命令的精确匹配。
MariaDB打算保持与MySQL的高度兼容性,确保具有库二进制奇偶校验的直接替换功能,以及与MySQL API和命令的精确匹配
- 下载安装
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
参数修改为其他的小写单词,再访问查看返回结果会发生什么变化。
安装 EMQX
下载
emqx-5.0.14-windows-amd64.tar.gz
,解压到安装目录下,例如d:\emqx
。进入安装目录的
bin
目录下,新建一个文本文件,并命名为0-start-emqx.bat
,作为 EMQX 的启动脚本。
cd d:
cd %~dp0
emqx start
- 同样在
bin
目录下,新建一个文本文件,并命名为0-stop-emqx.bat
,作为 EMQX 的启动脚本。
cd d:
cd %~dp0
emqx stop
双击脚本
0-start-emqx.bat
启动EMQX
。MQTT 服务器默认监听在tcp://localhost:1883
。输入默认用户名 admin 与默认密码 public,登录进入 Dashboard。
安装 MQTTX
下载
MQTTX-Setup-1.7.3-x64.exe
,进行安装,安装过程略。启动 MQTTX,新建连接。
输入 MQTT 代理地址、用户名和密码进行连接。
订阅一个主题
/iot/cloud/thermometer001/receive
向主题
/iot/cloud/thermometer001/receive
发布消息
Hello MQTTX
- 查看订阅主题是否收到消息