Project Export and Import

The Vitis™ IDE provides a simplified method for exporting or importing one or more Vitis IDE projects within your workspace, or import from GIT repositories. You can optionally include associated project build folders.

Export a Vitis Project

When exporting a project, the project is archived in a zip file with all the relevant files needed to import to another workspace.
  1. To export a project, select File > Export from the main menu.
    The Export Vitis Projects page opens, where you select the project or projects in the current workspace to export as shown in the following figure.

  2. To change the name for the archive, edit the Archive File field.
  3. To include the current build configurations, enable Include build folders at the bottom of the window.
    TIP: This can significantly increase the size of the archive, but might be necessary in some cases.
  4. To create the archive with your selected files, click OK to create the archive.

The selected Vitis IDE projects are archived in the specified file and location, and can be imported into the Vitis IDE under a different workspace, on a different computer, by a different user.

Import a Vitis Project

  1. To import a project, select File > Import from the top menu.

    This opens the Import Projects page to select the import file type. There are two types of files you can select to import:

    Vitis project exported zip files
    Lets you import projects previously exported from the Vitis IDE as discussed in Export a Vitis Project.
    Eclipse workspace or zip file
    Lets you import projects from another Vitis IDE workspace.
    Import projects from Git
    Lets you import projects from either a local previously cloned Git repository, or from a specified Git URL, as described in the next topic.
  2. The following figure shows the page that is opened when you select Eclipse workspace or zip file and click Next.

  3. For Select root directory, point to a workspace for the Vitis IDE, and specify the following options as needed:
    Search for nested projects
    Looks for projects inside other projects in the workspace.
    Copy projects into workspace
    Creates a physical copy of the project in the current open workspace.
    Close newly created imported projects upon completion
    Closes the projects in the open workspace after they are created.
  4. Click Finish to import the projects into the open workspace in the Vitis IDE.

Import Projects from Git

  1. From the Import Projects wizard, select the Import projects from Git option, and select Next to proceed.

    This opens the Select Repository Source page. There are two types of repositories you can select:

    Existing local repository
    Selects an existing Git repository that has already been cloned locally. When you select this option, the Select a Git Repository page displays the list of currently cloned local repositories found by the Vitis IDE. Click Next to continue.
    TIP: You can create a local Git repository by cloning the URL as described below, or by using the git clone <url> command from the Linux shell.
    Clone URL
    Lets you specify a Git URL to clone to the specified location. When you select this option the Source Git Repository page of the Import Projects wizard is displayed as shown below.

    1. On the Source Git Repository page, specify the following and click Next to continue:
      Location
      Specify the URL for the repository. The host and repository path are extracted from the provided URL. Some URLs that might be of interest include:
      Connection
      Specifies the connection protocol used to connect. Use these fields to customize the connection if necessary.
      Authentication
      Specifies the User ID and Password to access the repository if one is required.
    2. In the Branch Selection page, you can select one or more branches to clone. Click Next to proceed.
    3. In the Local Destination page, specify the Destination Directory where the repository will be cloned. Click Next to proceed.
  2. After opening the local repository or cloning the URL to create a new local repository, the Select a wizard to import projects page of the Import Project wizard is given. As shown below, this page lets you import an Eclipse project, import a project using the New Project wizard, or import a general project.

  3. Select the method for importing the project and click Next to continue. Depending on which method you chose, you will be directed to the New Project wizard as described in Creating a Vitis IDE Project, or you will be guided through the process of importing an Eclipse project or general project.