HarmonyOS应用开发 - strip编译配置优先级 原创

概述

文档环境

DevEco Studio 版本：DevEco Studio 6.0.0 Release(6.0.0.858)

SDK 版本：6.0.0 （API20）

功能简介

• strip配置作用：是否移除 .so 文件中的符号表和调试信息，默认配置为true。
• 在编译发布包时，应采用默认配置或设置为true，去除 so 库中的调试信息和符号表，显著减小 so 文件体积。
• 在性能分析（如内存分析或耗时分析）场景中，必须将 strip 字段显式设置为 false。采集函数栈解析符号需要附带符号表信息，无符号表信息可能采集不到函数名称。
• 本文中的配置以DevEco Studio 6.0.0 Release新建工程为例，帮助大家了解strip配置在不同位置的优先级。

strip编译配置优先级

基础配置

不区分Debug包和Release包，不区分Hap包和Har包，默认配置均为true。

{
  "nativeLib": {
    "debugSymbol": {
      "strip": true
    }
  }
}

配置位置

1. 工程级build-profile.json5中product的buildOption。

2. 工程级build-profile.json5中buildModeSet的buildOption。

3. 模块级build-profile.json5中公共buildOption。

4. 模块级build-profile.json5中buildOptionSet。

5. 模块级build-profile.json5中target的config中buildOption。

配置优先级

使用file命令查看so文件是否被stripped

strip: true

strip: false

测试不同位置的配置对最终配置的影响

优先级

1. 模块级target配置 > 模块级buildOptionSet配置> 模块级 buildOption配置 > 工程级product配置 > 工程级buildModeSet配置 。
2. 构建Hap包时，不受依赖的Har包中的配置影响。
3. 构建Hap包和Har包时，只读取所在模块级的build-profile.json5和工程级build-profile.json5。