鸿蒙5.0开发进阶:配置文件(模块级build-profile.json5文件)

HarmonyOS—配置编译构建信息 ,才是我创造的动力。关注我,同时可以期待后续文章ing,不定期分享原创知识。想要获取更多完整鸿蒙最新VIP学习资料,请点击→《鸿蒙 (Harmony OS)开发学习手册。 阅读详情

往期鸿蒙5.0全套实战文章必看:(文中附带全栈鸿蒙5.0学习资料)


模块级build-profile.json5文件

配置文件结构

模块级build-profile.json5文件整体的结构如下。

apiType
targets
└── name
└── runtimeOS
└── config
    └── distroFilter / distributionFilter
        └── apiVersion
            └── policy
            └── value
        └── screenShape
            └── policy
            └── value
        └── screenWindow
            └── policy
            └── value
        └── screenDensity
            └── policy
            └── value
        └── countryCode
            └── policy
            └── value
    └── deviceType
    └── buildOption
    └── atomicService
        └── preloads
            └── moduleName
└── source
    └── abilities
        └── name
        └── pages
        └── res
        └── icon
        └── label
        └── launchType
    └── pages
    └── sourceRoots
└── resource
    └── directories
└── output
    └── artifactName
showInServiceCenter
buildOption
buildOptionSet
└── name
└── debuggable
└── copyFrom
└── resOptions
    └── compression
        └── media
            └── enable
        └── filters
            └── method
                └── type
                └── blocks
            └── files
                └── path
                └── size
                └── resolution
            └── exclude
                └── path
                └── size
                └── resolution
    └── copyCodeResource
        └── enable
        └── excludes
└── externalNativeOptions
    └── path
    └── abiFilters
    └── arguments
    └── cppFlags
    └── cFlags
    └── targets
└── sourceOption
    └── workers
└── nativeLib
    └── filter
        └── excludes
        └── pickFirsts
        └── pickLasts
        └── enableOverride
        └── select
            └── package
            └── version
            └── include
            └── exclude
    └── debugSymbol
        └── strip
        └── exclude
    └── headerPath
    └── collectAllLibs
    └── excludeFromHar
    └── excludeSoFromInterfaceHar
    └── librariesInfo
        └── name
        └── linkLibraries
└── napiLibFilterOption
    └── excludes
    └── pickFirsts
    └── pickLasts
    └── enableOverride
└── arkOptions
    └── runtimeOnly  
        └── sources  
        └── packages  
    └── types  
    └── obfuscation
        └── ruleOptions
            └── enable
            └── files
        └── consumerFiles
    └── buildProfileFields
    └── integratedHsp
    └── transformLib
    └── branchElimination
    └── byteCodeHar
    └── bundledDependencies
    └── autoLazyImport
    └── apPath
    └── hostPGO
└── removePermissions
    └── name
buildModeBinder
└── buildModeName
└── mappings
    └── targetName
    └── buildOptionName
entryModules

配置文件字段说明

下表为"Ability"类型的Module(HAP)对应的模块级build-profile.json5中配置项包含的字段,"Library"类型的Module(HAR和HSP)对应的模块级build-profile.json5中配置项为下表罗列范围的子集。

表1 模块级build-profile.json5文件字段说明

字段名称

类型

是否必选

含义

apiType

字符串

可选

API模型类型:

  • stageMode:Stage模型,后续长期演进的模型,推荐使用该模型。
  • faMode:FA模型。

targets

对象数组

可选

定义的target,可配置多个;若配置,数组长度至少为1。

showInServiceCenter

布尔值

可选

是否显示在服务中心:

  • true:显示。
  • false(缺省默认值):不显示。

buildOption

对象

可选

模块在构建过程中的相关配置。

其中不支持配置name、debuggable和copyFrom字段。

在FA模型中,arkOptions配置中仅支持配置types字段。

buildOptionSet

对象数组

可选

表16buildOption的集合,其中name字段必填,每个配置都是当前支持的编译过程中所有可用工具的通用配置选项集。

buildModeBinder

对象数组

可选

构建模式(debug、release 等)与构建配置(buildOption)的关联配置。通过该配置可以将不同的构建配置和target进行组合,并绑定到对应的构建模式上,其中构建模式需要在工程级别的构建模式列表中已定义。

entryModules

字符串数组

可选

Feature类型模块所关联的入口模块。

targets

targets用于给模块配置多目标产物,可配置多个;若配置,数组长度至少为1。

表2 targets

字段名称

类型

是否必选

含义

name

字符串

必选

target名称。

runtimeOS

字符串

可选

target的目标运行环境:

  • HarmonyOS
  • OpenHarmony

config

对象

可选

target相关配置。

source

对象

可选

target的源码范围。

resource

对象

可选

target包含的资源目录。

output

对象

可选

定制产品生成的应用包的配置。

表3 resource

字段名称

类型

是否必选

含义

directories

array

可选

资源目录地址。

表4 output

字段名称

类型

是否必选

含义

artifactName

string

必选

自定义产品生成的应用包名称,可由数字、英文字母、中划线、下划线和英文句号(.)组成,支持输入版本号。

targets字段示例:

"targets": [
  {
    "name": "default",
    "resource": {
      "directories": ["./src/main/resources"]
    },
    "output": {
      "artifactName": "customizedTargetOutputName-1.0.0"
    }
  }
]

config

config是target相关配置。

表5 config

字段名称

类型

是否必选

含义

distroFilter

对象

可选

应用市场分发规则。在FA模型中使用。

distributionFilter

对象

可选

应用市场分发规则。在Stage模型中使用。

deviceType

字符串数组

可选

target支持的设备类型,必须在module.json5中已定义。

在FA模型中,对应的文件为config.json。

buildOption

对象

可选

模块在构建过程中的相关配置。

其中不支持配置name、debuggable和copyFrom字段。

atomicService

对象

可选

元服务相关配置,仅支持在Stage模型中配置。

source

source用于指定target的源码范围。

表6 source

字段名称

类型

是否必选

含义

abilities

对象数组

可选

自定义target的能力范围。

在FA模型工程中支持对Ability源码目录下的page页面进行定制。

pages

字符串数组

可选

Stage模型工程中支持对pages源码目录的page页面进行定制,数组长度至少为1。

sourceRoots

字符串数组

可选

Stage模型工程中支持对差异化代码空间进行定制,数组长度至少为1。数组中的值有以下限制:

  1. 必须唯一;
  2. 必须为相对路径;
  3. 类型必须为文件夹;
  4. 文件夹必须真实存在;
  5. 文件夹必须与src/main同级;

当数组中存在多个值时,寻址的优先级为数组中值的顺序。

source字段示例:

"targets": [
  {
    "name": "default",
    "source": {
       "pages": [         // Stage模型
        "pages/Index"
      ],
      "abilities": [     // FA模型
        {
          "name": ".MainAbility",
          "pages": [
            "pages/index"
          ]
        }
      ],
      "sourceRoots": [
        "./src/default"
      ]
    }
  }
]

distroFilter/distributionFilter

distroFilter/distributionFilter用于指定应用市场分发规则,distroFilter在FA模型中使用,distributionFilter在Stage模型中使用。

表7 distroFilter/distributionFilter

字段名称

类型

是否必选

含义

apiVersion

对象

可选

支持的apiVersion范围。

screenShape

对象

可选

屏幕形状的支持策略。

screenWindow

对象

可选

应用运行时窗口的分辨率支持策略。

screenDensity

对象

可选

屏幕的像素密度支持策略。

countryCode

对象

可选

应用需要分发的国家地区码。

apiVersion

表8 apiVersion

字段名称

类型

是否必选

含义

policy

字符串

必选

取值规则:

  • include:需要包含的value属性。
  • exclude:需要排除的value属性。

value

整型数组

必选

支持的取值为API Version存在的整数值,例如10。

screenShape

表9 screenShape

字段名称

类型

是否必选

含义

policy

字符串

必选

取值规则:

  • include:需要包含的value属性。
  • exclude:需要排除的value属性。

value

字符串数组

必选

支持的取值范围:

  • circle:圆形
  • rect:矩形

screenWindow

表10 screenWindow

字段名称

类型

是否必选

含义

policy

字符串

必选

当前取值仅支持“include”。

  • include:需要包含的value属性。

value

字符串数组

必选

单个字符串的取值格式为“宽*高”,取值为整数像素值,例如"454*454"。

screenDensity

表11 screenDensity

字段名称

类型

是否必选

含义

policy

字符串

必选

取值规则:

  • include:需要包含的value属性。
  • exclude:需要排除的value属性。

value

字符串数组

必选

取值范围:

  • sdpi:小规模的屏幕密度(Small-scale Dots per Inch),适用于dpi取值为(0,120]的设备。
  • mdpi:中规模的屏幕密度(Medium-scale Dots Per Inch),适用于dpi取值为(120,160]的设备。
  • ldpi:大规模的屏幕密度(Large-scale Dots Per Inch),适用于dpi取值为(160,240]的设备。
  • xldpi:大规模的屏幕密度(Extra Large-scale Dots Per Inch),适用于dpi取值为(240,320]的设备。
  • xxldpi:大规模的屏幕密度(Extra Extra Large-scale Dots Per Inch),适用于dpi取值为(320,480]的设备。
  • xxxldpi:表示大规模的屏幕密度(Extra Extra Extra Large-scale Dots Per Inch),适用于dpi取值为(480, 640]的设备。

countryCode

表12 countryCode

字段名称

类型

是否必选

含义

policy

字符串

必选

取值规则:

  • include:需要包含的value属性。
  • exclude:需要排除的value属性。

value

字符串数组

必选

国家地区码取值,具体值以ISO-3166-1标准为准。支持多个国家和地区枚举定义。

distroFilter/distributionFilter字段示例:

"targets": [
  {
    "name": "default",
    "config": {
      "distributionFilter": {
        "apiVersion": {
          "policy": "include",
          "value": [12]
        },
        "screenShape": {
          "policy": "include",
          "value": [
            "circle",
            "rect"
          ]
        },
        "screenWindow": {
          "policy": "include",
          "value": [
            "454*454",
            "466*466"
          ]
        },
        "screenDensity": {
          "policy": "exclude",
          "value": [
            "ldpi",
            "xldpi"
          ]
        },
        "countryCode": {
          "policy": "include",
          "value": [
            "CN"
          ]
        }
      }
    },
  }
]

atomicService

表13 atomicService

字段名称

类型

是否必选

含义

preloads

对象数组

可选

定义当前模块运行时预加载的模块。

表14 preloads

字段名称

类型

是否必选

含义

moduleName

字符串

可选

预加载的模块名称。

atomicService字段示例:

"targets": [
  {
    "name": "default",
    "config": {
      "atomicService": {
        "preloads": [
          {
            "moduleName": "preloadSharedLibrary"
          }
        ]
      }
    }
  }
]

abilities

abilities用于自定义target的能力范围。

表15 abilities

字段名称

类型

是否必选

含义

name

字符串

必选

指定target选择的ability的名称。

pages

字符串数组

可选

FA模型中,指定target选择的ability的page。

res

字符串数组

可选

指定资源目录。

icon

字符串

可选

指定ability图标文件的索引,格式为"$media:ability_icon"。

label

字符串

可选

指定对用户可见的名称,要求采用该名称的资源索引,以支持多语言。

launchType

字符串

可选

指定ability的启动模式:

  • multiton:多实例模式,每次启动创建一个新实例。
  • standard:同multiton,建议使用multiton替代。
  • singleton(缺省默认值):单实例模式,仅第一次启动创建新实例。
  • specified:指定实例模式,运行时由开发者决定是否创建新实例。

abilities字段示例:

"targets": [
  {
    "name": "default",
    "source": {
      "abilities": [
        {
          "name": "EntryAbility",
          "icon": "$media:layered_image",
          "label": "$string:EntryAbility_label",
          "launchType": "singleton"
        }
      ]
    }
  }
]

buildOption

buildOption是模块在构建过程中的相关配置,buildOptionSet和targets中也支持配置buildOption。此外,工程级build-profile.json5中也支持配置buildOption。工程级别buildOption配置会与模块级别的buildOption进行合并。

表16 buildOption

字段名称

类型

是否必选

含义

name

字符串

可选

构建配置方案buildOption的名称。

debuggable

布尔值

可选

当前编译产物是否为可调试模式(debug):

  • true(缺省默认值):可调试。
  • false:不可调试。

当使用release的构建模式时,默认为false。

copyFrom

字符串

可选

配置已定义的buildOption的name,表示从本模块已有的buildOption复制配置。

resOptions

对象

可选

资源编译配置项。

externalNativeOptions

对象

可选

Native编译配置项。

sourceOption

对象

可选

源码相关配置。使用不同的标签对源代码进行分类,以便在构建过程中对不同的源代码进行不同的处理。

nativeLib

对象

可选

Native 库(.so)相关配置。

napiLibFilterOption

对象

可选

NAPI库(.so)文件的筛选选项。标记为废弃,不建议使用,推荐使用nativeLib/filter。

arkOptions

对象

可选

ArkTS编译配置。

removePermissions

对象数组

可选

指定编译时需要删除的依赖包中的冗余权限,模块本身的权限不会被删除,仅HAP/HSP模块支持配置。

sourceOption

sourceOption是源码相关配置,使用不同的标签对源代码进行分类,以便在构建过程中对不同的源代码进行不同的处理。

表17 sourceOption

字段名称

类型

是否必选

含义

workers

字符串数组

可选

指定使用node.js工作器的JS/TS源代码,源代码在构建过程中单独处理。

sourceOption字段示例:

"buildOption": {
  "sourceOption": {
    "workers": [
      "./src/main/ets/common/constants/CommonConstants.ets"
    ]
  }
}

napiLibFilterOption

napiLibFilterOption是NAPI库(.so)文件的筛选选项,字段已废弃,不建议使用,推荐使用nativeLib/filter。

表18 napiLibFilterOption

字段名称

类型

是否必选

含义

excludes

字符串数组

可选

排除的.so文件。罗列的NAPI库将不会被打包。

pickFirsts

字符串数组

可选

按照.so文件的优先级顺序,打包最高优先级的.so文件。

pickLasts

字符串数组

可选

按照.so文件的优先级顺序,打包最低优先级的.so文件。

enableOverride

布尔值

可选

是否允许当.so文件重名冲突时,使用高优先级的.so文件覆盖低优先级的.so文件:

  • true:允许。
  • false(缺省默认值):不允许。

arkOptions

arkOptions是ArkTS编译配置。

表19 arkOptions

字段名称

类型

是否必选

含义

runtimeOnly

对象

可选

配置动态import的文件和依赖的包名,仅支持在Stage模型中配置。

runtimeOnly为非必选配置,当工程需要以变量方式动态import文件、目录的相对路径或三方包时,需要通过配置runtimeOnly来确保其加入编译流程。

types

字符串数组

可选

自定义类型,可配置包名或d.ts/d.ets文件路径。

obfuscation

对象

可选

代码混淆配置。

buildProfileFields

对象

可选

运行时可获取的自定义构建参数,支持键值对配置,key可由数字、英文、下划线、中划线组成,value类型仅支持string、number、boolean。

integratedHsp

布尔值

可选

是否为集成态HSP。

  • true:是。
  • false(缺省默认值):否。

说明

  • 从API 12开始支持。
  • 需在工程级build-profile.json5中配置useNormalizedOHMUrl为true后使用。
  • 该字段仅在HSP模块中配置后生效。

transformLib

字符串

可选

字节码插桩插件配置,允许开发者在编译时对字节码进行插桩修改,仅支持Stage模型,格式为相对路径,不同系统要求的文件类型如下,文件内容需要在对应平台生成,不能拷贝修改后缀名混用。

  • Windows:.dll文件。
  • Linux/Mac:.so文件。

说明

  • Mac环境下添加配置后插桩未生效的问题请参考FAQ。
  • HAR模块仅字节码HAR配置生效,非字节码HAR配置不生效。

branchElimination

布尔值

可选

是否启用代码分支裁剪,减少编译产物大小,开启后,在release编译模式下,不会被执行到的代码分支会被裁剪掉,示例如下:

# 编译生成的BuildProfile文件
export const DEBUG = false;
export const VERSION_CODE = 100;
# 开发者自定义的ets文件
import { DEBUG } from 'BuildProfile';
import { VERSION_CODE } from 'BuildProfile';
if (DEBUG)
  {XXX} // 该分支会被裁剪掉
else
  {XXX}
if (VERSION_CODE){XXX} // 该语法发生了类型转换,不支持代码裁剪。
if (VERSION_CODE === 100){XXX} // 若需要裁剪代码,使用该方式,显式指定判断条件为boolean类型。
  • true:启用(将导致使用"ApplyChanges"功能时,对const声明的常量的值进行的修改可能不生效)。
  • false(缺省默认值):不启用。

说明

  • 仅支持API 11及以上的Stage模型。
  • HAR模块仅字节码HAR配置生效,非字节码HAR配置不生效。
  • 仅支持const声明的bool类型常量和const声明的string/number类型常量的判断表达式。
  • 不支持间接导入,例如A文件中定义const变量A1,B文件导入A1,导出B1,ets导入B1进行判断,无法进行裁剪。

byteCodeHar

布尔值

可选

是否构建字节码HAR,仅在HAR模块中配置后生效。

  • true:支持。
  • false:不支持。

说明

  • 从API 12开始支持。
  • 从DevEco Studio NEXT Beta1(5.0.3.800)版本开始,当工程级build-profile.json5中useNormalizedOHMUrl配置为true时,byteCodeHar缺省默认值为true;当useNormalizedOHMUrl配置为false时,byteCodeHar缺省默认值为false。

bundledDependencies

布尔值

可选

是否支持将多个源码HAR(本地+远程)打包成一个字节码HAR。字节码HAR、HSP、npm不会被打包进去,仅会合并源码HAR。

  • true:支持。
  • false(缺省默认值):不支持。

说明

  • 仅支持字节码HAR配置该字段。
  • 从API 12开始支持。
  • 仅支持Stage模型。

autoLazyImport

布尔值

可选

编译时是否自动将符合lazy-import语法规范的import语句添加"lazy"关键字。仅支持在源码中添加"lazy"关键字,不包含依赖的字节码HAR包或HSP。

  • true:添加。
  • false(缺省默认值):不添加。

说明

如果配置为true,编译时不会做场景识别,即源码中任何符合语法规范的import语句都会被添加"lazy"。

apPath

字符串

可选

说明

API 11及以上版本不再支持,即该字段配置后不再生效。

应用热点信息文件路径。

hostPGO

布尔值

可选

是否启用配置文件引导优化功能:

  • true:启用。
  • false(缺省默认值):不启用。

从API 10开始废弃。

表20 runtimeOnly

字段名称

类型

是否必选

含义

sources

array

可选

配置动态import的文件/文件夹的相对路径。

配置的文件/文件夹必须在工程中真实存在,且文件的后缀只能为ets或ts。

packages

array

可选

配置动态import依赖的包名。

该包名需要和工程级/模块级oh-package.json5的dependencies中的名字保持一致。

arkOptions字段示例:

"buildOption": {
  "arkOptions": {
    "runtimeOnly": {
      "sources": ["./src/main/ets/utils/Calc.ets"],
      "packages": ["myHar"]
    },
    "buildProfileFields": {
      "buildOptionSetData": "BuildOptionSetDataRelease",
      "data": "DataRelease"
    },
    "transformLib": "./dll/example.dll",
    "branchElimination": true,
    "autoLazyImport": true
  }
}

removePermissions

removePermissions是一个对象数组,用于编译HAP/HSP模块时,指定需要删除的依赖包中的冗余权限,模块本身的权限不会被删除。

表21 removePermissions

字段名称

类型

是否必选

含义

name

字符串

必选

待删除的权限名称,需要包含在依赖包的module.json的requestPermissions中。

removePermissions字段示例:

"buildOption": {
  "removePermissions": [
    {
      "name": "ohos.permission.ABILITY_BACKGROUND_COMMUNICATION"
    },
    {
      "name": "ohos.permission.ACCELEROMETER"
    }
  ]
}

resOptions

resOptions是资源编译配置项。

表22 resOptions

字段名称

类型

是否必选

含义

compression

对象

可选

对工程预置图片资源进行纹理压缩的编译配置参数。

copyCodeResource

对象

可选

对模块的src/main/ets目录下的资源文件(非源码文件)拷贝的编译配置参数。

说明

该字段对不开启混淆的源码HAR不生效。

表23 copyCodeResource

字段名称

类型

是否必选

含义

enable

布尔值

可选

是否将ets目录下的资源文件打包到产物中。

  • true(缺省默认值):打包。
  • false:不打包。

excludes

字符串数组

可选

根据glob语法排除匹配到的文件,匹配到的文件不会被打包到产物中。当enable配置为false时excludes不生效。

copyCodeResource字段示例:

"buildOption": {
  "resOptions": {
    "copyCodeResource": {
      "enable": true,
      "excludes": ['./entry/src/main/ets/component/big_picture.png', '**/*.yml', '**/subDir/**'],
    }
  }
}

compression

compression是对工程预置图片资源进行纹理压缩的编译配置参数。

表24 compression

字段名称

类型

是否必选

含义

media

对象

可选

对资源目录下media目录的图片进行纹理压缩的配置参数。

filters

对象数组

可选

文件过滤配置参数。

说明

编译过程中会依次遍历图片文件,并与filters条件进行匹配,一旦匹配成功,则完成该图片的处理。当工程级和模块级同时配置时,先按照模块级的过滤条件匹配,一旦匹配成功,则忽略工程级的过滤条件;如果模块级的没有匹配成功,继续按工程级的条件进行匹配。

media

media是对资源目录下media目录的图片进行纹理压缩的配置参数。

表25 media

字段名称

类型

是否必选

含义

enable

布尔值

可选

是否对media图片启用纹理压缩。

  • true:启用。
  • false(缺省默认值):不启用。

说明

  • 在linux系统的构建场景下,请确认系统环境已安装libGL1库。
  • 对图片进行纹理压缩会改变文件名称和内容,在分层图标以及二次编辑的场景下会引起图片显示异常,请进一步使用filters排除掉这部分文件。

filters

filters是文件过滤配置参数。

表26 filters

字段名称

类型

是否必选

含义

method

对象

必选

纹理压缩的方式。

files

对象

可选

指定用来参与压缩的文件,与exclude字段配合使用。

exclude

对象

可选

从files中剔除掉不需要压缩的文件。

表27 method

字段名称

类型

是否必选

含义

type

字符串

必选

转换类型。

  • astc(Adaptive Scalable Texture Compression):自适应可变纹理压缩,一种对GPU友好的纹理格式,可在设备侧更快地显示,有更少的内存占用。
  • sut(SUper compression for Texture) :纹理超压缩,可在设备侧更快地显示,有更少的内存占用,相比astc具备更大压缩率和更少ROM占用。

blocks

字符串

必选

astc/sut转换类型的扩展参数,决定画质和压缩率,当前仅支持"4x4"。

表28 files

字段名称

类型

是否必选

含义

path

字符串数组

可选

指定“按路径匹配”的过滤条件,符合glob规范,格式为相对路径,配置示例:

size

二维数组

可选

指定“按大小匹配”的过滤条件,格式为[min,max],闭区间,表示大小从min到max之间的文件,配置示例:


"size":[
[0, '1k'], // 0 ~ 1*1024
['1024', '2k'], // 1024 ~ 2*1024
['3K'] // 3*1024 ~ 无限大
]
  • 每个数值可以填数字、字符串或字符串中带单位(大小写均可)。
  • 单位K/k=1024,M/m=1024*1024,G/g=1024*1024*1024。
  • 区间最大值可省略,表示无限大。

resolution

二维数组

可选

指定“按分辨率匹配”的过滤条件,配置示例:

resolution:[
  [
    { width:32, height:32 },   // 最小宽高
    { width:64, height:64 },   // 最大宽高
  ],                           // 分辨率在32*32到64*64之间的图片
  [
    { width:200, height:200 }, // 最小宽高
    // 此处第2个不填表示最大宽高是无限大
  ],                           // 分辨率大于200*200的图片
]
  • width和height只能是数字。
  • 最大宽高可以省略,表示无限大。
表29 exclude

字段名称

类型

是否必选

含义

path

字符串数组

可选

同files/path。

size

二维数组

可选

同files/size。

resolution

二维数组

可选

同files/resolution。

compression字段示例:

"buildOption": {
  "resOptions": {
    "compression": {
      "media": {
        "enable": true // 是否对media图片启用纹理压缩
      },
      // 纹理压缩文件过滤,非必填,不填会压缩资源目录中的所有图片
      "filters": [
        {
          "method": {
            "type": "sut", // 转换类型
            "blocks": "4x4" // 转换类型的扩展参数
          },
          // 指定用来参与压缩的文件,需要满足所有条件且不被exclude过滤的文件才会参与压缩
          "files": {
            "path": ["./**/*"], // 指定资源目录中的所有文件
            "size": [[0, '10k']], // 指定大小10k以下的文件
            // 指定分辨率小于2048*2048的图片
            "resolution": [
              [
                { "width": 0, "height": 0 }, // 最小宽高
                { "width": 2048, "height": 2048 } // 最大宽高
              ]
            ]
          },
          // 从files中剔除掉不需要压缩的文件,需要满足所有过滤条件的文件才会被剔除
          "exclude": {
            "path": ["./**/*.jpg"], // 过滤所有jpg文件
            "size": [[0, '1k']], // 过滤大小1k以下的文件
            // 过滤分辨率小于1024*1024的图片
            "resolution": [
              [
                { "width": 0, "height": 0 }, // 最小宽高
                { "width": 1024, "height": 1024 } // 最大宽高
              ]
            ]
          }
        }
      ]
    }
  }
}

buildModeBinder

buildModeBinder是构建模式(debug、release 等)与构建配置(buildOption)的关联配置。通过该配置可以将不同的构建配置和target进行组合,并绑定到对应的构建模式上。如果没有配置buildModeBinder,默认的绑定策略请参考合并编译选项规则。

表30 buildModeBinder

字段名称

类型

是否必选

含义

buildModeName

字符串

可选

构建模式名称,需要在工程级别的buildModeSet中定义。

mappings

对象数组

可选

target和buildOption之间的一对一映射关系。

表31 mappings

字段名称

类型

是否必选

含义

targetName

字符串

可选

target名称。

buildOptionName

字符串

可选

构建配置buildOption名称。

buildModeBinder字段示例:

"buildModeBinder": [
  {
    "buildModeName": "debug",
    "mappings": [
      {
        "targetName": "default",
        "buildOptionName": "release"
      }
    ]
  }
]

HarmonyOS Next开发学习手册——旋转屏动画增强 在原旋转屏动画基础上,可配置渐隐和渐现的转场效果。完整的代码示例和效果如下。需要在EntryAbility.ets文件的onWindowStageCreate方法中添加处理逻辑以获取屏幕的显示方向需要在项目的 module.json5 文件中的 abilities 列表里添加 “orientation”,指定为 “auto_rotation” 阅读详情

相关推荐

鸿蒙应用开发项目中配置文件汇总

"type": "entry", // 模块类型(entry/feature)"versionName": "1.0.0", // 用户可见版本。"deviceTypes": [ "phone", "tablet" ], // 支持设备类型。"name": "entry", // 模块名称。

2301_81552270的博客 977

鸿蒙NEXT开发【配置文件说明build-profile.json5】DevEco Studio编译构建

build-profile.json5文件分为工程级与模块级,其中buildOption在工程级文件和模块级文件均可配置,其中相同字段以模块级的字段为准,不同字段模块级的buildOption配置会继承工程级配置。

鸿蒙的技术博客 4619

鸿蒙开发5.0【NAPI 进阶】

Native C++应用场景,总结起来就如下三种

2401_82772199的博客 954

鸿蒙基本工程目录

在 AppScope,其中有 resources 文件夹和配置文件 app.json5。AppScope>resources>base 中包含element 和 media 两个文件夹,

m0_59680769的博客 1721

鸿蒙HarmonyOS应用开发之使用DevEco Studio模板构建NDK工程

NDK通过CMake和Ninja编译应用的C/C++代码,编译过程如下图所示。核心编译过程如下:根据CMake配置脚本以及build-profile.json5中配置的externalNativeOptions构建参数,与缓存中的配置比对后,生成CMake命令并执行CMake。执行Ninja,按照makefile执行编译和链接,将生成的.so以及运行时依赖的.so同步到输出目录,完成构建过程。

YHDMYBY的博客 1173

【鸿蒙OH 5.0】HarmonyOS 多目标产物构建最佳实践

target:工程内的每一个Entry/Feature模块,对应的构建产物为HAP,HAP是应用/服务可以独立运行在设备中的形态。由于在不同的业务场景中,同一个模块可能需要定制不同的功能或资源,因此引入target的概念。一个模块可以定义多个target,每个target对应一个定制的HAP,通过配置可以实现一个模块构建出不同的HAP。product:一个HarmonyOS工程的构建产物为APP包,APP包用于应用/服务发布上架应用市场。

xiaolizibie的博客 758

鸿蒙5.0开发进阶:配置文件(工程级build-profile.json5文件)

工程级build-profile.json5文件整体的结构........

Androidbye的博客 3280

鸿蒙5.0实战案例:har和hsp的转换

2.(可选)当Hsp需要对外声明router可跳转的page时,需要添加module.json5的"pages"字段,并在resources/base目录下建立profile/main_pages.json文件,添加配置参考如下,并在对应位置添加页面。4.har包的build-profile.json5默认会有"consumerFiles": ‘./consumer-rules.txt’ ,该项仅har模块可配置,为默认导出的混淆规则(详细描述见: 代码混淆 ),需将其删除。共享包选型: 应用模块化选型。

Maniu_666的博客 1303

鸿蒙:配置文件:build-profile.json5

本文分析了鸿蒙开发中工程级和模块级build-profile.json5文件的差异与关联。工程级文件位于项目根目录,用于全局配置(如签名、SDK版本等),影响所有模块;模块级文件位于模块目录,用于个性化配置(如覆盖SDK版本)。两者存在继承(模块默认继承工程配置)、引用(模块直接使用工程签名配置)和覆盖(模块可重写工程配置)三种协作关系。工程级配置为基础,模块级配置具有更高优先级,模块可选择性地补充或覆盖全局配置。这种分层设计既保证了统一性,又提供了灵活性。

weixin_71403100的博客 1024

BUSCO评估基因组的完整性

因为数据库收集的时候找的就是在不同的物种间都是单拷贝的基因,所以说在评估的物种里面应该也是单拷贝的状态才对。基因组层面评估:先去基因组上预测这些基因,再去做评估,如果说给他是一个注释好的基因集,这个时候提供的是一个蛋白集合,它就直接是去进行同源搜索,再去评估,看BUSCO数据库里面的这些单拷贝基因有或者无;首先,tblastn也是同源搜索,同源搜索之后,去对转录本进行读码框预测,预测完的结果还是去进行hmmsearch的搜索(hmmsearch是做蛋白质结构域搜索的),最终拿到BUSCO评估结果。

qq_64400864的博客 2964

PCIe 6.0实战指南:从链路训练到信号完整性的避坑手册

本文是一份针对PCIe 6.0硬件工程师的实战避坑指南。文章深入解析了从NRZ到PAM4调制带来的信号完整性挑战,详细拆解了链路训练(LTSSM)的复杂过程与调试方法,并提供了从信道仿真到实验室实测(如使用Keysight示波器进行眼图与误码率分析)的完整信号完整性闭环验证策略,帮助工程师解决高速率下的链路不稳定与降速问题。

weixin_29306875的博客 345

鸿蒙HarmonyOS开发环境安装与配置完全解析

华为鸿蒙系统是国内目前纯原生自产的热门移动应用开发系统,经过近几年的完善与优化,具有它特有的应用魅力与实用价值,诚邀国内外广大编程爱好者使用与推广。

sinat_30844883的博客 1万+

2024年上半年网络工程师下午真题及答案解析

位于MPLS域边缘、连接其他网络的LSR称为( 3 ),区域内部的LSR称为核心LSR(CoreLSR)IP报文进入MPLS网络时,MPLS入口设备分析IP报文的内容并为其添加合适的标签,所有MPLS网络中的LSR根据标签转发数据,当该IP报文离开MPLS网络时,标签由出口LER弹出。LSP的出口LER称为( 6 )。某高校网络拓扑如下图所示,两校区核心(CORE-1、CORE-2),出口防火墙(NGFW-1、NGFW-2)通过校区间光缆互联,配置OSPF实现全校路由收敛,两校区相距40km。

bsefef的博客 2477

HarmonyKit | 鸿蒙开发:build-profile.json5 SDK 版本与签名配置详解

文章摘要(150字): build-profile.json5是鸿蒙开发的核心配置文件,控制着HAP构建、SDK版本与签名机制。本文以开源项目HarmonyKit为例,解析配置文件的三个层级(项目级、模块级、引擎级),重点说明项目级配置中签名证书(signingConfigs)的参数含义、产品定义(products)的多变体策略,以及targetSdkVersion与compatibleSdkVersion的关键差异:前者声明适配的API版本,后者设定最低安装要求。文章还指出调试证书密码的安全风险,并演示如

欢迎大家一起讨论交流 257

FISCO BCOS 三、多群组部署以及新节点加入群组

本章主要以星形组网和并行多组组网拓扑为例,指导您了解如下内容:了解如何使用创建多群组区块链安装包;了解创建的多群组区块链安装包目录组织形式;学习如何启动该区块链节点,并通过日志查看各群组共识状态;学习如何向各群组发送交易,并通过日志查看群组出块状态;了解群组内节点管理,包括节点入网、退网等;了解如何新建群组。

qq_63235624的博客 2921

11、气动外形优化中的连续伴随方法

本文探讨了连续伴随方法在气动外形优化中的理论背景、实现和验证过程。通过使用DLR的FLOWer求解器,将伴随方法应用于Euler和Navier-Stokes方程,以高效计算成本函数梯度,从而显著减少优化过程中的计算成本。文章还介绍了该方法在RAE2822翼型和ONERA M6机翼等案例中的应用,并展示了其准确性和效率。未来展望包括扩展到复杂流动模拟和多学科优化。

desk3的博客 169

为什么有两个 build-profile.json5:用 buildProfileFields 验证工程级与模块级覆盖关系【鸿蒙心迹】

HarmonyOS 工程里有一个很容易让人产生疑问的地方:项目根目录有,进入entry模块后,又能看到一个。两个文件都和构建有关,甚至都能出现。同一个配置项在工程级和模块级都写了,到底听谁的?如果两边写的是不同配置,又会不会丢失?官方对这个问题给出的规则其实很明确:工程级和模块级的会参与合并;从完整的编译选项继承覆写关系看,模块级的优先级高于工程级products中的。换成更直观的话说,就是相同字段由更高优先级配置覆写,不同字段则可以沿继承关系保留下来。

2201_75863687的博客 386

【使用DeepSeek辅助Python接口性能自动化测试教程-实战教程】

访问DeepSeek官方网站,注册账号并获取API Key。此Key是调用DeepSeek API的必要凭证,务必妥善保管。安装时,注意勾选“Add Python to PATH”选项,以便系统能识别Python命令。确保你已安装Python 3.8或更高版本。会自动发现并执行所有以。

Dreams°的博客 2469

鸿蒙NEXT版实战开发:工程检查报错,提示“Incorrect settings found in the build-profile.json5 file”

工程级build-profile.json5文件配置可能存在错误.........

qq_39652397的博客 1327

微信8.0所有URL Scheme大全:隐藏入口与使用场景详解 内附195条微信URL Scheme

URL Scheme 类似于一个协议地址,它的作用和网页的https://差不多,只不过它不是打开网页,而是直接跳转到微信App内部的功能页面。→ 打开微信扫一扫→ 打开零钱通详情→ 打开微信面对面支付微信功能的“快捷指令”。整理下来,微信的 URL Scheme 基本覆盖了支付、联系人、扫一扫、小程序、运动设备等多个入口。对开发者来说,这些 Scheme 就像是隐藏的快捷通道,在某些场景(比如支付唤起、活动红包、客服入口)能大大简化流程。微信对外部调用限制非常严格。

代码简单说 Vue、JAVA、PHP、Node.js 熟练运用,接口、架构、性能全搞定。 2230

【Py/Java/C++/C/JS/Go六种语言OD独家2024E卷真题】20天拿下华为OD笔试之【固定滑窗】2024E-考勤信息【欧弟算法】全网注释最详细分类最全的华为OD真题题解

可上练习华子OD、大厂真题绿色聊天软件戳oj1441了解算法冲刺训练(备注【优快云】否则不通过)

weixin_48157259的博客 620

鸿蒙 构建系统:build-profile.json5文件

本文详细介绍了HarmonyOS/OpenHarmony应用开发中的配置文件结构,主要包含app和modules两大模块。app配置涵盖签名方案(signingConfigs)、产品配置(products)、构建模式(buildModeSet)、多工程支持(multiProjects)和开放能力(capabilities)等核心配置项。其中重点说明了签名材料、产品包信息、资源编译、ArkTS编译等关键配置参数。modules部分则定义了模块名称、源码路径及构建目标等模块级配置。文章还详细解析了buildOp

梦想不只是梦与想的博客 565

RU DOS版、EFI版32bit/64bit BIOS常用工具

DOS版、EFI版的RU工具,可用来查看IO、MEM、PCI、SMBIOS等资源。亲测在EFI SHELL下可用。

解决鸿蒙打包BundleName不匹配问题: hvigor ERROR: BundleName in the project configuration does not match that i

在鸿蒙开发的旅程中,遇到的错误提示,无疑是让人头疼的一大难题。本文将深入探讨如何高效解决这一技术难题,内容包括但不限于鸿蒙OS、HarmonyOS、打包问题、配置文件调整等SEO词条,旨在帮助开发者从容应对,确保项目顺利打包。不论你是初入鸿蒙世界的小白还是在其中摸爬滚打的大佬,本篇博文都将为你提供宝贵的技术洞见。关键文件配置项注意事项bundleName必须与签名配置中的名称一致app.json5bundleName必须与中的名称一致。

猫头虎技术团队:授渔优于赠鱼,兴趣引领智慧,探索之乐尤显珍贵。商务合作+:Libin9iOak ,万粉变现+:优快云WF,猫头虎承诺每年免费为100名C站创作者做账号流量诊断服务!全网搜:猫头虎技术团队,点击文章底部名片或直接私信我一切皆可谈,快找虎哥! 8178

迈瑞BS系列全自动生化分析仪LIS协议接口手册(内含HL7和ASTM)

迈瑞BS系列全自动生化分析仪LIS协议接口手册,内含HL7和ASTM)

Data-Structures-and-Algorithm-Analysis-in-Java.pdf

作者: Weiss, Mark A. 出版社: Addison Wesley Data Structures and Algorithm Analysis in Java is an “advanced algorithms” book that fits between traditional CS2 and Algorithms Analysis courses. In the old ACM Curriculum Guidelines, this course was known as CS7. This text is for readers who want to learn good programming and algorithm analysis skills simultaneously so that they can develop such programs with the maximum amo...

鸿蒙开发0基础【在build-profile.json5中配置arkOptions】ArkTS并发

arkOptions主要提供ArkTS编译相关配置,当前文档介绍arkOptions中types配置类型、maxFlowDepth配置控制流分析最大栈深度等,arkOptions中的其他配置项请参考[build-profile.json5]

zhenggaoxiao232的博客 475

霍尼韦尔SoftMaster使用说明

霍尼韦尔SoftMaster使用说明

鸿蒙HarmonyOS 5.0开发:典型场景开发-集成态HSP

集成态HSP是应用内HSP的一种中间编译产物.........

m0_73088370的博客 1249
上一篇: 鸿蒙5.0开发进阶:配置文件(工程级build-profile.json5文件)
下一篇: 鸿蒙5.0开发进阶:配置构建-多模块管理
懂你的大海
博客等级 码龄6年 9049粉丝 1381原创
评论
成就一亿技术人!
拼手气红包6.0元
还能输入1000个字符
 
 条评论被折叠 查看
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付:10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值