openharmonyinsight/oh-pdd-code-generator

代码生成器

基于设计文档自动生成 OpenHarmony 系统代码框架，包括目录结构、IDL 接口、头文件、源文件、构建配置等。

快速开始

提供设计文档路径：

基于 {功能设计文档} 生成代码框架

指定模块名称：

为 {模块名} 生成完整代码，基于 {功能设计文档}

OpenHarmony 代码分析

在生成代码前，需要分析 OpenHarmony 存量代码，确保生成的代码符合现有代码风格和架构规范。

分析步骤

1. 发现目录结构

使用 Glob 工具发现现有模块的组织结构：

# 查找相似模块的目录结构
foundation/{subsystem}/*/services/
foundation/{subsystem}/*/interfaces/
foundation/{subsystem}/*/tests/

2. 搜索代码模式

使用 Grep 工具搜索代码模式：

| 搜索目标 | 搜索关键字 | 提取信息 | |----------|------------|----------| | 类命名 | class.*Service | 服务类命名 | | 命名空间 | namespace.* | 命名空间组织 | | 日志标签 | HiLogLabel | 日志使用方式 | | 错误码 | ERROR_.*=.*[0-9] | 错误码分配 | | 宏定义 | #define.*_ENABLE | 条件编译开关 | | 初始化函数 | bool Init\(\) | 初始化模式 | | 清理函数 | void.*Release\(\) | 资源清理模式 |

3. 读取参考实现

使用 Read 工具读取相似模块的实现：

• 服务实现: *_service.cpp
• Provider 实现: *_provider.cpp
• IDL 定义: I*.idl
• 构建配置: BUILD.gn

4. 智能探索

使用 Task 工具启动 Explore 代理：

• 查找参考实现的最佳实践
• 提取通用代码模板
• 发现依赖的公共库和工具类

参考目录模式

OpenHarmony 标准目录结构：

foundation/{subsystem}/{part}/
├── bundle.json              # 部件配置
├── BUILD.gn                  # 主构建文件
├── {part}.gni                # 模块配置
├── services/
│   └── native/
│       ├── {sa_id}.json      # SA 配置
│       ├── include/          # 对外头文件
│       └── src/              # 实现文件
├── interfaces/
│   ├── idl/                  # IDL 接口
│   ├── innerkits/            # 内部 Kit
│   └── kits/                 # 对外 Kit
└── tests/                    # 测试代码

代码风格参考

| 代码元素 | 风格规则 | 示例 | |----------|----------|------| | 类名 | 大驼峰 + 后缀 | DiskInfoService | | 方法名 | 大驼峰 | GetDiskList() | | 成员变量 | 小驼峰 + 下划线后缀 | mutex_, inited_ | | 命名空间 | 小写双冒号分隔 | OHOS::DiskManagement | | 文件名 | 小写下划线 | disk_info_service.cpp | | 宏定义 | 大写下划线 | DISK_MANAGEMENT_FORMAT_ENABLE |

常用依赖库

| 依赖 | external_deps 格式 | 用途 | |------|-------------------|------| | HiLog | hilog:libhilog | 日志输出 | | c_utils | c_utils:utils | C 工具函数 | | ipc_core | ipc_core:ipc_core | IPC 通信 | | AccessToken | access_token:libaccesstoken | 权限管理 | | HiSysEvent | hisysevent:libhisysevent | 事件上报 | | HiTrace | hitrace_native:hitrace_meter | 链路追踪 |

生成内容

1. 目录结构

自动创建符合 OpenHarmony 规范的目录结构：

disk_management/
├── bundle.json              # 部件配置
├── BUILD.gn                  # 主构建配置
├── disk_management.gni       # 模块配置
├── services/
│   ├── native/
│   │   ├── 5001.json         # SA 配置文件
│   │   ├── disk_management.cfg  # Init 配置文件
│   │   ├── include/          # 头文件目录
│   │   └── src/              # 源文件目录
│   └── disk_info_service/    # 各服务目录
│       ├── include/
│       └── src/
├── interfaces/
│   ├── idl/OHOS/DiskManagement/    # IDL 接口定义
│   ├── innerkits/native/           # Native Kit
│   └── kits/js/                    # JS Kit
└── tests/                          # 测试目录

2. IDL 接口文件

生成 IDL 接口定义文件，格式：

/* Copyright (c) 2026 Huawei Device Co., Ltd. */

package OHOS.DiskManagement;

import "DiskInfoTypes.idl";

interface IDiskInfoService {
    /// 获取系统所有磁盘列表
    GetDiskList(): DiskInfo[];

    /// 获取指定磁盘的详细信息
    GetDiskInfo([in] string diskId): DiskInfo;

    /// 注册磁盘变化监听器
    RegisterChangeListener([in] IDiskChangeListener listener): void;
};

3. 头文件模板

生成符合 OpenHarmony 编码规范的头文件：

/* Copyright (c) 2026 Huawei Device Co., Ltd. */
#ifndef DISK_INFO_SERVICE_H
#define DISK_INFO_SERVICE_H

#include <string>
#include <vector>
#include <mutex>

namespace OHOS {
namespace DiskManagement {

class DiskInfoService {
public:
    DiskInfoService();
    ~DiskInfoService();

    bool Init();
    void Release();

    std::vector<DiskInfo> GetDiskList();
    DiskInfo GetDiskInfo(const std::string& diskId);

private:
    std::mutex mutex_;
    bool inited_;
};

} // namespace DiskManagement
} // namespace OHOS

#endif // DISK_INFO_SERVICE_H

4. 源文件模板

生成基础实现框架：

/* Copyright (c) 2026 Huawei Device Co., Ltd. */

#include "disk_info_service.h"
#include "hilog/log.h"

namespace OHOS {
namespace DiskManagement {

static constexpr HiLogLabel LABEL = { LOG_CORE, 0xD00430D, "DiskInfoService" };

DiskInfoService::DiskInfoService() : inited_(false)
{
    HiLog::Info(LABEL, "DiskInfoService constructed");
}

DiskInfoService::~DiskInfoService()
{
    Release();
}

bool DiskInfoService::Init()
{
    std::lock_guard<std::mutex> lock(mutex_);
    if (inited_) {
        HiLog::Warn(LABEL, "Already initialized");
        return true;
    }
    // TODO: 初始化逻辑
    inited_ = true;
    return true;
}

void DiskInfoService::Release()
{
    std::lock_guard<std::mutex> lock(mutex_);
    if (!inited_) {
        return;
    }
    // TODO: 清理资源
    inited_ = false;
}

} // namespace DiskManagement
} // namespace OHOS

5. BUILD.gn 配置

生成构建配置文件：

import("//build/ohos.gni")
import("//build/test.gni")
import("//foundation/filemanagement/disk_management/disk_management.gni")

ohos_shared_library("disk_management_sa") {
  subsystem_name = "filemanagement"
  part_name = "disk_management"

  sources = [
    "src/disk_management_service.cpp",
    "src/main.cpp",
  ]

  include_dirs = [
    "include",
    "${disk_management_path}/include",
    "//utils/native/base/include",
  ]

  deps = [
    ":disk_management_idl",
    "//foundation/hiviewdfx/hilog/native/framework:libhilog",
  ]

  external_deps = [
    "c_utils:c_utils",
  ]

  branch_protector_ret = "pac_ret"
  sanitize = {
    integer_overflow = true
    cfi = true
    debug = false
  }
}

ohos_unittest("disk_management_unittest") {
  subsystem_name = "filemanagement"
  part_name = "disk_management"
  test_type = "unittest"
  test_time_out = 300

  sources = [
    "test/disk_management_test.cpp",
  ]

  deps = [
    ":disk_management_sa",
  ]

  external_deps = [
    "googletest:gmock_main",
    "googletest:gtest_main",
  ]

  cflags_cc = [ "--coverage" ]
  ldflags = [ "--coverage" ]
}

6. SA 配置文件 (5001.json)

{
  "sa-id": 5001,
  "sa-name": "disk_management",
  "run-on-create": true,
  "auto-start": true,
  "start-mode": "boot",
  "process": "disk_management_service",
  "dump-level": "control",
  "critical": [1, 4, 240],
  "libpath": "libdisk_management_sa.z.so"
}

7. bundle.json

{
  "name": "disk_management",
  "description": "HM Desktop Disk Management Service",
  "version": "1.0.0",
  "component": {
    "name": "disk_management",
    "subsystem": "filemanagement",
    "syscap": [
      "SystemCapability.DiskManagement.DiskInfo",
      "SystemCapability.DiskManagement.Format"
    ]
  }
}

参考文档

• IDL 编写指南: references/idl_guide.md
• BUILD.gn 规范: references/build_gn_guide.md
• SA 配置规范: references/sa_profile_guide.md
• 编码规范: references/coding_style.md

命名规范映射

| 设计文档术语 | 代码术语 | 规则 | |--------------|----------|------| | 服务名称 | 类名 | 大驼峰 + Service 后缀 | | 模块名称 | 命名空间 | 小写下划线分隔 | | 接口名称 | IDL 接口 | I + 大驼峰 | | 数据结构 | struct | 大驼峰 | | 方法名 | 函数名 | 大驼峰 | | 成员变量 | 成员变量 | 小驼峰 + 下划线后缀 |

模块类型与生成策略

信息服务 (InfoService)

生成内容：

• GetList() 方法
• Get() 方法
• RegisterListener() 方法

示例：DiskInfoService

管理服务 (ManagerService)

生成内容：

• Execute() 方法
• Cancel() 方法
• RegisterProgressListener() 方法

示例：FormatManagerService, RepairManagerService

监听器 (Listener)

生成内容：

• OnChanged() 回调方法
• OnCompleted() 回调方法

示例：DiskChangeListener, FormatProgressListener

使用示例

生成完整代码框架：

基于 {功能设计文档} 为 {模块名} 模块生成完整代码

仅生成 IDL 接口：

只生成 IDL 接口文件，基于 {功能设计文档}

指定 SA ID：

生成代码，SA ID 使用 {SA_ID}，基于 {功能设计文档}

预览模式：

预览将要生成的文件，不实际创建，基于 {功能设计文档}

指定输出目录：

生成代码到 ./code_output 目录，基于 {功能设计文档}

条件编译支持

生成的代码支持功能条件编译：

# 在 .gni 文件中定义
declare_args() {
  disk_management_enable_format = true
  disk_management_enable_repair = true
}

# 在 BUILD.gn 中使用
if (disk_management_enable_format) {
  sources += [ "src/format_service.cpp" ]
  defines += [ "DISK_MANAGEMENT_FORMAT_ENABLE" ]
}

测试代码生成

同时生成单元测试框架：

/* Copyright (c) 2026 Huawei Device Co., Ltd. */

#include <gtest/gtest.h>
#include "disk_info_service.h"

namespace OHOS {
namespace DiskManagement {

class DiskInfoServiceTest : public testing::Test {
protected:
    void SetUp() override {
        service_ = std::make_unique<DiskInfoService>();
        ASSERT_TRUE(service_->Init());
    }

    void TearDown() override {
        service_->Release();
    }

    std::unique_ptr<DiskInfoService> service_;
};

TEST_F(DiskInfoServiceTest, GetDiskList) {
    auto disks = service_->GetDiskList();
    EXPECT_GE(disks.size(), 0u);
}

} // namespace DiskManagement
} // namespace OHOS

错误处理

| 错误类型 | 处理方式 | |----------|----------| | 设计文档格式错误 | 提示具体缺失章节 | | IDL 语法错误 | 标记错误行号，提供正确格式 | | 目录创建失败 | 检查权限，提示用户手动创建 | | 文件已存在 | 使用 --force 覆盖或跳过 |

生成的文件清单

生成完成后，输出文件列表：

[INFO] 代码框架生成完成!
[INFO]
[INFO] 生成的文件：
[INFO]   目录: disk_management/
[INFO]   配置: bundle.json, BUILD.gn, disk_management.gni
[INFO]   SA配置: services/native/5001.json, disk_management.cfg
[INFO]   IDL: interfaces/idl/OHOS/DiskManagement/*.idl
[INFO]   头文件: services/native/include/*.h
[INFO]   源文件: services/native/src/*.cpp
[INFO]   测试: test/unittest/*_test.cpp
[INFO]
[INFO] 总计: 15 个文件, 5 个目录