Chromium 114 CEF Qt for OHOS

原文地址：https://devcloud.cn-north-4.huaweicloud.com/codehub/project/b19f5ea8ffd4492ea8c06ca2ebf3f858/codehub/2843951/home?ref=hw%2Fchromium%2Fohos%2F114.0.5735.248-cef-qt-dev&filePath=README.md&isFile=true

基于 Chromium 114.0.5735.248 版本，集成 CEF (Chromium Embedded Framework) 和 Qt，适配 OHOS (鸿蒙) 平台的浏览器引擎项目。

项目概述

本项目将 Chromium 浏览器引擎移植到 OHOS 平台，提供：

• CEF 集成：支持嵌入式浏览器控件开发
• Qt 支持：可选的 Qt 集成方案
• OHOS 适配：针对鸿蒙系统的原生适配

目录结构

. ├── src/ # Chromium 源代码目录 │ ├── cef/ # CEF 源代码 │ └── ... ├── patch/ # 补丁目录（按日期组织） │ ├── 24_10_18/ │ ├── 24_10_25/ │ └── ... ├── build/ # 构建配置 │ ├── config/ # 构建配置文件 │ │ ├── default.json │ │ └── ohos.json │ └── config_to_gn.py ├── build.sh # 主构建脚本 ├── get_chromium_114.sh # Chromium 源码获取脚本 ├── app_define.json # 应用定义配置 └── VersionSet.xml # 版本配置

环境要求

• OHOS SDK
• BiSheng 编译器（用于 PGO 优化构建）
• depot_tools（Chromium 构建工具）
• ninja 构建系统
• ccache（可选，加速编译）

获取源码

./get_chromium_114.sh

该脚本将：

1. 使用fetch获取 Chromium 源码
2. 切换到 114.0.5735.248 版本
3. 同步依赖

构建说明

基本构建

# 构建 CEF（默认）./build.sh musl_64# 构建 Content Shell./build.sh musl_64-tc# 构建 Chrome./build.sh musl_64-tb

支持的目标平台

构建选项

./build.sh[OPTIONS][PRODUCT]OPTIONS:-jN 指定并行编译任务数-ccache启用 ccache 加速编译-t<target>构建目标: c(content_shell)/ b(chrome)-o<output_dir>指定输出目录-asan启用 AddressSanitizer-dDebug 模式构建-isl启用渲染进程沙箱隔离-h显示帮助信息 PGO 选项: no_pgo 禁用 PGO pgo_instrumentation_phase PGO 数据采集阶段 pgo_optimization_phase PGO 优化阶段（默认）

构建示例

# 使用 32 核并行编译，启用 ccache./build.sh musl_64-j32-ccache# Debug 模式构建./build.sh musl_64-d# 指定输出目录./build.sh musl_64-omy_build

构建输出

编译产物位于src/out/<target>/目录：

• musl_64:src/out/musl_64/

补丁管理

补丁按日期组织在patch/目录下，每个子目录包含：

• chromium_YY_MM_DD.patch- 主补丁文件
• chromium_YY_MM_DD.patch.hwlog- OHOS 日志相关补丁
• *.rejfile- 补丁冲突记录
• *.apply- 补丁应用记录

配置文件

build/config/default.json

默认构建配置，包含 OHOS NWEB 扩展相关设置。

build/config/ohos.json

OHOS 平台特有配置，如拖拽功能等。

许可证

本项目遵循 BSD 风格许可证，详见 LICENSE 文件。

文档

• CEF 嵌入 QT 工程说明文档 - CEF 在 OHOS 平台上与 Qt 集成的详细说明文档
• CEF 离屏渲染指导文档 - Qt + CEF 离屏渲染(OSR)接入指南与Demo解析
• CEF Qt 框架日志说明 - CEF 在 OHOS 平台上的日志查看与分析指南

相关链接

• Chromium 项目
• CEF 项目
• CEF 文档

API 文档

完整的 CEF 114 在 OHOS 平台上的 API 文档：

• API 文档入口
• 全量 API 索引 - 共 1263 个 API（其中 611 个含鸿蒙兼容性说明）