harmony 鸿蒙编译构建Kconfig可视化配置指导

  • 2022-08-09
  • 浏览 (1436)

编译构建Kconfig可视化配置指导

概述

功能简介

该功能基于KconfiglibKconfig实现,方便用户个性化配置OpenHarmony产品子系统部件。

基于Kconfig实现的可视化配置功能具有以下优点:

  • 能直观且全面地展示软件的部件选项。
  • 可靠性强,如Linux-kernel、buildroot等知名软件都采用Kconfig进行可视化配置。

基本概念

  • Kconfig :是一款Linux可视化配置文件格式。

  • Kconfiglib:是一款基于Kconfig格式实现的Linux可视化配置工具。

相关模块

操作指导

  1. 获取源码

OpenHarmony版本发布的源码获取请参考:源码获取教程

  1. 环境准备

环境配置所需要的Kconfiglib已内置在OpenHarmony自带的hb工具中,如需安装hb工具,可参考:hb安装教程

  1. 开启可视化配置界面
   #进入build仓下目录
   cd build/tools/component_tools
   menuconfig kconfig

界面示例

  1. 参数填写

参数配置项可以参考:productdefine/common/base/base_product.json

参数填写

  1. 选择部件并配置

    1. 点击方向键->选择子系统,进入子系统的部件列表。

    2. 按回车健选择子系统。

    3. 输入feature时,注意用英语逗号隔开多项输入。

    部件选择

  2. 保存所选配置

按S键保存文件,可自定义输出文件名,默认为当前目录下.config文件。

保存配置

  1. 生成OpenHarmony Style配置文件

示例步骤:

  1. gn编译全量产品

      cp productdefine/common/base/base_product.json productdefine/common/products/ohos-arm64.json
      ./build.sh --product-name ohos-arm64  --build-only-gn --ccache --gn-args pycache_enable=true --gn-args check_deps=true --build-only-gn
    
  2. 生成部件依赖文件

      ./build/tools/module_dependence/part_deps.py --deps-files-path out/arm64/deps_files
      # output: out/arm64/part_deps_info/part_deps_info.json
    
  3. 生成OpenHarmony Style配置文件

      cd build/tools/component_tools
      python3 parse_kconf.py --deps=/path/to/out/arm64/part_deps_info/part_deps_info.json
    

    输出文件默认为当前目录下:product.json, 也可以使用python3 parse_kconf.py --out="example/out.json"来指定输出文件位置

    更多操作可查看python3 parse_kconf.py -h

常见问题

菜单列表缺失最新部件信息

由于产品不断的更新迭代,全量部件列表productdefine/common/base/base_product.json也会随之不断更新,从而导致Kconfig菜单缺少最新部件。

解决办法:

更新Kconfig文件

cd build/tools/component_tools
python3 generate_kconfig.py

更多选项通过python3 generate_kconfig.py -h查看。

你可能感兴趣的鸿蒙文章

harmony 鸿蒙子系统开发

harmony 鸿蒙AI框架开发指导

harmony 鸿蒙NNRt接入适配指导

harmony 鸿蒙应用特权配置指南

harmony 鸿蒙开发实例

harmony 鸿蒙搭建环境

harmony 鸿蒙开发指导

harmony 鸿蒙概述

harmony 鸿蒙ArkCompiler开发指导

harmony 鸿蒙窗口标题栏定制开发指导

0  赞