五分钟上手IoT小程序

IoT小程序框架
搭建开发环境
- 首先安装NodeJs
- - 安装NodeJs
  - 验证安装成功
- 安装cnpm
安装VSCode 开发IDE
- 下载开发IDE
- 安装开发IDE
- 安装框架脚手架
下载模拟器
创建工程项目
- 应用编译(打包构建)
VSCode 开发IDE安装插件
- 通过开发插件创建工程
- 编译工程
- - debug编译
  - 编译太慢问题处理
  - release编译
- 启动模拟器
demo案例导入
IoT小程序体验

IoT小程序框架

在上手操作IoT小程序之前，首先了解一下什么是IoT小程序框架，IoT是一套跨平台应用显示框架，它利用JS语言低门槛和API标准化大幅度降低了IoT应用的研发难度，全面拥抱JavaScript开源生态，且系统服务通过统一的JSAPI，实现一端开发，多端运行策略。官方说明文档地址：https://www.yuque.com/wcye0k/haasui，下面话不多说，直接上手操作吧！

搭建开发环境

首先安装NodeJs

安装NodeJs

下载安装包
首先我们需要下载我们需要的开发环境的版本，下载地址：https://nodejs.org/zh-cn/download/，这里我选择windows 64bit版本的安装包，
在这里插入图片描述
完成之后找到对应的安装文件双击安装，点击【next】

勾选同意之后继续点击【next】

选择你想要安装的目录位置，继续点击【next】

再次点击【next】

这个页面的选项这里先不要选，继续点击【next】
在这里插入图片描述
点击按钮【install】

看到这个页面表示你已经安装成功了

验证安装成功

安装完成之后我们在windows开始菜单中找到node.js的命令行窗口，打开
在这里插入图片描述
输入命令

node -v

npm -v

验证一下是否安装成功
在这里插入图片描述

安装cnpm

安装完NodeJs之后再安装一下cnpm命令，命令行操作

npm install -g cnpm --registry=https://registry.npmmirror.com

执行结果如图
在这里插入图片描述
安装完cnpm之后我们继续安装开发ide

安装VSCode 开发IDE

下载开发IDE

找到下载开发IDE的官网地址：https://code.visualstudio.com/Download
在这里插入图片描述
选择windows版本的点击下载按钮，点击之后发现国外的网址下载的速度相当慢，这里按照IoT官方文档推荐的国内下载地址：https://vscode.cdn.azure.cn/stable/899d46d82c4c95423fb7e10e68eba52050e30ba3/VSCodeUserSetup-x64-1.63.2.exe 重新点击下载，下载完成后进入IDE安装步骤。

安装开发IDE

双击下载的VSCode IDE，出现弹框提示，点击【确定】，继续后面的安装
在这里插入图片描述
勾选同意协议，点击【下一步】

设置安装路径，点击【下一步】

继续点击【下一步】

点击【安装】

安装成功可以看到页面，这里先不要直接运行，点击【完成】

安装框架脚手架

框架脚手架提供项目创建、构建Debug & Release包、运行模拟器等能力

cnpm i aiot-vue-cli -g     //-g 表示全局安装，必须输入

安装完成如图
在这里插入图片描述
安装完成之后查看aiot-cli版本号

aiot-cli -V

可以看到如图效果
在这里插入图片描述
如果需要删除框架脚手架，可以执行如下命令

cnpm uninstall aiot-vue-cli

下载模拟器

模拟器下载地址：https://hli.aliyuncs.com/o/config/haasui/simulator/windows_x64/haasui-simulator-windows-64.zip 点击下载，下载成功之后直接解压
在这里插入图片描述
在当前文件夹下打开windows命令窗口，输入命令

./appx.exe

可以看到模拟器运行成功后页面
在这里插入图片描述
这里我录了一个动态的模拟器图，如下

到此，整个一套IoT小程序从搭建环境到下载VSCode IDE以及下载模拟器的整体操作就完成了，下面将进入另一片天地，项目开发。

创建工程项目

我们通过命令行的方式创建工程项目，首先需要创建工程，输入命令,

# name为你的工程名称

aiot-cli create [name]

# 进入工程目录

cd [name]  

#安装应用依赖

cnpm install

工程创建成功如图
在这里插入图片描述
下面我们进入工程目录安装应用依赖，可以看到依赖安装成功

应用编译(打包构建)

工程或者说应用创建成功之后，我们输入编译命令

#编译Debug测试应用包  或者

cnpm run build

#编译release 正式应用包

cnpm run build:prod

执行编译命令，可以看到应用构建成功
在这里插入图片描述
在应用路径可以看到生成的.falcon_文件夹

以及.falcon_文件夹下的{appId}.amr应用包
在这里插入图片描述
应用编译打包之后我们需要去模拟器查看项目运行效果

VSCode 开发IDE安装插件

在系统开始菜单找到VSCode开发工具
在这里插入图片描述
打开VSCode ，点击应用商店输入Haas

找到Haas UI 点击安装插件，安装成功

点击已经安装好的Haas UI插件设置按钮【Extension Settings】,将模拟器的路径（appx所在的路径）配置到插件的Simulator Path中

通过开发插件创建工程

打开VSCode 点击创建按钮
在这里插入图片描述
输入工程名称test02

可以看到默认的工作区路径

创建成功之后如图

编译工程

debug编译

编译工程，点击编译按钮
在这里插入图片描述
这个执行过程比较慢，我这边等了挺久也没有提示完成，但是如果通过命令行模式的话直接输入 cnpm install却很快执行完成

编译太慢问题处理

这里我的nodejs版本已经是v18+了，所以采取第二种方案，以管理员身份打开powershell，
在这里插入图片描述
然后输入命令，开启权限

Set-ExecutionPolicy RemoteSigned

#查询是否操作成功

Get-ExecutionPolicy

结果如图
在这里插入图片描述
再次回到VSCode重新点击编译可以看到，编译成功

release编译

点击release编译按钮可以看到编译成功页面
在这里插入图片描述

启动模拟器

点击VSCode 启动模拟器按钮Simulator，等待十几秒可以看到模拟器启动成功效果
在这里插入图片描述
更改index.vue然后Ctrl+S保存，模拟器会自动刷新成最新内容，如下动图

至此整个IoT小程序从搭建环境，安装VSCode IDE开发工具再到命令行创建工程，VSCode插件安装，插件使用及模拟器效果验证，整个操作流程就全部完成了，整个操作过程中有疑问的欢迎咨询哈，个人实际投入时间可远远不止五分钟，但是大家按我的操作步骤一套流程下来的话，五分钟足矣。

demo案例导入

打开VSCode IDE，点击【File】>【Open Folder…】打开本地下载的公板案例项目，公板案例下载地址：https://hli.aliyuncs.com/o/config/public-examples/falcon-demo.zip
打开项目之后按照步骤debug编译，编译完成之后点击Simulator启动模拟器可以看到
在这里插入图片描述
打开公板案例工程文件，找到需要修改的内容，修改后快捷键Ctrl+S保存，模拟器即可刷新成最新内容

有需要的也可以尝试哈。

IoT小程序体验

首先声明一下，以上步骤是经过本人实测验证的，完全可以放心参考操作，官方文档的步骤可以参考，但是个人感觉写的不很连贯，并且多个说明文档页面来回跳转，有时候看着看着就不知道该进行哪一步了。

另外就是有个疑问？是否可以通过命令行模式启动模拟器呢？具体的启动命令是什么？文档中没有明确说，而是在命令行执行完cnpm run build之后又重新跳回了模拟器运行页面，而模拟器运行页面又需要通过VSCode打开工程，然后点击Simulator来启动模拟器，没有直接通过命令行唤起模拟器的命令。在实验操作中最开始我是想全程通过命令行操作的，但到了启动模拟器这一步不得不下载VSCode 插件来完成启动模拟器的操作。

官方文档提供了对应的模板案例，比如公板案例，下载之后可以直接通过VSCode IDE打开，编辑其中的内容可以方便开发者更快的上手熟悉IoT小程序框架。但是对于初学者来说的话，对于整个demo工程的文件结构不太熟悉，希望关于这方面也可以补充一下文档，比如src下是代码以及其他每个文件夹中对应内容的用途等。

关于产品联动，IoT小程序可以和物联网产品联动，比如远端设备是温度湿度感测装置，IoT小程序可以收集远端设备数据分析给出远端设备响应的返回，比如湿度不达标提醒等；再比如和空调联动，IoT小程序接收屋内环境数据进行分析，设置合适的空调温度，自动适应人体；总之，通过IoT小程序可以和未来的物联网时代实现无平台交互，有物联网的地方就有IoT小程序，未来已来，一起加油吧，IoT。