使用CPP编写小型系统app 原创精华

落叶亦知冬

发布于 2023-4-20 16:53

浏览

9收藏

前言

$\qquad$本文将介绍如何使用cpp编写用于小型系统的app。

一、ability相关介绍

$\qquad$Ability是应用所具备能力的抽象，也是应用程序的重要组成部分。Ability是系统调度应用的最小单元，是能够完成一个独立功能的组件。一个应用可以包含一个或多个Ability。其中ability又分为Page类型的和Service类型的，前者是为用户提供人机交互能力的，后者是提供后台任务机制的，简单来讲就是Page带界面，Service不带界面。这里将重点介绍Page类型的ability。
使用CPP编写小型系统app-鸿蒙开发者社区
$\qquad$使用到的子系统有ability子系统、包管理子系统和图形ui子系统。ability子系统是管理OpenHarmony应用运行状态的开发框架；包管理子系统是OpenHarmony为开发者提供的安装包管理框架；图形ui子系统提供基础UI组件和容器类组件。
使用CPP编写小型系统app-鸿蒙开发者社区

二、简单实现

2.1 ability和abilityslice
$\qquad$abilityslice是单个页面及其控制逻辑的总和，是Page类型Ability特有的组件，一个Page类型的Ability可以包含多个AbilitySlice，此时，这些页面提供的业务能力应当是高度相关的。
使用CPP编写小型系统app-鸿蒙开发者社区
2.2 生命周期
$\qquad$整体流程下来大致有OnStart()、OnAvtive()、OnInactive()、OnBackground()和OnStop()五阶段。abilityslice生命周期与ability相似,但是仍要区分。

2.3 hello world

./helloworld/
├── config.json                         //配置文件
├── resource                            //资源
└── src                                 //主要文件
    ├── include
    │   ├── main_ability.h
    │   └── main_ability_slice.h
    └── main
        ├── main_ability.cpp
        └── main_ability_slice.cpp

首先定义并注册ability

// main_ability.h
#ifndef HELLO_MAIN_ABILITY_H
#define HELLO_MAIN_ABILITY_H

#include "ability_loader.h"

namespace OHOS {
class MainAbility : public Ability {
protected:
    void OnStart(const Want &want) override; //Want结构体，ability的相关信息
    /*
     * 由于在这里我们只要简单的展示helloworld标签，其它函数不需要重载。
     */
    // void OnInactive() override;
    // void OnActive(const Want &want) override;
    // void OnBackground() override;
    // void OnStop() override;
};
}

#endif

//main_ability.cpp
#include "main_ability.h"

namespace OHOS {
REGISTER_AA(MainAbility) //使用REGISTER_AA注册ability

void MainAbility::OnStart(const Want &want)
{
    printf("This is MainAbility OnStart status!\r\n");
    SetMainRoute("MainAbilitySlice"); //设置主页面为MainAbilitySlice，这要与后续的slice名字匹配

    Ability::OnStart(want);
}
}

Ability->MainAbility: 继承 
Note right of MainAbility: 设置主slice为MainAbilitySlice
MainAbility-->Ability: 重写OnStart()

最后编写slice界面

//main_ability_slice.h
#ifndef HELLO_ABILITY_SLICE_H
#define HELLO_ABILITY_SLICE_H

#include "ability_loader.h"
#include "ability_manager.h"
#include "bundle_manager.h"
#include "components/ui_label.h"

namespace OHOS {
class MainAbilitySlice : public AbilitySlice { //创建AbilitySlice类 与上面同名
public:
    MainAbilitySlice() = default;
    virtual ~MainAbilitySlice();

protected:
    void OnStart(const Want &want) override;
    /*
     * 同理
     */
    // void OnInactive() override;
    // void OnActive(const Want &want) override;
    // void OnBackground() override;
    // void OnStop() override;
};
}
#endif

//main_ability_slice.cpp
#include "main_ability_slice.h"
const int screen_width = 720;
const int screen_height = 1280;

namespace OHOS {
REGISTER_AS(MainAbilitySlice)

MainAbilitySlice::~MainAbilitySlice()
{
    printf("This is ~MainAbilitySlice!\r\n");
}

void MainAbilitySlice::OnStart(const Want& want)
{
    AbilitySlice::OnStart(want);
    RootView* rootView_ = RootView::GetWindowRootView(); //创建底层界面
    rootView_->SetPosition(0, 0, screen_width, screen_height);
    rootView_->SetStyle(STYLE_BACKGROUND_COLOR, Color::ColorTo32(Color::Black()));
    rootView_->SetFocusable(true);
    rootView_->SetInterceptFocus(false);

    UILabel* label = new UILabel(); //创建label写入Hello World
    label->SetPosition(0, 0, 720, 64);
    label->SetText("Hello World!");
    label->SetFont("SourceHanSansSC-Regular.otf", 64);
    label->SetStyle(STYLE_TEXT_COLOR, Color::ColorTo32(Color::White()));

    rootView_->Add(label); //将label放入rootView

    SetUIContent(rootView_); //设置显示RootView UI
}
}
#endif

AbilitySlice->MainAbilitySlice: 继承 
Note right of MainAbilitySlice: 与上设置的MainAbilitySlice同名
MainAbilitySlice-->AbilitySlice: 重写OnStart()

2.4 config.json的编写

//config.json
{
    "app": {
        "bundleName": "com.sample.hello",
        "vendor": "sample",
        "version": {
            "code": 1,
            "name": "1.0"
        },
        "apiVersion": {
            "compatible": 3,
            "target": 4
        }
    },
    "deviceConfig": {
        "default": {
        }
    },
    "module": {
        "package": "com.sample.hello",
        "name": ".MyHarmonyAbilityPackage",
        "deviceType": [
            "phone",
            "tv",
            "tablet",
            "pc",
            "car",
            "smartWatch",
            "sportsWatch",
            "smartVision"
        ],
        "distro": {
            "deliveryWithInstall": true,
            "moduleName": "hello",
            "moduleType": "entry"
        },
        "abilities": [ //ability配置声明
            {
                "name": "MainAbility",
                "label": "hello world app",
                "launchType": "standard",
                "type": "page",
                "visible": true
            }
        ]
    }
}

三、hap编译

3.1 通过BUILD.gn与系统一并编译。
使用到编译链中的hap_pack,添加配置 import(“//build/lite/config/hap_pack.gni”)

import("//build/lite/config/hap_pack.gni")

shared_library("hello") {
  sources = [
    "src/main/main_ability.cpp",
    "src/main/main_ability_slice.cpp"
  ] #将主要文件编译出库

  deps = [
    "${aafwk_lite_path}/frameworks/ability_lite:aafwk_abilitykit_lite",
    "${appexecfwk_lite_path}/frameworks/bundle_lite:bundle",
    "//foundation/graphic/ui:lite_ui",
    "//foundation/graphic/utils:lite_graphic_utils",
    "//foundation/systemabilitymgr/samgr_lite/samgr:samgr",
  ]

  include_dirs = [
    "src/include",
    "${aafwk_lite_path}/interfaces/kits/ability_lite",
    "${aafwk_lite_path}/interfaces/kits/want_lite",
    "${appexecfwk_lite_path}/interfaces/kits/bundle_lite",
  ]

  ldflags = [ "-shared" ]
  ldflags += [ "-lstdc++" ]
  ldflags += [ "-L$ohos_root_path/sysroot/usr/lib" ]
  ldflags += [ "-Wl,-rpath-link=$ohos_root_path/sysroot/usr/lib" ]
  ldflags += [
    "-lui",
    "-lability",
  ] #添加依赖

  defines = [
    "ENABLE_WINDOW=1",
    "ABILITY_WINDOW_SUPPORT",
    "OHOS_APPEXECFWK_BMS_BUNDLEMANAGER",
  ] #配置定义
}

hap_pack("hello_hap") { #打包成hap
  deps = [ ":hello" ]
  mode = "hap"
  json_path = "config.json"
  ability_so_path = "$root_out_dir/libhello.so" #编译后的库文件
  force = "true"
  cert_profile = "com.huawei.launcher_AppProvision_release.p7b" #由于不清楚获取证书方法 先用源码案例自带的证书代替
  resources_path = "resources"
  hap_name = "hello"
}

3.2 通过app_packing_tool单独编译
该打包工具在源码目录developtools/packing_tool/jar下
主要参数如下

命令参数	对应的资源文件	说明	是否可缺省
–mode	-	为“hap”字段，打包生成Hap	否
–json-path	清单文件config.json	-	否
–ability-so-path	主功能so文件	-	是
–out-path	-	生成的Hap包输出路径，默认为当前目录	是

具体操作
还是得先将动态库编译出来
然后将动态库libhello.so和config.json放到一个文件夹里

./out/
├── config.json
└── libhello.so

最后使用java -jar app_packing_tool.jar 进行打包如下

java -jar app_packing_tool.jar |
--mode hap |
--json-path ./config.json |
--ability-out-path ./libhello.so |
--out-path ./hello.hap

四、hap安装

4.1 安装命令bm
由于小型系统不支持使用HDC工具，我们需要使用到bm命令进行安装程序。

bm set -s disable //取消签名安装。
bm install -p system/internal/hello.hap //使用BUILD.gn一起编译的hap默认会在这个路径，如果使用工具打包的，视情况填写路径。

4.2 相关参数

# bm
Usage: install hap-path [options]
Description:
        --help|-h                   help menu
        --happath|-p           location of the hap to install
Usage: uninstall bundle-name [options]
Description:
        --help|-h                   help menu
        --bundlename|-n           name of the bundle to uninstall
Usage: dump [options]
Option Description:
        --help|-h                   help menu
        --list|-l                   app list
        --bundlename|-n           dump installed hap's info
        --metadatakey|-m           dump bundleNames match metaData key
Usage: set [options]
Option Description:
        --externalmode|-e status    enable externalmode
        --debugmode|-d  status      enable debugmode
        --signmode|-s  status      enable signmode

小型系统的bm指令是标准系统的阉割版

安装成功后就可以打开该app，部分小型系统的设备屏幕没有触摸功能和鼠标驱动，我们可以使用aa命令来启动app

aa start -p com.sample.hello -n MainAbility //包名和ability名都在config.json中定义

# aa
Usage:
aa start -p bundlename -n ability_name
aa stopability -p bundlename -n ability_name
aa terminate -p bundlename
aa dump -p bundlename -n ability_name -e extra_option
aa dump -a

Options:
 -h (--help)                Show the help information.             [eg: aa -h]
 -p (--bundlename)          Appoint the bundlename name.           [eg: -p com.huawei]
 -n (--abilityname)         Appoint the ability name.              [eg: -n MyAbility]
 -a (--all)                 [Unnecessary]dump all ability info.    [eg: -a]
 -e (--extra)               [Unnecessary]extra info when dump.     [eg: -e]

Commands:
aa start                    Start the target ability.
aa stopability              Stop the target service ability.
aa terminate                Terminate the target app.
aa dump                     Dump ability