app - 2025.2 简体中文 - UG1400

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

Document ID
UG1400
Release Date
2025-11-20
Version
2025.2 简体中文

应用工程管理。

表 1. app - 应用工程管理
XSCT 方法 实参 对应 Python API 实参 注释
app create -name <application-name> 表示要创建的应用的名称。

-platform <platform-name> 平台名称。使用“repo -platforms”可列出可用的预定义平台。

-domain 域的名称。使用“platform report <platform-name>”可列出平台中可用的系统配置。

-hw <hw-spec> 从 AMD Vivado™ (XSA) 导出的硬件规格文件。

-sysproj <system-project> 系统工程的名称。使用“sysproj list”可查看工作空间内可用的系统工程。

-proc <processor> 为该核创建应用程序。

  1. client.create_aie_component

    (适用于 AIE 应用)

  2. client.create_app_component

    (适用于主机组件)

必需实参
  1. name = <comp_name> AIE 组件名称。
  2. platform = <platform> 或 part = <part> 将为此处指定的平台/部件创建组件。用户只需指定平台或部件之一即可。
可选实参
  1. template = <template> 此处指定的模板适用于要创建的组件。
在 XSCT 中,Vitis 工具会在创建组件(应用程序)时提及系统工程。在 Python CLI 中,Vitis 工具会首先创建组件,然后将其添加到系统工程中。这样即可将创建的组件灵活添加到各种系统工程中。
app create(续)

-template <application template> 模板应用的名称。默认值为 'Hello World'。使用“repo -apps”可列出可用的模板应用

-os <os-name> 操作系统类型。默认类型为独立 (standalone)。

-lang <programming language> 可用编程语言为 c 或 c++。

-arch <arch-type> 处理器架构,<arch-type> 可设为 32 位或 64 位。该选项用于构建含 32/64 位工具链的工程

  必需实参
  1. name = <comp_name> 应用组件名。
  2. platform = <platform> 将为此处指定的平台创建组件。对于裸机平台,用户可以在指定平台的同时指定域。
可选实参
  1. template = <template> 此处指定的模板适用于要创建的组件。
  2. domain = <domain> 当平台上有多个域时,此项用于指定其中一个域。
 
app remove app_name client.delete_component name = <comp_name> 组件名称。  
switch app_name client.get_component name = <comp_name> 组件名称。 Get 命令会返回可用于运行应用命令的应用对象。
app list -dict 以 Tcl 词典格式列出工作空间的所有应用。如不使用该选项,则以表格格式列出应用。

(在 Python CLI 中不支持此实参)

client.list_components    
app build -name <app-name> 表示要构建的应用的名称。

-all 要构建的应用的名称。该选项用于构建所有应用工程。

(在 Python CLI 中不支持 -all)

component.build   要构建组件,组件对象是必需的。例如:

component1 = client.get_component('aie_component1')

component1.build()

app clean -name <app-name> component.clean omponent.clean  
app report app_name component.report