基于 hiACEJS 在 MiniGUI 上进行类小程序应用开发

飞漫软件发表此文章的目的是用于向开发者解释合璧操作系统的设计原理或者相关规范。在未获得飞漫软件书面许可之前，任何人不得复制或者分发本文章的全部或部分内容，或利用本文章描绘的技术思路申请专利、撰写学术论文等。

访问 HarmonyOS 应用开发官方网站下载 DevEco Studio。需要注意的是下载 DevEco Studio 需要使用华为开发者帐号进行登录，登录成功后才能下载。

目前，DevEco Studio 支持 Windows （64-bit) 和 Mac 两个平台，其中 Windows 是最先支持的平台，功能相对完善, 目前最新版本是 2.1 Beta2, 系统要求如下图:

更多有关工具的下载与安装，可以参考 HarmonyOS 官方网站。

配置工程的基本信息，如下图:

点击 Finish，完成工程创建。DevEco Studio 会自动进行工程的同步，同步成功如下图所示。首次创建工程时，会自动下载 Gradle 工具, 这个时间会有点长。

.container {
    justify-content: center;
    align-items: center;
}
.title {
    width: 320px;
    height: 100px;
    font-size: 50px;
    text-align: center;
}

<div class="container" style="width: {{width}}; height: {{height}};">
    <text class="title">
        Hello {{title}}
    </text>
</div>

import device from '@system.device';

export default {
    data: {
        title: 'World',
        width: 454,
        height: 454
    },
    onInit() {
        device.getInfo({
            success: (data)=>{
                this.width = data.windowWidth;
                this.height = data.windowHeight;
                console.log(`Resolution: ${this.width}*${this.height}`);
            }
        });
    }
}

通过 Build 后，点击右侧的 Preview, 就可以直接预览界面如下:

import hibus from '../../common/hibus-wrapper';

export default {
    clickConnect() {
        hibus.connect("cn.fmsoft.hiacejs.helloworld", "test", "/var/tmp/hibus.sock");
    },
    clickDisconnect() {
        hibus.disconnect();
    },
    clickSubscribeEvent() {
        hibus.subscribeEvent("@localhost/cn.fmsoft.inetd/wifi", "wifiEvent", eventCallback);
    },
    clickUnSubscribeEvent() {
        hibus.unsubscribeEvent("@localhost/cn.fmsoft.inetd/wifi", "wifiEvent");
    },
    clickCallProcedure() {
        var param = {
            "device":"eth0"
        };
        var paramString = JSON.stringify(param);
        hibus.callProcedure("@localhost/cn.fmsoft.inetd/wifi", "openDevice", paramString, 10, procedureCallback);
    }
}

function eventCallback(endpoint, bubbleName, bubbleData) {
    console.log("eventCallback  endpoint=", endpoint);
    console.log("eventCallback  bubbleName=", bubbleName);
    console.log("eventCallback  bubbleData=", bubbleData);
}

function procedureCallback(endpoint, methodName, retCode, retValue) {
    console.log("procedureCallback  endpoint=", endpoint);
    console.log("procedureCallback  methodName=", methodName);
    console.log("procedureCallback  retCode=", retCode);
    console.log("procedureCallback  retValue=", retValue);
}

一般情况下，hiBus 相关包装模块 hibus-wrapper.js 放在 hiACEJS 的 common 目录下，因此，在使用时需要导入该模块。

在使用 hiBus 访问系统功能之前需要先建立到hiBus的链接

    clickConnect() {
        hibus.connect("cn.fmsoft.hiacejs.helloworld", "test", "/var/tmp/hibus.sock");
    },

function connect(appName, runnerName, pathToSocket);

当不再使用 hiBus 时，可以关闭与 hiBus 的链接

    clickDisconnect() {
        hibus.disconnect();
    },

function disconnect();

应用程序可以订阅事件，传入回调函数，当事件发生时，该回调函数将会被调用

    clickSubscribeEvent() {
        hibus.subscribeEvent("@localhost/cn.fmsoft.inetd/wifi", "wifiEvent", eventCallback);
    },

function subscribeEvent(endpoint, bubbleName, eventCallback);
function eventCallback(endpoint, bubbleName, bubbleData);

应用程序通过该函数取消事件订阅，取消后，将不会收到事件

    clickUnSubscribeEvent() {
        hibus.unsubscribeEvent("@localhost/cn.fmsoft.inetd/wifi", "wifiEvent");
    },

function unsubscribeEvent(endpoint, bubbleName);

应用程序可以通过该函数调用过程，远程过程执行后，将调用回调函数将结果传回

    clickCallProcedure() {
        var param = {
            "device":"eth0"
        };
        var paramString = JSON.stringify(param);
        hibus.callProcedure("@localhost/cn.fmsoft.inetd/wifi", "openDevice", paramString, 10, procedureCallback);
    }

function callProcedure(endpoint, methodName, methodParam, timeExpected, procedureCallback);
function procedureCallback(endpoint, methodName, retCode, retValue);

hibus-wrapper 是对 hibus 接口的一层包装，这层包装的目的是为了在 DevEco 开发环境中，在不具备 hiACEJS 的情况下，可以正常的进行开发的测试工作。在真实设备中，hibus-wrapper 调用 hiACEJS 提供的 system.hibus 模块的相关接口，在 DevEco 开发时，hibus-wrapper.js 调用 hibus-simulator.js 提供的接口。

import hibus from '@system.hibus';
import hibusSimulator from './hibus-simulator'

export default {
    connect(appName, runnerName, pathToSocket) {
        if (hibus) {
            return hibus.connect(appName, runnerName, pathToSocket);
        }
        else {
            return hibusSimulator.connect(appName, runnerName, pathToSocket);
        }
    },
    disconnect() {
        if (hibus) {
            return hibus.disconnect();
        }
        else {
            return hibusSimulator.disconnect();
        }
    },
    send(message) {
        if (hibus) {
            return hibus.send(message);
        }
        else {
            return hibusSimulator.send(message);
        }
    },
    read(timeout) {
        if (hibus) {
            return hibus.read(timeout);
        }
        else {
            return hibusSimulator.read(timeout);
        }
    },
    subscribeEvent(endpoint, bubbleName, callback) {
        if (hibus) {
            return hibus.subscribeEvent(endpoint, bubbleName, callback);
        }
        else {
            return hibusSimulator.subscribeEvent(endpoint, bubbleName, callback);
        }
    },
    unsubscribeEvent(endpoint, bubbleName) {
        if (hibus) {
            return hibus.unsubscribeEvent(endpoint, bubbleName);
        }
        else {
            return hibusSimulator.unsubscribeEvent(endpoint, bubbleName);
        }
    },
    callProcedure(endpoint, methodName, methodParam, timeExpected, callback) {
        if (hibus) {
            return hibus.callProcedure(endpoint, methodName, methodParam, timeExpected, callback);
        }
        else {
            return hibusSimulator.callProcedure(endpoint, methodName, methodParam, timeExpected, callback);
        }
    }
}

export default {
    connect(appName, runnerName, pathToSocket) {
    },
    disconnect() {
    },
    send(message) {
    },
    subscribeEvent(endpoint, bubbleName, callback) {
    },
    unsubscribeEvent(endpoint, bubbleName) {
    },
    callProcedure(endpoint, methodName, methodParam, timeExpected, callback) {
    }
}

在树莓派 4b 开发板上，使用 Buildroot 构建 HybridOS hiACEJS 基础环境，主要库如下: