Giti kasutamise juhend Unified Vitis IDE-ga

Giti kasutamise juhend Unified Vitis IDE-ga
Giti kasutamise juhend Unified Vitis IDE-ga
Lucas Simon
Pühapäev, 26. mai 2024 17:56:39

Gitiga alustamine Vitis IDE-s

Giti kasutamine uue VSCode'il põhineva IDE-ga "Unified Vitis" esitab võrreldes vanema Eclipse'i-põhise versiooniga ainulaadseid väljakutseid. Projekti impordi/ekspordi viisard puudub uusimas versioonis, mis põhjustab raskusi versioonihalduse tõhusal haldamisel.

Selle juhendi eesmärk on käsitleda Giti Vitis kasutamisel ilmnenud probleeme, sealhulgas absoluutsete teedega loodud failide käsitlemist ja sujuva koostöö tagamist erinevate arendussüsteemide vahel. Uurime praktilist töövoogu, kuidas Gitiga teie Vitise projekte tõhusalt hallata.

Käsk Kirjeldus
import vitis Impordib Vitise API, et Vitise projektidega programmiliselt suhelda.
client.set_workspace() Määrab Vitise kliendi tööruumi kataloogi projektifailide haldamiseks.
client.create_platform_component() Loob uue platvormi komponendi Vitise tööruumis, kasutades määratud riistvara ja OS-i parameetreid.
platform.build() Käivitab Vitis määratud platvormikomponendi ehitusprotsessi.
client.create_app_component() Loob uue rakenduse komponendi, mis on lingitud Vitis määratud platvormikomponendiga.
comp.import_files() Impordib vajalikud failid lähtekataloogist Vitise rakenduse komponenti.
os.makedirs() Loob määratud kataloogistruktuuri, sealhulgas kõik vajalikud ülemkataloogid.
vitis -s tools/build_app.py Käivitab määratud Pythoni skripti, kasutades projekti seadistamiseks Vitise käsurea liidest.
echo "build-vitis/" >>echo "build-vitis/" >> .gitignore Lisab Giti ignoreerimisfaili ehituskataloogi, et see versioonikontrollist välja jätta.
git commit -m Kinnitab etapiviisilised muudatused kohalikku Giti hoidlasse määratud kinnitussõnumiga.

Vitise automatiseerimisskriptide selgitamine

Esimene skript automatiseerib Vitise projekti seadistamise Pythoni abil. See algab konkreetselt vajalike moodulite importimisega vitis ja os. Seejärel määratleb see juurtee ja loob ehituskataloogi, kui seda ei eksisteeri os.makedirs(). Skript seadistab XSA-faili ja peamise lähtekataloogi eeldatavad teed. Järgmisena loob see Vitise kliendi ja seab tööruumi vastloodud ehituskataloogi. Platvormi komponent luuakse koos client.create_platform_component(), täpsustades riistvara, OS-i ja protsessori konfiguratsiooni. Kui platvormi komponent on loodud, luuakse rakenduse komponent ja lingitakse see platvormi komponendiga. Lõpuks imporditakse vajalikud failid Vitise projekti ja komponent ehitatakse.

Teine skript on kestaskript, mis initsialiseerib Vitise projekti ja seadistab Giti integratsiooni. See määrab juurtee ja ehituskataloogi, luues kataloogi, kui seda pole olemas. Seejärel käivitab skript Pythoni skripti kasutades vitis -s tools/build_app.py projekti seadistamise automatiseerimiseks. Pärast Pythoni skripti käitamist seadistab kestaskript Giti hoidla, navigeerides juurkataloogi ja initsialiseerides Giti git initja ehituskataloogide lisamine .gitignore faili. See lavastab asjakohased failid koos git add ja kannab need hoidlasse koos git commit -m. See lähenemisviis tagab, et ehituskataloogid jäetakse versioonikontrollist välja, säilitades samal ajal vajalikke projektifaile.

Vitise projekti seadistamise automatiseerimine Pythoniga

Pythoni skript Vitise projekti seadistamiseks ja Giti integreerimiseks

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()

Allika juhtimise haldamine Vitis Projects

Shelliskript Vitise projekti lähtestamise ja allika juhtimise sujuvamaks muutmiseks

#!/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 ja versioonikontrolli mõistmine

Üks aspekt uue "Unified Vitis" IDE kasutamisel koos Gitiga hõlmab Vitise projektide struktuuri ja komponentide mõistmist. Vitis IDE genereerib arvukalt faile, millest paljud on absoluutsete teedega, mis muudab versioonihalduse keerulisemaks. Need failid sisaldavad platvormi konfiguratsioone, riistvara kirjeldusi ja IDE-spetsiifilisi metaandmeid. Kui nende failide versioon on kontrollitud ilma nõuetekohase käsitsemiseta, võivad arendajad silmitsi seista probleemidega, nagu koostamisvead, mis tulenevad eri süsteemide sobimatusest.

Nende probleemide leevendamiseks on levinud praktika Vitise hallatavate kaustade väljajätmine versioonikontrollist. Selle asemel kopeeritakse olulised konfiguratsioonifailid, nagu linkeri skriptid, CMake'i failid ja muud olulised projektifailid käsitsi Vitise soovitud asukohtadesse. Selline lähenemine tagab, et versioonipõhiselt juhitakse ainult vajalikke faile, mis vähendab konfliktide ja vigade ohtu koostöös teiste arendajatega. Lisaks võib automatiseerimisskriptide (nt Python) või shelliskriptide kasutamine seda protsessi sujuvamaks muuta, tagades, et projekti häälestus ja failihaldus on järjepidev ja reprodutseeritav.

Levinud küsimused ja lahendused Giti kasutamisel koos Vitis IDE-ga

  1. Kuidas initsialiseerida Vitise projekti Giti hoidlat?
  2. Giti hoidla saab lähtestada, navigeerides projekti juure ja käivitades git init. Lisage vajalikud failid .gitignore soovimatute failide välistamiseks.
  3. Millised failid tuleks lisada .gitignore Vitise projekti jaoks?
  4. Kaasake IDE-spetsiifilised kaustad nagu build-vitis/ ja build-vivado/ et vältida automaatselt genereeritud failide versioonikontrolli.
  5. Kuidas saan Vitise projekti seadistamist automatiseerida?
  6. Kasutage Pythoni skripti selliste toimingute automatiseerimiseks nagu platvormi komponentide loomine ja vajalike failide importimine. Käivitage skript kasutades vitis -s tools/build_app.py.
  7. Miks ma pean konfiguratsioonifaile käsitsi kopeerima?
  8. Vitis eeldab, et teatud konfiguratsioonifailid asuvad kindlates asukohtades. Nende failide käsitsi või skripti abil kopeerimine tagab, et IDE leiab need õigesti.
  9. Kuidas Vitis platvormi ja rakenduste kaustu käsitleda?
  10. Välistage need kaustad versioonikontrollist ja kasutage vajalike failide haldamiseks skripte, tagades järjepidevuse ja vältides teede konflikte.
  11. Kas saan Giti kasutamise ajal lähtefaile otse Vitises redigeerida?
  12. Jah, kuid veenduge, et teie CMake'i seadistus osutaks õigetele lähtekataloogidele. Vitis ei pruugi süntaksi esiletõstmise jaoks süntaksi esiletõstmiseks süntakses esiletõstmiseks sünteesid ja nimesid õigesti ära tunda.
  13. Mis kasu on projekti seadistamisel skriptide kasutamisest?
  14. Skriptid tagavad järjepideva ja korratava projekti seadistuse, vähendades käsitsi vigu ja lihtsustades koostööd erinevates keskkondades.
  15. Kuidas saan oma projekti seadistust värskendada, kui muudatusi tehakse?
  16. Muutke oma automatiseerimisskripte muudatuste kajastamiseks ja käivitage need uuesti. See tagab, et kõik vajalikud värskendused rakendatakse õigesti.
  17. Mida peaksin tegema, kui teeprobleemidest tulenevad ehitusvigad?
  18. Kontrollige oma projekti seadistusskripte ja veenduge, et kõik teed on õigesti määratud. Konfliktide vältimiseks kasutage võimaluse korral suhtelisi teid.

Vitis IDE tõhusa versioonikontrolli põhipunktid

Versioonikontrolli juurutamine uue Unified Vitis IDE-ga hõlmab mitmeid olulisi samme. Alustuseks jätke Vitise loodud kaustad versioonikontrollist välja, et vältida konflikte ja vigu. Selle asemel keskenduge oluliste konfiguratsioonifailide, nagu linkeri skriptid, CMake-failid ja muud olulised projektikomponendid, jälgimisele. Automatiseerimisskriptid, eriti need, mis on kirjutatud Pythonis, võivad seda protsessi märkimisväärselt lihtsustada, automatiseerides projekti seadistamise ja tagades, et kõik vajalikud failid on õigetes asukohtades.

Seadistuse automatiseerimisega saate tagada järjepideva arenduskeskkonna erinevates süsteemides, vähendades teega seotud probleemide tõenäosust. Selline lähenemine mitte ainult ei lihtsusta projektijuhtimist, vaid hõlbustab ka sujuvamat koostööd arendajate vahel. Lisaks võimaldab lähtefailide hoidmine nende algsetes kataloogides ja CMake'i kasutamine nendele kataloogidele osutamiseks lihtsamat redigeerimist ja versioonikontrolli, vältides samal ajal Vitise sisemiste failistruktuuridega tegelemise keerukust.

Vitise ja Giti töövoo kokkuvõte

Giti integreerimine Unified Vitis IDE-ga nõuab strateegilist lähenemist, et tõhusalt hallata versioonihaldust. Välistades Vitise hallatavad kaustad ja keskendudes olulistele konfiguratsioonifailidele, saavad arendajad vältida tavalisi lõkse, mis on seotud absoluutsete teede ja IDE-spetsiifiliste metaandmetega. Automatiseerimisskriptid täiustavad seda protsessi veelgi, pakkudes korratavat ja järjepidevat projekti seadistust. Need strateegiad tagavad, et Vitise projektid jäävad juhitavaks ja koostöövõimeliseks isegi keerukates arenduskeskkondades.