Útmutató a Git használatához a Unified Vitis IDE-vel

A Vitis Project beállításának automatizálása Python segítségével

Python szkript a Vitis projekt beállításához és a Git integrációhoz

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

Forrásvezérlés kezelése a Vitis Projects-ben

Shell-szkript a Vitis projekt inicializálásának és forrásvezérlésének egyszerűsítésére

#!/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

Gyakori kérdések és megoldások a Git és a Vitis IDE használatával kapcsolatban

1. Hogyan inicializálhatok egy Git-tárat egy Vitis projekthez?
2. A Git-tárat úgy inicializálhatja, hogy navigál a projekt gyökeréhez, és fut git init. Adja hozzá a szükséges fájlokat .gitignore hogy kizárja a nem kívánt fájlokat.
3. Milyen fájlokat kell tartalmaznia a .gitignore egy Vitis projekthez?
4. Tartalmazzon IDE-specifikus mappákat, mint pl build-vitis/ és build-vivado/ hogy elkerülje a verziókövető automatikusan generált fájlokat.
5. Hogyan automatizálhatom egy Vitis projekt beállítását?
6. Használjon Python-szkriptet az olyan feladatok automatizálására, mint például a platformösszetevők létrehozása és a szükséges fájlok importálása. Futtassa a szkriptet a segítségével vitis -s tools/build_app.py.
7. Miért kell manuálisan másolnom a konfigurációs fájlokat?
8. A Vitis elvárja, hogy bizonyos konfigurációs fájlok meghatározott helyeken legyenek. A fájlok manuális vagy szkripten keresztüli másolása biztosítja, hogy az IDE megfelelően megtalálja őket.
9. Hogyan kezelhetem a platform- és alkalmazásmappákat a Vitisben?
10. Zárja ki ezeket a mappákat a verziókezelésből, és használjon parancsfájlokat a szükséges fájlok kezeléséhez, biztosítva a konzisztenciát és elkerülve az útvonal-ütközéseket.
11. Szerkeszthetek forrásfájlokat közvetlenül a Vitisben a Git használata közben?
12. Igen, de győződjön meg arról, hogy a CMake beállítása a megfelelő forráskönyvtárra mutat. Előfordulhat, hogy a Vitis nem ismeri fel megfelelően a beillesztéseket és neveket a szintaxis kiemeléséhez.
13. Milyen előnyei vannak a szkriptek projektbeállításhoz való használatának?
14. A szkriptek konzisztens és megismételhető projektbeállítást biztosítanak, csökkentve a kézi hibákat és leegyszerűsítve az együttműködést a különböző környezetekben.
15. Hogyan frissíthetem a projektbeállításomat, ha módosításokat hajtanak végre?
16. Módosítsa az automatizálási szkripteket, hogy azok tükrözzék a változásokat, és futtassa újra azokat. Ez biztosítja az összes szükséges frissítés megfelelő alkalmazását.
17. Mi a teendő, ha elérési út miatti összeállítási hibákat tapasztalok?
18. Ellenőrizze a projektbeállítási parancsfájlokat, és győződjön meg arról, hogy minden elérési út helyesen van megadva. A konfliktusok elkerülése érdekében lehetőség szerint használjon relatív útvonalakat.

A Vitis és a Git munkafolyamatának lezárása

A Git integrálása a Unified Vitis IDE-vel stratégiai megközelítést igényel a verziókezelés hatékony kezelése érdekében. A Vitis által kezelt mappák kizárásával és az alapvető konfigurációs fájlokra összpontosítva a fejlesztők elkerülhetik az abszolút elérési utakkal és az IDE-specifikus metaadatokkal kapcsolatos gyakori buktatókat. Az automatizálási szkriptek tovább javítják ezt a folyamatot azáltal, hogy megismételhető és következetes projektbeállítást biztosítanak. Ezek a stratégiák biztosítják, hogy a Vitis projektek kezelhetők és együttműködőek maradjanak még összetett fejlesztési környezetben is.