Početak rada s Gitom u Vitis IDE
Korištenje Gita s novim "Unified Vitis" IDE, temeljenim na VSCodeu, predstavlja jedinstvene izazove u usporedbi sa starijom verzijom temeljenom na Eclipseu. Čarobnjak za uvoz/izvoz projekta nedostaje u najnovijoj verziji, što uzrokuje poteškoće u učinkovitom upravljanju kontrolom verzija.
Ovaj vodič ima za cilj riješiti probleme koji se javljaju pri korištenju Gita u Vitisu, uključujući rukovanje generiranim datotekama s apsolutnim stazama i osiguravanje glatke suradnje između različitih razvojnih sustava. Istražit ćemo praktični tijek rada za učinkovito upravljanje vašim Vitis projektima s Gitom.
| Naredba | Opis |
|---|---|
| import vitis | Uvozi Vitis API za programsku interakciju s Vitis projektima. |
| client.set_workspace() | Postavlja direktorij radnog prostora za Vitis klijenta za upravljanje datotekama projekta. |
| client.create_platform_component() | Stvara novu komponentu platforme u Vitis radnom prostoru koristeći specificirane hardverske i OS parametre. |
| platform.build() | Pokreće proces izgradnje za navedenu komponentu platforme u Vitisu. |
| client.create_app_component() | Stvara novu komponentu aplikacije povezanu s navedenom komponentom platforme u Vitisu. |
| comp.import_files() | Uvozi potrebne datoteke iz izvornog direktorija u komponentu aplikacije Vitis. |
| os.makedirs() | Stvara navedenu strukturu direktorija, uključujući sve potrebne nadređene direktorije. |
| vitis -s tools/build_app.py | Pokreće navedenu Python skriptu koristeći Vitis sučelje naredbenog retka za postavljanje projekta. |
| echo "build-vitis/" >>echo "build-vitis/" >> .gitignore | Dodaje direktorij za izradu u Git ignore datoteku kako bi je isključio iz kontrole verzija. |
| git commit -m | Pokreće izmjene u fazama u lokalno Git spremište s navedenom porukom o predaji. |
Objašnjavanje skripti Vitis automatizacije
Prva skripta automatizira postavljanje Vitis projekta pomoću Pythona. Počinje uvozom potrebnih modula, konkretno vitis i os. Zatim definira korijenski put i stvara direktorij za izgradnju ako ne postoji pomoću os.makedirs(). Skripta postavlja očekivane staze za XSA datoteku i glavni izvorni direktorij. Zatim stvara Vitis klijent i postavlja radni prostor na novostvoreni direktorij za izgradnju. Komponenta platforme stvorena je pomoću client.create_platform_component(), navodeći konfiguraciju hardvera, OS-a i CPU-a. Nakon što je komponenta platforme izgrađena, kreira se komponenta aplikacije i povezuje se s komponentom platforme. Na kraju, potrebne datoteke se uvoze u Vitis projekt i komponenta je izgrađena.
Druga skripta je skripta ljuske koja inicijalizira Vitis projekt i postavlja Git integraciju. Definira korijenski put i direktorij za izgradnju, stvarajući direktorij ako ne postoji. Skripta zatim pokreće Python skriptu koristeći vitis -s tools/build_app.py za automatizaciju postavljanja projekta. Nakon što se Python skripta pokrene, skripta ljuske postavlja Git repozitorij navigacijom do korijenskog direktorija, inicijalizirajući Git s git init, i dodavanje direktorija za izgradnju u .gitignore datoteka. Postavlja relevantne datoteke s git add i predaje ih u spremište sa git commit -m. Ovaj pristup osigurava da su direktoriji za izgradnju isključeni iz kontrole verzija dok se prate potrebne projektne datoteke.
Automatizirano postavljanje projekta Vitis s Pythonom
Python skripta za rukovanje postavljanjem Vitis projekta i Git integracijom
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()
Upravljanje kontrolom izvora u Vitis projektima
Shell skripta za pojednostavljenje inicijalizacije Vitis projekta i kontrole izvora
#!/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
Razumijevanje Vitis IDE i kontrole verzija
Jedan aspekt korištenja novog "Unified Vitis" IDE-a s Gitom uključuje razumijevanje strukture i komponenti Vitis projekata. Vitis IDE generira brojne datoteke, mnoge s apsolutnim stazama, što komplicira kontrolu verzija. Ove datoteke uključuju konfiguracije platforme, opise hardvera i metapodatke specifične za IDE. Kada su te datoteke kontrolirane verzijom bez odgovarajućeg rukovanja, programeri se mogu suočiti s problemima kao što su greške u izradi zbog neusklađenih putova u različitim sustavima.
Da bi se ublažili ovi problemi, uobičajena praksa je isključivanje mapa kojima upravlja Vitis iz kontrole verzija. Umjesto toga, ključne konfiguracijske datoteke kao što su skripte povezivača, CMake datoteke i druge bitne projektne datoteke ručno se kopiraju na odgovarajuće lokacije koje očekuje Vitis. Ovaj pristup osigurava da su samo potrebne datoteke kontrolirane verzijama, smanjujući rizik od sukoba i pogrešaka prilikom suradnje s drugim programerima. Dodatno, korištenje skripti za automatizaciju kao što su Python ili skripte ljuske mogu pojednostaviti ovaj proces, osiguravajući da su postavljanje projekta i upravljanje datotekama dosljedni i ponovljivi.
Uobičajena pitanja i rješenja za korištenje Gita s Vitis IDE
- Kako da inicijaliziram Git repozitorij za Vitis projekt?
- Možete inicijalizirati Git repozitorij tako da odete do korijena projekta i pokrenete ga git init. Dodajte potrebne datoteke u .gitignore kako biste isključili neželjene datoteke.
- Koje datoteke trebaju biti uključene u .gitignore za projekt Vitis?
- Uključite mape specifične za IDE poput build-vitis/ i build-vivado/ kako biste izbjegli automatski generirane datoteke koje kontroliraju verzije.
- Kako mogu automatizirati postavljanje Vitis projekta?
- Koristite Python skriptu za automatizaciju zadataka kao što je stvaranje komponenti platforme i uvoz potrebnih datoteka. Pokrenite skriptu pomoću vitis -s tools/build_app.py.
- Zašto moram ručno kopirati konfiguracijske datoteke?
- Vitis očekuje da određene konfiguracijske datoteke budu na određenim lokacijama. Kopiranje ovih datoteka ručno ili putem skripte osigurava da ih IDE ispravno pronađe.
- Kako upravljati platformom i mapama aplikacija u Vitisu?
- Isključite ove mape iz kontrole verzija i koristite skripte za upravljanje potrebnim datotekama, osiguravajući dosljednost i izbjegavajući sukobe putanje.
- Mogu li uređivati izvorne datoteke izravno u Vitisu dok koristim Git?
- Da, ali provjerite pokazuje li vaš CMake postav na ispravne izvorne direktorije. Vitis možda neće ispravno prepoznati uključuje i imena za isticanje sintakse.
- Koje su prednosti korištenja skripti za postavljanje projekta?
- Skripte osiguravaju dosljedno i ponovljivo postavljanje projekta, smanjujući ručne pogreške i pojednostavljujući suradnju u različitim okruženjima.
- Kako mogu ažurirati postavke svog projekta ako su napravljene promjene?
- Izmijenite svoje skripte za automatizaciju kako bi odražavale promjene i ponovno ih pokrenite. Time se osigurava ispravna primjena svih potrebnih ažuriranja.
- Što trebam učiniti ako naiđem na pogreške u izradi zbog problema s putanjom?
- Provjerite svoje skripte za postavljanje projekta i osigurajte da su sve staze ispravno navedene. Koristite relativne putove gdje je to moguće kako biste izbjegli sukobe.
Ključne točke za učinkovitu kontrolu verzija u Vitis IDE
Implementacija kontrole verzija s novim Unified Vitis IDE uključuje nekoliko kritičnih koraka. Započnite isključivanjem Vitis-generiranih mapa iz kontrole verzija kako biste izbjegli sukobe i pogreške. Umjesto toga, usredotočite se na praćenje osnovnih konfiguracijskih datoteka kao što su skripte povezivača, CMake datoteke i druge vitalne komponente projekta. Skripte za automatizaciju, osobito one napisane u Pythonu, mogu značajno pojednostaviti ovaj proces automatiziranjem postavljanja projekta i osiguravanjem da su sve potrebne datoteke na ispravnim lokacijama.
Automatiziranjem postavljanja možete osigurati dosljedno razvojno okruženje u različitim sustavima, smanjujući vjerojatnost problema povezanih s putanjom. Ovaj pristup ne samo da pojednostavljuje upravljanje projektima, već također olakšava lakšu suradnju među programerima. Osim toga, čuvanje izvornih datoteka u njihovim izvornim direktorijima i korištenje CMakea za usmjeravanje na te direktorije omogućava lakše uređivanje i kontrolu verzija, dok se izbjegava složenost rada s Vitisovim internim strukturama datoteka.
Završni tijek rada za Vitis i Git
Integracija Gita s Unified Vitis IDE zahtijeva strateški pristup za učinkovito upravljanje kontrolom verzija. Isključivanjem mapa kojima upravlja Vitis i fokusiranjem na osnovne konfiguracijske datoteke, programeri mogu izbjeći uobičajene zamke povezane s apsolutnim stazama i metapodacima specifičnim za IDE. Skripte za automatizaciju dodatno poboljšavaju ovaj proces pružajući ponovljivu i dosljednu postavku projekta. Ove strategije osiguravaju da Vitis projekti ostanu upravljivi i suradnički, čak i u složenim razvojnim okruženjima.