Java 开发如何通过 IoT 边缘 ModuleSDK 进行进程应用的开发

2022-12-23
中国香港
本文字数：2232 字
阅读完需：约 7 分钟

本文分享自华为云社区《【华为云IoTEdge开发实战】Java开发如何通过IoT边缘ModuleSDK进行进程应用的开发》，作者：华为 IoT 云服务。

为解决用户自定义处理设备数据以及自定义协议设备快速接入 IOT 平台的诉求，华为 IoT 边缘提供 ModuleSDK，用户可通过集成 SDK 让设备以及设备数据快速上云。IoT 边缘平台应用功能有自定义处理设备数据（即数据处理），自定义协议设备快速接入（即协议解析），IT 子系统接入(即 IT 应用)，并且支持容器化部署和安装包部署的方式。

1、操作场景

使用 ModuleSDK 开发插件应用，并以进程方式跑在服务器上。

2、代码解析

代码解析样例：

3、注册节点

注册节点，请参照注册边缘节点。

4、设备建模 &发放

请参照设备建模&发放。

5、项目打包

将集成 ModuleSDK 进行项目打包。

根据您的需求进行相关代码的开发，并将项目打包，以编辑器 IDEA 为例：

1.选中项目->右键 open Module setting

2.Artifacts->单击+号>JAR->From modules with dependencies->模块选择 monitor-app,选择 monitorapp 的 Main 入口类,注意 MANIFEST.MF 位置选择模块根目录->单击 apply。

3.单击上方 build 选项->选择 build Artifacts->monitor-app:jar->build

4.打包完成得到 monitor-app.jar 文件。(如遇到错误(Invalid signature file digest for Manifest main attributes)请使用压缩文件进入 metf 目录删除.rsa 和.mf 文件)

6、制作插件包

1.插件包制作。

a.插件包格式要求如下：

插件包仅支持.tar.gz 、.tar 或者 .zip 格式。

插件包结构如下：

app.zip

├── ****.jar //可执行 jar 文件,必须

├── start.sh //启动脚本必须文件当前不提供参数方式启动

└── stop.sh //停止脚本非必须

b.构建插件包。

以 monitor-app 为例，在项目打包后得到 monitor-app.jar

在 monitor-app.jar 文件的同目录下创建 start.sh,内容如下:

function log(){

echo "`date "+%Y-%m-%d %T"`: $1"

}

log "[INFO] start execut process."

#调试时可打开，确认 sdk 需要的环境能被获取

#echo "${device_id}" > test_enviroment.file

pwd

#更新环境变量，防止找不到 java 命令。

source /etc/profile

#运行文件在/var/IoTEdge/downloaded-job/run 下面

java -jar ./monitor-app.jar > monitor_running.log 2>&1

将 monitor-app.jar 和 start.sh 一起压缩得到 monitor-app.zip。

注意：

插件包升级时，会删除运行目录的所有文件，注意持久化文件的存储。插件包的运行路径为{installer_dir}/IoTEdge/downloaded-job/run/{moduleId}/{appVersion}/。
当前插件包的大小限制为最大 500M。
程序内对于文件的访问使用相对目录访问（因为程序的安装目录是不确定的）。
程序不允许包含后台运行的程序，可以包含多级进程，所有程序均为 sh 的子进程。
进程压缩包命名规范：英文字母或者数字或者“_”,”.” ，长度不超过 64，不允许出现空格。

说明：

插件包为一层压缩结构，即插件包的压缩包解压之后直接为 sh 脚本所在目录的结构形式，不能多一层目录。
sh 脚本为必须脚本，启动时默认调用该脚本进行启动，当前支持 root 用户以及非 root 用户（固定为 1000 用户,非 root 需要确定是否能够成功依赖系统库）启动，用户可以在 start.sh 脚本中自由修改自己的启动方式以及环境变量的修改等。
sh 为非必须的脚本，但是用户如果需要优雅停止的话，需要在改脚本中书写自己进程的停止方式（文件监控、接口调用等）。如果没有该脚本的话，默认对进程组先发送 SIGTERM 信号，如果进程组对该信号没有处理，达到最大等待时间则发送 SIGKILL 信号强制停止。整个停止的最大周期为 10s。