Archive the current project
Syntax
archive_project [‑temp_dir <arg>] [‑force] [‑exclude_run_results]
[‑include_config_settings] [‑include_runs_in_progress]
[‑include_local_ip_cache] [‑quiet] [‑verbose] [<file>]Returns
true
Usage
| Name | Description |
|---|---|
[-temp_dir]
|
specify temporary location to save project copy to archive Default: . |
[-force]
|
Overwrite existing archived file |
[-exclude_run_results]
|
Exclude run results from the archive |
[-include_config_settings]
|
Include current project environment configuration settings/files in archive |
[-include_runs_in_progress]
|
Include run result even if the run is in progress, this switch will be ignored if -exclude_run_results is specified |
[-include_local_ip_cache]
|
Include IP cache results in the archive |
[-quiet]
|
Ignore command errors |
[-verbose]
|
Suspend message limits during command execution |
[<file>]
|
Name of the archive file |
Categories
Description
Archives a project to store as backup, or to encapsulate the design and send it to a remote site. The tool parses the hierarchy of the design, copies the required source files, include files, and remote files from the library directories, copies the constraint files, copies the results of the various synthesis, simulation, and implementation runs, and then creates a ZIP file of the project.
An alternative method of archiving the project is using write_project_tcl to create a Tcl script that will recreate the project in its current form.
Arguments
-temp_dir <arg> - (Optional) Specify a temporary directory to copy files to when creating the project archive. The temporary directory will be created if it does not exist, and will be emptied when the archive process is complete. By default, the Vivado tool will create a temporary directory inside of the current working directory.
-force - (Optional) Overwrite an existing ZIP file of the same name. If the ZIP file exists, the tool returns an error unless the -force argument is specified.
-exclude_run_results - (Optional) Exclude the results of any synthesis or implementation runs. This command can greatly reduce the size of a project archive.
-include_config_settings - (Optional) Add any initialization Tcl commands (init.tcl) to the archive file under the <project_name>/config_settings folder.
-include_runs_in_progress - (Optional) Include data in the archive from the directories of incomplete runs. This switch will be ignored if -exclude_run_results is specified.
-include_local_ip_cache - (Optional) Include the cached IP synthesis results in the project archive. This command only includes cached synthesis results if the IP cache is local to the project rather than remote. Refer to the config_ip_cache command for more information.
-quiet - (Optional) Execute the command quietly, returning no messages from the command. The command also returns TCL_OK regardless of any errors encountered during execution.
-verbose - (Optional) Temporarily override any message limits and return all messages from this command.
set_msg_config command.<file> - (Optional) The name of the ZIP file to be created by the archive_project command. If <file> is not specified, a ZIP file with the same name as the project is created.
Examples
archive_projectcurrent_project project_3
archive_project -force -exclude_run_results proj3.zip-force argument causes the tool to overwrite the proj3.zip file if one exists. The use of the -exclude_run_results argument causes the tool to leave any results from synthesis or implementation runs out of the archive. The various runs defined in the project are included in the archive, but not any of the results.archive_project -force mb1_archive.zip -temp_dir C:/Data/Temp \
-exclude_run_results -include_config_settings