Vitis IDE에서 Git 시작하기
VSCode를 기반으로 하는 새로운 "Unified Vitis" IDE와 함께 Git을 사용하면 이전 Eclipse 기반 버전에 비해 고유한 문제가 발생합니다. 최신 버전에는 프로젝트 가져오기/내보내기 마법사가 없어 버전 관리를 효과적으로 관리하는 데 어려움이 있습니다.
이 가이드는 생성된 파일을 절대 경로로 처리하고 다양한 개발 시스템 간의 원활한 협업을 보장하는 등 Vitis에서 Git을 사용하는 동안 발생하는 문제를 해결하는 것을 목표로 합니다. Git을 사용하여 Vitis 프로젝트를 효율적으로 관리하기 위한 실용적인 워크플로우를 살펴보겠습니다.
명령 | 설명 |
---|---|
import vitis | Vitis 프로젝트와 프로그래밍 방식으로 상호작용하기 위해 Vitis API를 가져옵니다. |
client.set_workspace() | Vitis 클라이언트가 프로젝트 파일을 관리하기 위한 작업공간 디렉토리를 설정합니다. |
client.create_platform_component() | 지정된 하드웨어 및 OS 매개변수를 사용하여 Vitis 작업공간에 새로운 플랫폼 구성요소를 생성합니다. |
platform.build() | Vitis에서 지정된 플랫폼 구성 요소에 대한 빌드 프로세스를 트리거합니다. |
client.create_app_component() | Vitis의 지정된 플랫폼 구성 요소에 연결된 새 애플리케이션 구성 요소를 생성합니다. |
comp.import_files() | 소스 디렉터리에서 Vitis 애플리케이션 구성 요소로 필요한 파일을 가져옵니다. |
os.makedirs() | 필요한 상위 디렉터리를 포함하여 지정된 디렉터리 구조를 만듭니다. |
vitis -s tools/build_app.py | Vitis 명령줄 인터페이스를 사용하여 지정된 Python 스크립트를 실행하여 프로젝트를 설정합니다. |
echo "build-vitis/" >>echo "build-vitis/" >> .gitignore | Git 무시 파일에 빌드 디렉터리를 추가하여 버전 제어에서 제외합니다. |
git commit -m | 지정된 커밋 메시지를 사용하여 로컬 Git 저장소에 대한 단계적 변경 사항을 커밋합니다. |
Vitis 자동화 스크립트 설명
첫 번째 스크립트는 Python을 사용하여 Vitis 프로젝트 설정을 자동화합니다. 특히 필요한 모듈을 가져오는 것으로 시작됩니다. vitis 그리고 os. 그런 다음 루트 경로를 정의하고 빌드 디렉터리가 없는 경우 다음을 사용하여 생성합니다. os.makedirs(). 스크립트는 XSA 파일과 기본 소스 디렉터리에 대한 예상 경로를 설정합니다. 다음으로 Vitis 클라이언트를 생성하고 작업 공간을 새로 생성된 빌드 디렉터리로 설정합니다. 플랫폼 구성요소는 다음을 사용하여 생성됩니다. 삼, 하드웨어, OS 및 CPU 구성을 지정합니다. 플랫폼 구성 요소가 빌드되면 애플리케이션 구성 요소가 생성되어 플랫폼 구성 요소에 연결됩니다. 마지막으로 필요한 파일을 Vitis 프로젝트로 가져오고 구성 요소가 빌드됩니다.
두 번째 스크립트는 Vitis 프로젝트를 초기화하고 Git 통합을 설정하는 쉘 스크립트입니다. 루트 경로와 빌드 디렉터리를 정의하고 디렉터리가 없으면 디렉터리를 생성합니다. 그런 다음 스크립트는 다음을 사용하여 Python 스크립트를 실행합니다. vitis -s tools/build_app.py 프로젝트 설정을 자동화합니다. Python 스크립트가 실행된 후 쉘 스크립트는 루트 디렉터리로 이동하고 다음을 사용하여 Git을 초기화하여 Git 저장소를 설정합니다. git init, 그리고 빌드 디렉토리를 .gitignore 파일. 관련 파일을 준비합니다. git add 다음을 사용하여 저장소에 커밋합니다. git commit -m. 이 접근 방식을 사용하면 필요한 프로젝트 파일을 추적하면서 빌드 디렉터리가 버전 제어에서 제외됩니다.
Python으로 Vitis 프로젝트 설정 자동화
Vitis 프로젝트 설정 및 Git 통합을 처리하기 위한 Python 스크립트
import vitis
import os
ROOT_PATH = os.path.abspath(os.path.dirname(__file__))
VITIS_BUILD_DIR_PATH = os.path.join(ROOT_PATH, "build-vitis")
os.makedirs(VITIS_BUILD_DIR_PATH, exist_ok=True)
EXPECTED_XSA_FILE_PATH = os.path.join(ROOT_PATH, "build-vivado", "mydesign.xsa")
COMPONENT_NAME = "MyComponent"
MAIN_SRC_PATH = os.path.join(ROOT_PATH, "src")
client = vitis.create_client()
client.set_workspace(path=VITIS_BUILD_DIR_PATH)
PLATFORM_NAME = "platform_baremetal"
platform = client.create_platform_component(
name=PLATFORM_NAME,
hw=EXPECTED_XSA_FILE_PATH,
os="standalone",
cpu="mycpu"
)
platform = client.get_platform_component(name=PLATFORM_NAME)
status = platform.build()
comp = client.create_app_component(
name=COMPONENT_NAME,
platform=os.path.join(VITIS_BUILD_DIR_PATH, PLATFORM_NAME, "export", PLATFORM_NAME, f"{PLATFORM_NAME}.xpfm"),
domain="mydomainname"
)
comp = client.get_component(name=COMPONENT_NAME)
status = comp.import_files(
from_loc=MAIN_SRC_PATH,
files=["CMakeLists.txt", "UserConfig.cmake", "lscript.ld", "NOTUSED.cpp"],
dest_dir_in_cmp="src"
)
comp.build()
Vitis 프로젝트의 소스 제어 관리
Vitis 프로젝트 초기화 및 소스 제어를 간소화하는 쉘 스크립트
#!/bin/bash
ROOT_PATH=$(pwd)
VITIS_BUILD_DIR_PATH="$ROOT_PATH/build-vitis"
mkdir -p "$VITIS_BUILD_DIR_PATH"
EXPECTED_XSA_FILE_PATH="$ROOT_PATH/build-vivado/mydesign.xsa"
COMPONENT_NAME="MyComponent"
MAIN_SRC_PATH="$ROOT_PATH/src"
vitis -s tools/build_app.py
# After running the Python script, set up Git repository
cd "$ROOT_PATH"
git init
echo "build-vitis/" >> .gitignore
echo "build-vivado/" >> .gitignore
git add src/ tools/ .gitignore
git commit -m "Initial commit with project structure and scripts"
# Script end
Vitis IDE 및 버전 관리 이해
Git과 함께 새로운 "Unified Vitis" IDE를 사용하는 한 가지 측면에는 Vitis 프로젝트의 구조와 구성 요소를 이해하는 것이 포함됩니다. Vitis IDE는 수많은 파일을 생성하며 그 중 다수는 절대 경로를 포함하므로 버전 관리가 복잡해집니다. 이러한 파일에는 플랫폼 구성, 하드웨어 설명 및 IDE 관련 메타데이터가 포함됩니다. 이러한 파일이 적절한 처리 없이 버전 제어되면 개발자는 여러 시스템 간의 경로 불일치로 인한 빌드 오류와 같은 문제에 직면할 수 있습니다.
이러한 문제를 완화하기 위해 Vitis 관리 폴더를 버전 제어에서 제외하는 것이 일반적인 방법입니다. 대신, 링커 스크립트, CMake 파일 및 기타 필수 프로젝트 파일과 같은 중요한 구성 파일이 Vitis가 예상하는 적절한 위치에 수동으로 복사됩니다. 이 접근 방식을 사용하면 필요한 파일만 버전 관리되어 다른 개발자와 공동 작업할 때 충돌 및 오류가 발생할 위험이 줄어듭니다. 또한 Python 또는 셸 스크립트와 같은 자동화 스크립트를 사용하면 이 프로세스를 간소화하여 프로젝트 설정 및 파일 관리가 일관되고 재현 가능하도록 보장할 수 있습니다.
Vitis IDE에서 Git 사용에 대한 일반적인 질문 및 솔루션
- Vitis 프로젝트의 Git 저장소를 어떻게 초기화하나요?
- 프로젝트 루트로 이동하여 다음을 실행하여 Git 저장소를 초기화할 수 있습니다. git init. 필요한 파일을 추가하세요. .gitignore 원하지 않는 파일을 제외합니다.
- 어떤 파일이 포함되어야합니까? .gitignore Vitis 프로젝트를 위해?
- 다음과 같은 IDE 관련 폴더를 포함합니다. build-vitis/ 그리고 build-vivado/ 자동 생성된 파일의 버전 제어를 방지합니다.
- Vitis 프로젝트 설정을 어떻게 자동화할 수 있나요?
- Python 스크립트를 사용하여 플랫폼 구성 요소 생성 및 필요한 파일 가져오기와 같은 작업을 자동화합니다. 다음을 사용하여 스크립트를 실행합니다. vitis -s tools/build_app.py.
- 구성 파일을 수동으로 복사해야 하는 이유는 무엇입니까?
- Vitis는 특정 구성 파일이 특정 위치에 있을 것으로 예상합니다. 이러한 파일을 수동으로 또는 스크립트를 통해 복사하면 IDE가 해당 파일을 올바르게 찾을 수 있습니다.
- Vitis에서 플랫폼 및 애플리케이션 폴더를 어떻게 처리합니까?
- 버전 제어에서 이러한 폴더를 제외하고 스크립트를 사용하여 필요한 파일을 관리함으로써 일관성을 보장하고 경로 충돌을 방지합니다.
- Git을 사용하는 동안 Vitis에서 직접 소스 파일을 편집할 수 있나요?
- 예. 하지만 CMake 설정이 올바른 소스 디렉터리를 가리키는지 확인하세요. Vitis는 구문 강조를 위해 포함 및 이름을 올바르게 인식하지 못할 수 있습니다.
- 프로젝트 설정에 스크립트를 사용하면 어떤 이점이 있나요?
- 스크립트는 일관되고 반복 가능한 프로젝트 설정을 보장하여 수동 오류를 줄이고 다양한 환경에서의 협업을 단순화합니다.
- 변경사항이 있는 경우 프로젝트 설정을 어떻게 업데이트할 수 있나요?
- 변경 사항을 반영하도록 자동화 스크립트를 수정하고 다시 실행하세요. 이렇게 하면 필요한 모든 업데이트가 올바르게 적용됩니다.
- 경로 문제로 인해 빌드 오류가 발생하면 어떻게 해야 합니까?
- 프로젝트 설정 스크립트를 확인하고 모든 경로가 올바르게 지정되었는지 확인하세요. 충돌을 피하기 위해 가능한 경우 상대 경로를 사용하십시오.
Vitis IDE의 효율적인 버전 관리를 위한 핵심 사항
새로운 Unified Vitis IDE로 버전 제어를 구현하려면 몇 가지 중요한 단계가 필요합니다. 충돌과 오류를 피하기 위해 버전 관리에서 Vitis 생성 폴더를 제외하는 것부터 시작하십시오. 대신 링커 스크립트, CMake 파일 및 기타 중요한 프로젝트 구성 요소와 같은 필수 구성 파일을 추적하는 데 집중하세요. 자동화 스크립트, 특히 Python으로 작성된 스크립트는 프로젝트 설정을 자동화하고 필요한 모든 파일이 올바른 위치에 있는지 확인하여 이 프로세스를 크게 간소화할 수 있습니다.
설정을 자동화하면 여러 시스템에서 일관된 개발 환경을 보장하여 경로 관련 문제가 발생할 가능성을 줄일 수 있습니다. 이 접근 방식은 프로젝트 관리를 단순화할 뿐만 아니라 개발자 간의 원활한 협업을 촉진합니다. 또한 소스 파일을 원래 디렉터리에 유지하고 CMake를 사용하여 이러한 디렉터리를 가리키면 Vitis의 내부 파일 구조를 처리하는 복잡성을 피하면서 편집 및 버전 제어가 더 쉬워집니다.
Vitis 및 Git의 워크플로우 마무리
Git을 Unified Vitis IDE와 통합하려면 버전 제어를 효과적으로 관리하기 위한 전략적 접근 방식이 필요합니다. Vitis 관리 폴더를 제외하고 필수 구성 파일에 집중함으로써 개발자는 절대 경로 및 IDE 특정 메타데이터와 관련된 일반적인 함정을 피할 수 있습니다. 자동화 스크립트는 반복 가능하고 일관된 프로젝트 설정을 제공하여 이 프로세스를 더욱 향상시킵니다. 이러한 전략을 통해 Vitis 프로젝트는 복잡한 개발 환경에서도 관리 가능하고 협업적인 상태를 유지할 수 있습니다.