app config - 2023.2 简体中文

Vitis 统一软件平台文档 嵌入式软件开发 (UG1400)

Document ID
UG1400
Release Date
2023-12-13
Version
2023.2 简体中文

为应用配置 C/C++ 构建设置。

语法

为指定应用配置 C/C++ 构建设置。对于应用,可配置以下设置: assembler-flags:适用于汇编程序的杂项标志; build-config:获取/设置构建配置; compiler-misc:编译器杂项标志; compiler-optimization:最优化级别; define-compiler-symbols:定义符号。例如,MYSYMBOL; include-path:包含头文件的路径; libraries:链接时要添加的库; library-search-path:已添加的库的搜索路径; linker-misc:连接器杂项标志; linker-script:用于链接的连接器脚本; undef-compiler-symbols:未定义的符号。例如,MYSYMBOL

app config -name <app-name> <param-name>

<app-name> 指定的应用获取配置参数 <param-name> 的值。

app config [OPTIONS] -name <app-name> <param-name> <value>

<app-name> 指定的应用设置/修改/移除配置参数 <param-name> 的值。

选项

选项 描述
-name 应用的名称。
-set 将配置参数值设置为新的 <value>
-get 获取配置参数值。
-add 将新的 <value> 追加到配置参数值。针对 compiler-optimization 不支持添加选项
-info 显示更多信息,如有关配置参数的可能值和可能操作。使用该选项时,必须指定参数名称。
-remove 从配置参数值中移除 <value>。针对 assembler-flags、build-config、compiler-misc、compiler-optimization、linker-misc 和 linker-script 不支持移除选项。

返回

取决于指定的实参。<none>:可供配置的参数列表以及每个参数的描述。

<parameter name>:参数值,或者如果指定的参数不受支持,则显示错误。

<parameter name> <paramater value>:如果值设置成功,则不显示任何结果,或者如果指定的参数不受支持,则显示错误。

示例

app config -name test build-config

返回名为 test 的应用的当前构建配置。

app config -name test define-compiler-symbols FSBL_DEBUG_INFO

构建 test 应用时,将 -DFSBL_DEBUG_INFO 添加至编译器选项中。

app config -name test -remove define-compiler-symbols FSBL_DEBUG_INFO

构建 test 应用时,从编译器选项中移除 -DFSBL_DEBUG_INFO。

app config -name test -set compiler-misc {-c -fmessage-length=0 -MT"$@"}

将 {-c -fmessage-length=0 -MT"$@"} 设置为编译器杂项标志,供 test 应用使用。app config -name test -append compiler-misc {-pg} 将 {-pg} 添加到编译器杂项标志中,供 test 应用使用。

app config -name test -info compiler-optimization

更改应用程序的编译器选项中的编译器最优化。

app config -name test -set compiler-optimization {Optimize for size (-Os)}

显示有关编译器最优化级别的可能值和默认值的更多信息。