描述
将当前工程设置写入指定 INI 文件。这可用于将工程导出到 INI 文件，而不是为该工程创建 Tcl 脚本。您可使用 apply_ini 将 INI 读入 Vitis HLS 工具，或者将其与 v++ -c --mode hls 命令搭配使用。
语法
write_ini <ini_file> [OPTIONS]
<ini_file> 用于指定要创建的 INI 文件。
选项
-
-all <true | false> - 写入所有选项，与是否已设置当前值无关。这样可确保写入 INI 文件时，连默认值也会一并导出到此 INI 文件。
-
-appfile <string> - 将使用此处指定的工程 app 文件代替当前打开的工程。可用于从当前未打开的工程生成 INI 文件。
-
-apsfile <string> - 将使用此处指定或来自外部工程的解决方案 aps 文件代替当前打开的解决方案。
-
-filepaths <absolute|relative|none> - 控制输出中的相对文件路径的处理方式。默认值为
none。 -
-fileroot <string> - 该选项搭配
-filepaths relative选项一起使用，用于指定文件根目录路径，后续生成的文件路径均为该目录路径的相对路径。默认设为从中启动工具的目录的相对路径。 -
-include <string> - 指定 glob 模式要包含的字符串。
-
-package_defaults [=true|false] - 将各包的配置设置默认值写入 INI 文件。
-
-quiet <true | false> - 写入 INI 文件时禁止所有警告消息和参考消息。但仍将返回错误。
-
-show <true | false> - 写入 INI 文件时显示详细消息。
-
-solution_only [=true|false] - 在生成的 INI 文件中不包含工程数据。
-
-workdir <string> - 在生成的 INI 文件中，指定工作目录。
示例
这将把当前工程导出到指定 INI 文件，并导出所有选项，包括用户指定的选项和默认值：
write_ini project1.ini -all=true