Trying to make Vitis more git-friendly.
When you use this repository as template, in the new created repository you can delete this file and rename README_PROJECT_TEMPLATE.md
to README.md
.
Vitis is a little bit less pain in the ass than Vivado to version control decently, so this repository provide:
A good to start with .gitignore
file.
Git-hook-scripts to eliminate absolute paths in project files.
When first starting a project, create the workspace in a new folder.
Copy the hardware specification file (.xsa) into the workspace folder.
Create a new platform project called hw_platform
and choose the copied hardware specification file.
Create a new application project via File -> New -> Application Project...
, choose the platform created befor and name the application project as you want.
Copy the .gitignore
file and the .githooks
folder from this repository into the workspace folder.
Execute the following commands in the workspace folder:
git init
- initialize git repository in the workspace folder.
git config --local core.hooksPath .githooks
- set path to git-hooks for this repository.
git add .
- add all relevant files to the repository.
git commit -m 'initial commit'
- create initial commit.
After cloning the repository execute the following commands in the cloned folder:
git config --local core.hooksPath .githooks
- set path to git-hooks for this repository.
git checkout BRANCH
- checkout the BRANCH you want to work with (e.g. master
) which create local project files (because the hook script will be executed now ; this could take a while).
Open Vitis and select the cloned folder as workspace.
Click on Inport Project
, choose Import projects from Git
and click Next >
.
Choose Existing local repository
and click Next >
.
Choose the cloned / workspace folder (should be the only entry) and click Next >
.
Choose Import existing Eclipse projects
and click Next >
.
Leave everything unchanged and click Finish
.