Version Control with Git

The Vitis IDE comes with Git support for version control with the preinstallation and customization of the Eclipse EGit plugin. The EGit User Guide is applicable to the Vitis software platform. The Eclipse Git Tutorial also provides more information.

TIP: You can switch to the Git perspective by using Window > Git Perspective. Git preferences are available in Window > Preferences.

Using the Git Import Wizard

  1. To import an existing project from a Git repository, go to File > Import to open the Import Projects wizard. Select Import projects from Git.
  2. Select the repository location (Existing local repository or Clone URI; the wizard supports both). Click Next.

    A different page appears depending on your selection. If you select Existing local repository, you will be prompted to specify the required repository in the Select a Git repository view. If you select Clone URI, the following page appears for you to provide the necessary information.

  3. Click Finish. The selected projects are migrated based on the requirements specified in the previous step.

Importing Projects from a Local Git Repository

  1. You can import projects from a local Git repository by selecting the Eclipse workspace or zip file option. Click Next.

  2. Provide the local repository path to list the existing projects.
    IMPORTANT: To retain the local Git repository location, Copy Projects into workspace must not be selected.


  3. Click Finish. The selected projects are migrated based on the requirements specified in the previous steps. Imported projects are displayed in Explorer view.

Solving Missing Projects

If some of the application projects were not selected as part of the import, the missing projects are displayed as shown in the following screenshot. You can import missing application projects using theImport Projects wizard.



If a system project is missing, the orphan project is displayed in Assistant view as shown below.

In both cases, you can always get the latest changes from the Git repository by right-clicking on the system or error projects and selecting Refresh Project Models to refresh them.

Team Actions

All the team actions are available in Explorer view on right-click. Although system and application projects are shown in the hierarchy, these are separate projects, and team actions must be performed at the level of each separate project.

Checking in new projects
Newly created projects can be submitted to the Git repository using Team > Share Project.

Updating existing projects
You can push/pull changes to/from the Git repository using the options in the menu shown in the following screenshot.

Git Ignore File Creation

For newly created projects, a .gitignore file is created with the default build configuration folders. Team checkins will ignore any folders specified in this file.

The following image shows the contents of a simple .gitignore file.