DB43∕T 2258-2021 信息技术应用创新工程建设规范第 11 部分：迁移适配通用技术要求(湖南省).pdf

《DB43∕T 2258-2021 信息技术应用创新工程建设规范第 11 部分：迁移适配通用技术要求(湖南省).pdf》由会员分享，可在线阅读，更多相关《DB43∕T 2258-2021 信息技术应用创新工程建设规范第 11 部分：迁移适配通用技术要求(湖南省).pdf（23页珍藏版）》请在淘文阁 - 分享文档赚钱的网站上搜索。

1、信息 技 术应 用 创新 工 程建 设 规范第 11部 分：迁移 适 配通 用 技术 要求Engineering specification for the Application Innovation Project of Information TechnologyPart 11:General technical requirements of migration and adaptation 43湖南省地 方标准ICSCCS 01.140.20L 70DB43/T2258 2021 发 布 湖南省 市 场监督管理局 2021-12 发 布-29 2022-03 实 施-29DB43/T

2、 22582021 I 目 次 前言 引言 1 范围 1 2 规 范性 引用 文件 1 3 术 语和 定义 1 4 缩 略语 1 5 应 用软 件迁 移适 配要 求 2 5.1 迁移 适配 评估 2 5.2 编译 型应 用软 件迁 移 适配实 施要 求 2 5.3 解释 型应 用软 件迁 移 适配实 施要 求 3 5.4 存储 位置 要求 3 5.5 权限 要求 3 5.6 安装 脚本 要求 3 5.7 兼容 性要 求 4 5.8 功能 验证 4 5.9 性能 优化 4 6 编 译型 内核 驱动 软件 迁 移适配 要求 5 6.1 迁移 适配 评估 5 6.2 迁移 适配 实施 要求 5 6.

3、3 功能 验证 6 6.4 性能 优化 6 附录A（规 范性）Qt 开 发环境 迁移 7 附录B（规 范性）Gtk 开 发环境 迁移 11 附录C（规 范性）Python 开发 环境 迁移 14 附录D（资 料性）驱动 软件迁 移适 配的 软件 分析 方法 15 DB43/T 22582021 II DB43/T 22582021 III 前 言 本文件 按 照 GB/T 1.1 2020 标 准化 工作 导则 第 1 部 分：标准 化文 件的 结 构和起 草规 则 的规定起草。请注意 本文 件的 某些 内容 可能涉 及专 利。本文 件的 发布机 构不 承担 识别 专利 的责任。信息 技术 应

4、用 创新 工程 建设 规 范 分为 以下 几个 部分：第1 部 分：台式 微型 计算机 通用 技术 要求；第2 部 分：便携 式微 型计算 机通 用技 术要 求；第3 部 分：服务 器通 用技术 要求；第4 部 分：操作 系统 通用技 术要 求；第5 部 分：操作 系统 硬件兼 容性 通用 技术 要求；第6 部 分：操作 系统 软件兼 容性 通用 技术 要求；第7 部 分：办公 套件 通用技 术要 求；第8 部 分：电子 公文 通用技 术要 求；第9 部 分：驱动 开发 通用技 术要 求；第10 部分：应 用开 发 通用技 术要 求；第11 部分：迁 移适 配 通用技 术要 求；第12 部分：

5、国 产化 信 息系统 建 设 质量 管理 规范；第13 部分：国 产化 信 息系统 运行 维护 规范；第14 部分：国 产化 信 息系统 建设 验收 规范；第15 部分：云 计算 通 用技术 要求。本部分 为 第11 部分。本 部分 由湖 南省 国家 密码 管理 局 提出。本 部分 由湖 南省 工业 和信 息化厅 归口。本 部分 起草 单位：银河 麒 麟软件(长沙)有 限公 司、中国人 民解 放军 国防 科技 大学、飞 腾信 息技 术有限公司、湖南 湘江 鲲鹏 信 息科技 有限 责任 公司、湖 南中软 信息 系统 有限 公司、湖 南长 城科 技信 息有 限 公司、湖 南国 科微 电子 股份 有

6、限公 司、长沙 景嘉 微电 子股份 有限 公司、珠 海金 山办公 软件 有限 公司、鹏 城实 验室。本 部分 主要 起草 人：魏 立 峰、吴庆 波、张 铎、孙立 明、彭欢、蒋林 轩、战茅、王晓川、朱浩、王静、谌志华、蔡 威、张月、韩 光、吕 超、董昱、曹 泽文、孙洪 桥、付志 鹏。DB43/T 22582021 IV DB43/T 22582021 V 引 言 湖南省 为深 入贯 彻国 家网 络强国 战略，全 面落 实中 央有关 文件 精神，部 署开 展湖南 省信 息技 术应 用创新工 程建 设，保障 全省 各级党 政机 关关 键信 息基 础设施 信息 安全 和信 息系 统安全 可靠 运行。针

7、 对 自 主可控产 品体 系初 具规 模，但相关 产品 和工 程实 施标 准规范 还很 缺乏 的现 状，为了规 范工 程建 设，加 速 工程进度，扩 大建 设结 果，同时有 力提 升自 主可 控产 业发展 水 平，确 保信 息安 全，由 湖南 省国 家密 码 管 理局作为 业务 主管 单位、湖 南省工 业和 信息 化厅 作为 技术归 口单 位，由 中国 人 民解放 军国 防科 技大 学、中国电子 信息 产业 集团 有限 公司等 单位 与湖 南省 合作 制定了 信 息技 术应 用创 新 工程建 设规 范 地方 标准。信息 技术 应用 创新 工程 建设规 范 主 要由 自主 可 控核心 产品、典型

8、 应用、工程管 理等 方面 的规 范组成，重点 解决 应用 创新 工程建 设当 中产 品选 型、应用开 发、工程 实施 等基 础环节 的实 际问 题，可 为 应用创新 工程 的用 户使 用单 位、集成 建设 单位 和相 关 产品研 制单 位，在 产品 和 应用规 范化、软硬 件兼 容 适配、工 程实 施标 准等 方面 提 供一 般性 指引。信息 技术 应用 创新 工程 建设规 范 未来 将根 据自 主 可控产 业和 应用 创新 工程 的发展 变化 进行 相应的必要 调整 和补 充。DB43/T 22582021 VI DB43/T 22582021 1 信息技术 应用创 新工程建 设规范 第1

9、1 部分：迁移 适配通用 技术要 求 1 范围 本文件 规定 了应 用软 件程 序和设 备驱 动程 序在 不同 操作系 统之 间迁 移适 配的 技术要 求，应用 软件 迁移适配 要求 包括 开发 环境 迁移适 配、代码 重编 译、运行环 境迁 移适 配、存储 位置、权限、安 装脚 本 和 兼容性要 求，设备 驱动 程序 迁移适 配包 括代 码设 计、代码适 配、代码 重编 译、打包、内核 兼容 性等 要求，并提出 迁移 后的 功能 验证 和性 能 优化 要求。本 文件 适用 于指 导信 息技 术应用 创新 工程 建设 中应 用软件 和设 备驱 动程 序在 不同操 作系 统上 的迁移适配 工作，

10、也 为应 用软 件和设 备驱 动程 序迁 移后 的软件 测试 提供 指导。2 规 范性 引用 文件 下列文 件中 的内 容通 过文 中的规 范性 引用 而构 成本 文件必 不可 少的 条款。其 中，注日 期的 引用 文件，仅该日 期对 应的 版本 适用 于本文 件；不注 日期 的引 用文件，其 最新 版本（包 括所有 的修 改单）适 用 于 本文件。DB43/T 1777.6 2020 信 息技术 应用 创新 工程 建设 规范 第 6 部分：操 作系 统软件 兼容 性通 用技术要求 DB43/T 2260 2021 信 息 技术应 用创 新工 程建 设规 范第 9 部 分：驱动 开发 通用技

11、术要 求 DB43/T 22592021 信 息 技术应 用创 新工 程建 设规 范 第 10 部分：应 用开 发 通用技 术要 求 3 术 语和 定义 下列术 语和 定义 适用 于本 文件。3.1 动态链 接库 dynamic link library 是一种 不可 执行 的二 进制 程序文 件，它允 许程 序共 享执行 特殊 任务 所必 需的 代码和 其他 资源。3.2 驱动程 序 driver 驱动程 序是 硬件 厂商 根据 操作系 统编 写的 配置 文件，操作 系统 通过 驱动 来与 控制设 备和 进行 通 信。3.3 版本魔 术信 息 vermagic information 版本魔

12、 术信 息是 一个 描述 内核版 本号 以及 基础 内核 配置的 字符 串。4 缩 略语 下列缩 略语 适用 于本 文件：DB43/T 22582021 2 CRC：循环 冗余 校验（Cyclic Redundancy Check）DKMS：动态 内核 模块 支持（Dynamic Kernel Module Support）GDK：图形 开发 工具 包（Graphics Development Kit）GPU：图形 处理 器（Graphics Processing Unit）GTK：跨多 种平 台 的 图形 工 具包（GIMP Toolkit）5 应 用软 件迁 移适 配要 求 5.1 迁移

13、适配 评估 在迁移 适配 工作 开始 之前，应按 以下 要求 进行 迁移 适配评 估：a）迁移软件源 码 分 析：分 析 迁 移 软 件 的 主 要 功 能 和 模 块 组 成，建 立 功 能 模 块 与 功 能 实 现 的映射关系；b）基础 运行 环 境 分 析：分 析 迁 移 软 件 所 在 源 平 台 和 目 标 平 台 的 开发 环境、运行环 境、开 发规 范以及处 理器 指令 集的 差异，评估 这些 差异 对迁 移软 件代码 的影 响；c）第 三方 软 件 栈 分 析：分 析 目 标 平 台 上 的 第 三方 软件栈（包 括数 据库、中 间件、办公 套件、浏览器等）数 据、二次 开发

14、 接口、操作 习惯 等是 否兼 容，确 定可 以重 用、需要 迁移改 造的 功能 模块和代 码段 范围，确 定迁 移适配 的技 术路 线；d）迁移 适 配 工 作 量 评 估：根 据 迁 移 适 配 可 能 的 技 术 路 线，从 技 术 方 案 和 管 理 实 施等 角度评 估不同组 合的 迁移 工作 量、复杂度 和成 本；e）迁 移环 境准 备：主要 包括硬 件设 备、操作 系统 以及调 试工 具等 的准 备和 部署。5.2 编译 型应 用软 件迁 移 适配实 施要 求 5.2.1 开 发环 境迁 移适 配 要求 a）应分 析应 用 软 件 的 架 构 和 实 现 技 术、与 操 作 系

15、统 平 台的 耦合 度和 依赖 度，确 定迁 移所 涉及 的各类系 统机 制；b）将 与系 统调 用无 关的 部分代 码进 行剥 离，在国 产操 作 系统 环境 下重 建工 程，重 用代 码；c）根据软件分析中运行环境、开发环境和接口的差 异进 行代 码修 改，实 现 与原系 统相 同的 软件功能，例如Qt 项目 迁移，当前主 要 从 Qt4 迁移 到 Qt5，具 体迁 移参 照表 应符 合 附录 A 的规 定；Gtk 迁 移主 要从gtk2 迁移到 gtk3，具体 内容 应符 合 附录 B 的规 定。5.2.2 代 码重 编译 要求 代码重 新编 译时，应 对编 译脚本 和编 译选 项进 行

16、移 植，将 编译 脚本 和编 译选 项更改 为目 标体 系结 构支持的 编译 脚本 和编 译选 项。生 成软 件包 时，命名 和打包 规范 应按 照 DB43/T 1777.6 2020 中6.5 节要求执行。5.2.3 运 行环 境迁 移适 配 要求 应用软 件运 行前 应确 认所 依赖的 第三 方运 行库 是否 存在，如缺 少对 应的 动态 链接库，应 针对 不同 的操作系 统查 找和 安装 动态 链接库 对应 的软 件包。在采 用Deb 格式 软件 包的 操作系 统中，可 通过 执行“apt-file search 动态 库 名”的 方式 来查 找指定的动 态链 接库 所对 应的 软件包

17、；在采 用 RPM 格 式 软件包 的操 作系 统中，可 通过“yum whatprovides 动态库名”的方 式来 查找 指 定的动 态链 接库 所对 应的 软件包。找到 对应 的动 态 库包之 后，可 通过 操作 系 统DB43/T 22582021 3 厂商提 供的 软件 源进 行下 载和安 装。如已安装动态 链 接 库 软 件 包 但 是 链 接 地 址 错 误，可 以 通 过 将 动 态 链 接 库 所 在 的 目 录 路 径 添 加 到LD_LIBRARY_PATH 环 境变 量或者 系统 指定 的链 接库 配置文 件/etc/ld.so.conf 的方 式进 行修 复。5.3

18、解释 型应 用软 件迁 移 适配实 施要 求 解释型 应用 软件 可在 操作 系统环 境下 直接 运行，具 有较好 的跨 平台 可移 植性，大部 分软 件无 需修 改源代码，迁 移工 作量 相对 较小。但针 对以 下情 况，应进行 少量 修改 并重 新编 译：a）当目 标 平 台 和 移 植 前 的 环 境 不 一 致 时，则 需 根 据版本 差异，修改 源代 码 中库和 接口 的调 用相关部分，例 如 Python 应用 程序，目前 主要 从 python2 迁移 到 python3，迁 移后 应注意 语法 变化和迁 移时 宜使 用的 工具，应符 合附件 C 的要 求；b）如果通过 JNI

19、或其他形式调用 的 库是 采用 C/C+等编 译型 语言 开发，则 被 调用库 的代 码需 按照5.2 节重 新编 译或 修改；c）对软 件 运 行 需 要 的 第 三 方 软 件 栈，包括 第三方 国产数据库、中间件、办 公套件、浏览 器等软件栈进 行迁 移和 替换；d）系 统运 行时 如 缺 少 对 应 的 动 态 链 接 库，则 需 要 针对不 同的 国产 操作 系统，按照 5.2.3 节寻 找和安装 对应 的动 态库 包。5.4 存储 位置 要求 应用软 件可 执行 程序、动 态库、配置 文件、数 据文 件、缓 存文 件的 存储 位置，应符 合 DB43/T 22592021 第6 章

20、 的要 求。5.5 权限 要求 5.5.1 权 限分 离要 求 具有前 端交 互逻 辑的 应用 软件的 可执 行程 序，应以 普通用 户权 限运 行，不应 使用 sudo、pkexec 等命令来 提权 运行。具有前 端交 互逻 辑的 应用 软件的 可执 行程 序，如果 需要特 权态 执行 某些 操作，应使 用前 后端 分离 的方式实 现，通 过 dbus 等 技 术与后 端具 有管 理员 权限 的服务 端通 讯，实现 相关 功能。5.5.2 权 限提 升要 求时 用 户鉴别 要求 前端应 用程 序使 用 dbus 等 技术与 后端 具备 管理 员权 限的服 务通 讯时，应 使 用 policy

21、kit 等技 术进行身份 鉴别，用 于确 定用 户是否 具备 该项 行为 的权 限。5.6 安装 脚本 要求 a）宜将维护者 脚本作 为 软 件 包 的 一 部 分，当 安 装、升级、移除 软件包时，软件包管理系 统会自动执行 这些 脚本；b）维护 者 脚 本 应 是 可 执 行 文 件，以#!符 号 开 头，且 这 些 脚 本 应是 可读 的，可被任 何人 执行，不应全局 可写；c）包 管理 系统 可查 看维 护者脚 本的 退出 状态，如 果脚本 运行 错误，应 返回 一个非 零值；如 果脚 本运行正 常，应返 回零 值；d）用户 与 软 件 包 通 过 维 护 者 脚 本 中 的 配 置

22、文 件 进 行 交 互 时，应 先 安 装 一 个 配 置 脚 本 作 为 控 制信息文 件；e）升 级软件包 时，包 管 理 系 统 将 调 用 旧 版 本 和 新 版 本 软 件 包 中 的 脚 本 组 合，用 户 应 检 查 参数DB43/T 22582021 4 以保证 正确 性；f）在软件包 解 压 之 前 应 先 为 正 在 被 升 级 的 包 停 止 相 关 服 务，然 后 完成所需 的 配 置 工 作；在移除软件 包之前，应先 停止 一个软 件包的 相关 进程，然后修 改相关 文件 或连接,和/或卸 载软 件包所创 建的 文件；g）维 护者 脚本 调用 的程 序不应 在程 序名

23、 前添 加路 径，其 路径 会设 置 在PATH 环境变 量中。5.7 兼容 性要 求 5.7.1 与 操作 系统 解耦 要 求 应用软 件不 应依 赖操 作系 统提供 的任 何动 态链 接库（除基 础 C 库外）。应用软 件不 应直 接修 改操 作系统 提供 的配 置文 件，宜通过 操作 系统 提供 的接 口来修 改。部分 系统 配置可通 过新 增高 优先 级配 置文件 来进 行配 置覆 盖，新增的 配置 文件 以“两 位 数字-应用 名.conf”的 形 式命名。5.7.2 动 态库 依赖 自包 含 要求 应 用 软 件所 使 用的 动 态链接 库 应 尽量 独 立于 操 作系统，应 用软

24、 件 所依 赖 的动态 链 接 库（除 基础 C库外）应放 置在 自设 置 的lib 目 录中。5.8 功能 验证 应用软 件迁 移适 配后，应 进行以 下功 能验 证：a）按 照应 用软 件的 功能 点逐一 进行 功能 测试，保 证迁移 后的 系统 与原 有系 统功能 一致；b）检 查迁 移后 应用 软件 的用户 界面，是 否符 合通 用规范，是 否符 合美 观性 和易用 性；c）检 查迁 移后 应用 软件 的安全 性，是否 与原 有系 统具有 相同 的安 全性；d）检 查迁 移后 应用 软件 的容错 性，是否 与原 有系 统具有 相同 的容 错性；e）检查 应 用 软 件 在 不 同 平

25、台 的 安 装 配 置 能 力，检 查 在 不 同 平 台、不 同 配 置 下 应 用 软 件 的 适配 性；f）与 原有 系统 集成 适配 验证；g）用 户使 用场 景验 证。5.9 性能 优化 迁移适 配时，应 通过 数据 采集、瓶颈 分析、问 题定 位、策 略优 化、修改 验证5 个过 程的 多次 迭代 进行性能 优化，使 应用 软件 迁移后 的性 能不 低于 迁移 前的性 能。迁移 过程 包含 以下内 容：a）数 据采集：通过设 置 Web 会话、线程、CPU、I/O、网络、内存等数据采集点，持续 采集 应用软件 的运 行数 据，同时 根据性 能指 标评 估体 系，对应用 软件 性能

26、指标 采集 性能评 估数 据；b）瓶颈 分 析：对 采 集 到 的 数 据 开 展 分 析，对 耗 时 较 多 部 分，运 用 时 间 切 片 工 具进行 分析，找出消耗 量大 的资 源；c）问题定 位：使 用 运 行 监 控 分 析 工 具 分 析 资 源 消 耗 较 大 的 原 因，可 从 线 程、内 存等 层面 逐步定位问 题；d）策略优 化：建 立 用 于 性 能 优 化 的 专 家 知 识 库，提 供 系 统 性 建 议，为 快 速 解 决 问 题 提供依据和建议 方案；e）修 改验 证：实施 建议 方案并 进行 效果 验证，确 保问题 得到 解决；f）宜通过 loadrunner、

27、JMeter 等 性能测 试工 具分 析应用 软件 的性 能，分析 比对找 出瓶 颈并 进 行优化。DB43/T 22582021 5 6 编 译型 内核 驱动 软件 迁 移适配 要求 6.1 迁移 适配 评估 在迁移 适配 工作 开始 之前，应按 以下 要求 进行 迁移 适配评 估：a）软件分析：应 从 适 配 性、规 范 性 以 及 体 系 结 构 相 关 代 码 三 个 方 面 进 行 分 析，初 步 得 到 了代码的移 植范 围。具体 的软 件分析 方法 见附 录D；b）技术路线选 定：应 根 据 软 件 分 析 的 成 果，按 照 尽 量 少 地 对 驱 动 程 序 进 行 修 改

28、的 原 则 设 计 迁移技术 路线，以 满足 驱动 的兼容 性要 求；c）工 作量 评估：应结合关键性、性 能、复 杂 处 理、体 系 结 构 支持 等对 工作 量进行 加权，获 取较为科学 的工 作量，并 根据 这个工 作量 以及 工作 计划 要求来 合理 配置 研发 人员 和测试 人员；d）迁 移环 境准 备：主要 包括硬 件设 备、操作 系统 以及测 试验 证工 具的 准备 和部署。6.2 迁移 适配 实施 要求 6.2.1 代 码设 计要 求 驱动程 序宜 进行 合理 的代 码层次 分离，分 为内 核框 架层和 核心 代码 逻辑 层，其中内 核框 架层 实现 驱动程序 内核 与 Lin

29、ux 内核 进行对 接的 部分，调 用 Linux 提 供的 API 接口 函数 和 数据结 构，这部 分随 着内核的升 级而 变化，需 要重 编译；核心 代码 逻辑 层实 现驱动 程序 的核 心功 能，比如读 硬件 寄存 器的 操作、核心算 法等，通 过内 核框 架层代 码挂 接 入 Linux 内 核。6.2.2 代 码编 写要 求 代码编 写应 符合 以下 适配 要求：a）驱 动程 序中 应加 入驱 动签名，增 加作 者和 许可 证等签 名信 息；b）应根据内核和相关依赖模块的接口变化模块校验信息和模块版本控制信息，修改驱动程序接口，保证 符号 表、模块 校验信 息和 模块 版本 控制

30、信息等 与当 前系 统的 匹配；c）应 对驱 动程 序代 码中 的体系 结构 相关 指令、嵌 入式汇 编函 数和 编译 宏进 行替换。为了保 证 Linux 内 核升 级 时驱动 程序 内部 调用 的符 号可用，应 遵 循 DB43/T 2260.1 2021 中 5.1节规定 的原 则。6.2.3 代 码重 编译 要求 代码重 新编 译时，应 对编 译脚本 和编 译选 项进 行移 植，将 编译 脚本 和编 译选 项更改 为目 标体 系结 构支持的 编译 脚本 和编 译选 项。6.2.4 打 包要 求 为了减 少 Linux 内核 升级 导致设 备驱 动程 序重 新编 译的工 作量，驱 动程

31、序打 包时宜 采 用 DKMS 内核模块打 包方 式，内核 模块 打包应 符 合 DB43/T 2260 2021 中第 6.6 节 要求。6.2.5 内 核兼 容性 要求 6.2.5.1 导出 符号 的CRC 信息 设备驱 动程 序所 使用 的导 出符号 的 CRC 信 息应 与内 核中所 记录 的对 应符号的CRC 信 息保 持一 致，以确保设 备驱 动程 序和 内核 的兼容 性。DB43/T 22582021 6 6.2.5.2 多内 核版 本兼 容 若 识 别 驱动 程 序需 同 时兼容 多 个 内核 版 本，驱 动程序 中 应 包含 对 所兼 容 的内核 版 本 的相 关 判断 逻辑

32、。6.3 功能 验证 驱动程 序迁 移适 配后，应 进行以 下功 能验 证：a）按 照驱 动程 序的 功能 点逐一 进行 功能 测试，保 证迁移 后的 驱动 与原 有功 能一致；b）检 查内 核能 否正 常加 载驱动 程序；c）检 查驱 动程 序在 不同 平台的 安装 配置 能力，检 查在不 同平 台、不同 配置 下驱动 程序 的适 配 性；d）若 发现 问题，应 跟踪 系统日 志，分析 问题 产生 的原因 并进 行相 应 的 修改，然后 进行 回归 测试，直到通 过所 有的 功能 测试。6.4 性能 优化 迁移适 配时，应 根据 应用 场景和 体系 结构 对操 作系 统参数 配置 进行 优化

33、，包 含以下 内容：a）在 工作 场景（比如 高 速网卡 的高 并发 访问、GPU 显卡 的实 时虚 拟化 等）下，应 对通用 场景 下的默认系 统参 数重 新进 行优 化配置；b）宜 通过 修改 内核 源码 目录 下 etc 目录 中的 配置 文件 sysctl.conf 来 实现 配置优 化；c）针 对特 定的 国产 处理 器，宜 根据 处理 器的 拓扑、核数、工作 频率 等，对 设备、驱动 程序、应用软件等 的工 作方 式进 行针 对性优 化；d）宜利用 ftrace、kprobe、kgdb、systemtap 等内 核调试 工具 分析 驱动 程序 代码的 执行 效率，分析比对 找出 瓶

34、颈 并进 行优 化。DB43/T 22582021 7 附 录 A（规范 性）Qt 开 发环 境迁 移 Qt 项 目迁 移前 应配 置项 目 所需 的 Qt 模 块，包括 提 供 GUI 程序 基本 功能 的 qtbase 基础 模块，提 供渲染和 创 建 svg 文件 功能 的qtsvg，以及 提供 脚本 化机制 的 qtscript 等扩 展 模块。Qt 迁 移应 包括 头文 件迁 移、函 数迁 移、类迁 移、常量 迁移、模 块迁移、webkit 头文件 迁移 和 webkit类迁移。A.1 Qt 头 文件 迁移 Qt4 和Qt5 的头 文件 迁移 参照表 见 表 A.1。表A.1 头 文

35、件 迁移 参照 表 Qt4 Qt5 QtGui QtWidgets QtWebKit QtWebKitWidgets QWorkspace QMdiArea A.2 Qt 函 数迁 移 Qt4 和Qt5 的函 数迁 移参 照表见 表 A.2，Qt5 缺失 的 函数应 修改 迁移 软件 源代 码实现 程序 逻辑。表A.2 函 数迁 移参 照表 模 块名 Qt4 Qt5 QtCore qInstallMsgHandler()qInstallMessageHandler()QAction:setSoftKeyRole()无 QAction:softKeyRole()无 QChar:joining()

36、QChar:joiningType()QCoreApplication:setEventFilter()QCoreApplication:installNativeEventFilter()QApplication:type()无 QAbstractItemModel:setRoleNames()QAbstractItemModel:roleNames()QDate:setYMD()QDate:setDate()Qt GUI QDesktopServices:storageLocation()QStandardPaths:writableLocation()QDesktopServices:d

37、isplayName()QStandardPaths:displayName()QPixmap:grabWindow()QPixmap:grabWidget()QScreen:grabWindow()commitData()QGuiApplication:commitDataRequest()QWidget*widget()QObject*target()DB43/T 22582021 8 表A.2 函 数迁 移参 照表（续）模 块名 Qt4 Qt5 Qt Widgets QInputDialog:getInteger()QInputDialog:getInt()QHeaderView:set

38、Movable(bool movable)QHeaderView:setSectionsMovable()QHeaderView:isMovable()QHeaderView:sectionsMovable()QHeaderView:setClickable(bool clickable)QHeaderView:setSectionsClickable()QHeaderView:isClickable()QHeaderView:sectionsClickable()QHeaderView:setResizeMode(int logicalindex,ResizeMode mode)QHeade

39、rView:setSectionResizeMode()QHeaderView:resizeMode(int logicalindex)QHeaderView:sectionResizeMode()Qt Network QNetworkConfiguration:bearerName()QNetworkConfiguration:bearerTypeName()QSslCertificate:isValid()QSslCertificate:isBlacklisted()QSslCertificate:alternateSubjectNames()QSslCertificate:subject

40、AlternativeNames()Qt Test QTest:qt_snprintf()QByteArray:qsnprintf()QTest:qWaitForWindowShown()QTest:qWaitForWindowExposed()Qt Global qMacVersion()QSysInfo:macVersion()QSysInfo:MacintoshVersion Qt:escape()QString:toHtmlEscaped()A.3 Qt 类 迁移 Qt4 和Qt5 类迁 移见 表A.3。表 A.3 类 迁移 参照 表 模 块名 Qt4 Qt5 QtCore QSyst

41、emLocale QLocale QPointer QWeakPointer Qt GUI QIconEngineV2 QIconEngine Qt Widgets QProxyModel QAbstractProxyModel Qt Network QHttp QHttpHeader,QHttpResponseHeader,QHttpRequestHeader QNetworkAccessManager QFtp QUrlInfo QNetworkAccessManager Qt OpenGL QGLPixelBuffer QOpenGLFramebufferObject A.4 Qt 常

42、量迁 移 Qt4 和Qt5 常量 迁移 见表A.4，Qt5 缺 失的 常量 应修 改迁移 软件 源代 码实 现程 序逻辑。DB43/T 22582021 9 表A.4 常 量迁 移参 照表 模 块名 Qt4 Qt5 QtCore Qt:WFlags Qt:WindowFlags QAction:SoftKeyRole 无 Qt:WA_MergeSoftkeys 无 Qt:WA_MergeSoftkeysRecursively 无 Qt:WindowSoftkeysVisibleHint 无 Qt:WindowSoftkeysRespondHint 无 QChar:Joining QChar:J

43、oiningType QEvent:AccessibilityPrepare 无 QEvent:AccessibilityHelp 无 QEvent:AccessibilityDescription 无 QDir:convertSeparators()QDir:toNativeSeparators()QDir:NoDotAndDotDot QDir:NoDot QDir:NoDotDot A.5 Qt 模 块迁 移 Qt4 和Qt5 模块 迁移 见表A.5。表A.5 模 块迁 移参 照表 Qt4 Qt5 QtCore QtCore QtConcurrent QtGui QtGui QtWidg

44、ets A.6 webkit 头 文件 迁移 webkit 到webengine 头 文 件迁移 见 表 A.6。表 A.6 webkit 到 webengine 头 文件 迁移 参照 表 Qt WebKit Qt WebEngine QWebHistory QWebEngineHistory QWebHistoryItem QWebEngineHistoryItem QWebPage QWebEnginePage QWebView QWebEngineView A.7 webkit 类 迁移 webkit 到webengine 类 迁 移对照 见 表 A.7。DB43/T 22582021

45、10 表 A.7 webkit 到 webengine 类 迁移 参照 表 Qt WebKit Qt WebEngine QWebHistory QWebEngineHistory QWebHistoryItem QWebEngineHistoryItem QWebPage QWebFrame QWebEnginePage QWebView QWebEngineView DB43/T 22582021 11 附 录 B（规范 性）Gtk 开 发环 境迁 移 B.1 开发 者在 已有 的gtk2 项目 中应 做的 适配 a）开 发者 不得 引用 无效 头文件 gtk3 规定 的可 引用 的头 文

46、 件见 表 B.1。表B.1 gtk3 中 可引 用的 头文件 头 文件名 用途 gtk/gtk.h GTK gtk/gtkx.h X 类 widgets GtkSocket 和 GtkPlug gtk/gtkunixprint.h 底层的、UNIX 的打印函数 gdk/gdk.h GDK gdk/gdkx.h X11 的 GDK 函数 gdk/gdkwin32.h Windows 的 GDK 函数 使用make CFLAGS+=-DGTK_DISABLE_SINGLE_INCLUDES 去 除无 效头 文件。b）应 去除 已弃 用符 号 使用 make CFLAGS+=-DGDK_DISAB

47、LE_DEPRECATED-DGTK_DISABLE_DEPRECATED 定义去除已弃用 符号。c）应 使用 已有 的访 问接 口，不 得直 接访 问gtk 对象 使用make CFLAGS+=-DGSEAL_ENABLE 去 除无 效接 口。d）应把 GDK_ 替换为 GDK_KEY_ e）应通过 GIO 打开 外部 程序 f）应通过 cairo 进 行绘 制 GdkGC 和 GdkImage 对象 不 能继续 使用。g）其他 1）开 发者 不应 继续 使 用GdkBitmap 位图 操作，宜 使用 cairo_mask()实现 相 同效果；2）开 发者 不应 继续 使 用gdk_draw

48、_drawable()，宜 使用 cairo_push_group()实现相 同效 果；3）开 发者 应使 用pango_cairo_show_layout()替换 gdk_draw_layout_with_colors()；4）开 发 者 应 使 用pango_cairo_layout_path()和cairo_fill()替换gdk_draw_layout_with_colors()。B.2 开发 者将 程序 代码 向gtk3 迁 移应 做的 适配 a）开 发者 应使 用get_preferred_width/height 替换 size_request；b）开 发者 应使 用以 下cai

49、ro 接 口进 行GDK 功 能替 换，见 表 B.2；DB43/T 22582021 12 表B.2 替换 GDK 功 能的cairo 接口 GDK cairo GdkRegion cairo_region_t GdkRectangle cairo_rectangle_int_t gdk_rectangle_intersect()函数一致 gdk_rectangle_union()函数一致 gdk_region_new()cairo_region_create()gdk_region_copy()cairo_region_copy()gdk_region_destroy()cairo_reg

50、ion_destroy()gdk_region_rectangle()cairo_region_create_rectangle()gdk_region_get_clipbox()cairo_region_get_extents()gdk_region_get_rectangles()cairo_region_num_rectangles()和cairo_region_get_rectangle()gdk_region_empty()cairo_region_is_empty()gdk_region_equal()cairo_region_equal()gdk_region_point_in(