Почетак рада са Гитом у Витис ИДЕ
Коришћење Гита са новим „Унифиед Витис“ ИДЕ, заснованим на ВСЦоде-у, представља јединствене изазове у поређењу са старијом верзијом заснованом на Ецлипсе-у. Чаробњак за увоз/извоз пројекта недостаје у најновијој верзији, што узрокује потешкоће у ефикасном управљању контролом верзија.
Овај водич има за циљ да се позабави проблемима са којима се сусрећу током коришћења Гит-а у Витис-у, укључујући руковање генерисаним датотекама са апсолутним путањама и обезбеђивање несметане сарадње у различитим развојним системима. Истражићемо практичан ток посла за ефикасно управљање вашим Витис пројектима помоћу Гита.
| Цомманд | Опис |
|---|---|
| import vitis | Увози Витис АПИ за програмску интеракцију са Витис пројектима. |
| client.set_workspace() | Поставља директоријум радног простора за Витис клијент за управљање пројектним датотекама. |
| client.create_platform_component() | Креира нову компоненту платформе у Витис радном простору користећи специфициране хардверске и ОС параметре. |
| platform.build() | Покреће процес изградње за наведену компоненту платформе у Витис-у. |
| client.create_app_component() | Креира нову компоненту апликације повезану са наведеном компонентом платформе у Витису. |
| comp.import_files() | Увози неопходне датотеке из изворног директоријума у компоненту апликације Витис. |
| os.makedirs() | Креира наведену структуру директоријума, укључујући све неопходне родитељске директоријуме. |
| vitis -s tools/build_app.py | Покреће наведену Питхон скрипту користећи Витис интерфејс командне линије за подешавање пројекта. |
| echo "build-vitis/" >>echo "build-vitis/" >> .gitignore | Додаје директоријум изградње у Гит датотеку игнорисања да би је искључио из контроле верзија. |
| git commit -m | Урезује постепено измене у локално Гит спремиште са наведеном поруком урезивања. |
Објашњење скрипти Витис Аутоматион
Прва скрипта аутоматизује подешавање Витис пројекта користећи Питхон. Почиње увозом потребних модула, конкретно vitis и os. Затим дефинише роот путању и креира директоријум за изградњу ако не постоји користећи os.makedirs(). Скрипта поставља очекиване путање за КССА датотеку и главни изворни директоријум. Затим креира Витис клијент и поставља радни простор у новокреирани директоријум за изградњу. Компонента платформе је креирана са client.create_platform_component(), наводећи хардвер, ОС и конфигурацију ЦПУ-а. Када је компонента платформе направљена, компонента апликације се креира и повезује са компонентом платформе. Коначно, потребне датотеке се увозе у Витис пројекат и компонента је изграђена.
Друга скрипта је схелл скрипта која иницијализује Витис пројекат и поставља Гит интеграцију. Он дефинише корен путању и директоријум за изградњу, креирајући директоријум ако не постоји. Скрипта затим покреће Питхон скрипту користећи vitis -s tools/build_app.py за аутоматизацију подешавања пројекта. Након што се Питхон скрипта покрене, схелл скрипта поставља Гит спремиште навигацијом до основног директоријума, иницијализирајући Гит помоћу git init, и додавање директоријума за изградњу у .gitignore фајл. Он поставља релевантне датотеке са git add и уписује их у спремиште са git commit -m. Овај приступ обезбеђује да директоријуми за изградњу буду искључени из контроле верзија док се прате неопходне датотеке пројекта.
Аутоматизација подешавања пројекта Витис са Питхон-ом
Питхон скрипта за руковање подешавањем Витис пројекта и Гит интеграцијом
import vitisimport osROOT_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()
Управљање изворном контролом у Витис пројектима
Схелл скрипта за поједностављење иницијализације Витис пројекта и контроле извора
#!/bin/bashROOT_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 repositorycd "$ROOT_PATH"git initecho "build-vitis/" >> .gitignoreecho "build-vivado/" >> .gitignoregit add src/ tools/ .gitignoregit commit -m "Initial commit with project structure and scripts"# Script end
Разумевање Витис ИДЕ и контроле верзија
Један аспект коришћења новог „Унифиед Витис“ ИДЕ-а са Гитом укључује разумевање структуре и компоненти Витис пројеката. Витис ИДЕ генерише бројне датотеке, многе са апсолутним путањама, што компликује контролу верзија. Ове датотеке укључују конфигурације платформе, описе хардвера и метаподатке специфичне за ИДЕ. Када су ове датотеке контролисане верзијама без правилног руковања, програмери се могу суочити са проблемима као што су грешке у изградњи због неусклађених путања у различитим системима.
Да би се ублажили ови проблеми, уобичајена пракса је да се фасцикле којима управља Витис изузме из контроле верзија. Уместо тога, кључне конфигурационе датотеке као што су линкер скрипте, ЦМаке датотеке и друге битне пројектне датотеке се ручно копирају на одговарајуће локације које очекује Витис. Овај приступ обезбеђује да само неопходне датотеке буду контролисане верзијама, смањујући ризик од сукоба и грешака приликом сарадње са другим програмерима. Поред тога, коришћење скрипти за аутоматизацију попут Питхон-а или схелл скрипти може поједноставити овај процес, обезбеђујући да су подешавање пројекта и управљање датотекама доследни и поновљиви.
Уобичајена питања и решења за коришћење Гит-а са Витис ИДЕ
- Како да иницијализујем Гит спремиште за Витис пројекат?
- Можете иницијализовати Гит спремиште тако што ћете отићи до корена пројекта и покренути га git init. Додајте потребне датотеке у .gitignore да бисте искључили нежељене датотеке.
- Које датотеке треба да буду укључене у .gitignore за Витис пројекат?
- Укључите фасцикле специфичне за ИДЕ као што су build-vitis/ и build-vivado/ да бисте избегли аутоматски генерисане датотеке које контролишу верзију.
- Како могу да аутоматизујем подешавање Витис пројекта?
- Користите Питхон скрипту за аутоматизацију задатака као што су креирање компоненти платформе и увоз неопходних датотека. Покрените скрипту користећи vitis -s tools/build_app.py.
- Зашто морам ручно да копирам конфигурационе датотеке?
- Витис очекује да одређене конфигурационе датотеке буду на одређеним локацијама. Копирање ових датотека ручно или путем скрипте осигурава да их ИДЕ исправно пронађе.
- Како да рукујем фасциклама платформе и апликација у Витис-у?
- Искључите ове фасцикле из контроле верзија и користите скрипте за управљање потребним датотекама, обезбеђујући доследност и избегавајући сукобе путања.
- Могу ли да мењам изворне датотеке директно у Витис-у док користим Гит?
- Да, али уверите се да ваше ЦМаке подешавање указује на исправне изворне директоријуме. Витис можда неће исправно препознати укључује и имена за истицање синтаксе.
- Које су предности коришћења скрипти за подешавање пројекта?
- Скрипте обезбеђују конзистентно и поновљиво подешавање пројекта, смањујући ручне грешке и поједностављујући сарадњу у различитим окружењима.
- Како могу да ажурирам подешавања свог пројекта ако су направљене промене?
- Измените своје скрипте за аутоматизацију тако да одражавају промене и поново их покрените. Ово осигурава да се сва потребна ажурирања правилно примењују.
- Шта да радим ако наиђем на грешке у изградњи због проблема са путањом?
- Проверите скрипте за подешавање пројекта и уверите се да су све путање исправно наведене. Користите релативне путање где је то могуће да бисте избегли конфликте.
Кључне тачке за ефикасну контролу верзија у Витис ИДЕ
Имплементација контроле верзија са новим Унифиед Витис ИДЕ укључује неколико критичних корака. Почните тако што ћете искључити фасцикле које генерише Витис из контроле верзија да бисте избегли конфликте и грешке. Уместо тога, фокусирајте се на праћење основних конфигурационих датотека као што су линкер скрипте, ЦМаке датотеке и друге виталне компоненте пројекта. Скрипте за аутоматизацију, посебно оне написане у Питхон-у, могу значајно поједноставити овај процес аутоматизацијом подешавања пројекта и осигуравањем да су све потребне датотеке на исправним локацијама.
Аутоматизацијом подешавања можете обезбедити конзистентно развојно окружење у различитим системима, смањујући вероватноћу проблема у вези са путањом. Овај приступ не само да поједностављује управљање пројектима, већ и олакшава глаткију сарадњу међу програмерима. Поред тога, чување изворних датотека у њиховим оригиналним директоријумима и коришћење ЦМаке-а за указивање на ове директоријуме омогућава лакше уређивање и контролу верзија, док избегавате сложеност рада са Витис-овим интерним структурама датотека.
Завршавање тока рада за Витис и Гит
Интеграција Гита са Унифиед Витис ИДЕ захтева стратешки приступ за ефикасно управљање контролом верзија. Искључивањем фасцикли којима управља Витис и фокусирањем на основне конфигурационе датотеке, програмери могу да избегну уобичајене замке повезане са апсолутним путањама и метаподацима специфичним за ИДЕ. Скрипте за аутоматизацију додатно побољшавају овај процес обезбеђујући поновљиво и доследно подешавање пројекта. Ове стратегије осигуравају да Витис пројекти остану управљиви и сарађују, чак иу сложеним развојним окружењима.