Průvodce používáním Git s Unified Vitis IDE

Automatizace nastavení projektu Vitis pomocí Pythonu

Python skript pro zpracování nastavení projektu Vitis a integraci Git

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

Správa řízení zdrojů v projektech Vitis

Shell skript pro zjednodušení inicializace projektu Vitis a ovládání zdroje

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

Běžné otázky a řešení pro používání Git s Vitis IDE

1. Jak mohu inicializovat úložiště Git pro projekt Vitis?
2. Úložiště Git můžete inicializovat tak, že přejdete do kořenového adresáře projektu a spustíte jej git init. Přidejte potřebné soubory do .gitignore k vyloučení nežádoucích souborů.
3. Jaké soubory by měly být součástí .gitignore pro projekt Vitis?
4. Zahrňte složky specifické pro IDE, např build-vitis/ a build-vivado/ abyste se vyhnuli automaticky generovaným souborům s kontrolou verzí.
5. Jak mohu automatizovat nastavení projektu Vitis?
6. Použijte skript Python k automatizaci úloh, jako je vytváření komponent platformy a import potřebných souborů. Spusťte skript pomocí vitis -s tools/build_app.py.
7. Proč musím konfigurační soubory kopírovat ručně?
8. Vitis očekává, že určité konfigurační soubory budou na určitých místech. Zkopírování těchto souborů ručně nebo pomocí skriptu zajistí, že je IDE najde správně.
9. Jak zacházím se složkami platformy a aplikací ve Vitis?
10. Vylučte tyto složky ze správy verzí a pomocí skriptů spravujte potřebné soubory, čímž zajistíte konzistenci a zabráníte konfliktům cest.
11. Mohu upravovat zdrojové soubory přímo ve Vitisu při používání Gitu?
12. Ano, ale ujistěte se, že vaše nastavení CMake ukazuje na správné zdrojové adresáře. Vitis nemusí správně rozpoznat zahrnutí a názvy pro zvýraznění syntaxe.
13. Jaké jsou výhody použití skriptů pro nastavení projektu?
14. Skripty zajišťují konzistentní a opakovatelné nastavení projektu, snižují ruční chyby a zjednodušují spolupráci v různých prostředích.
15. Jak mohu aktualizovat nastavení projektu, pokud jsou provedeny změny?
16. Upravte své automatizační skripty tak, aby odrážely změny, a spusťte je znovu. Tím je zajištěno, že všechny potřebné aktualizace jsou správně aplikovány.
17. Co mám dělat, když narazím na chyby sestavení kvůli problémům s cestou?
18. Zkontrolujte skripty nastavení projektu a ujistěte se, že všechny cesty jsou správně zadány. Kde je to možné, používejte relativní cesty, abyste se vyhnuli konfliktům.

Shrnutí pracovního postupu pro Vitis a Git

Integrace Gitu s Unified Vitis IDE vyžaduje strategický přístup k efektivní správě správy verzí. Vyloučením složek spravovaných Vitis a zaměřením na základní konfigurační soubory se vývojáři mohou vyhnout běžným nástrahám spojeným s absolutními cestami a metadaty specifickými pro IDE. Automatizační skripty dále vylepšují tento proces tím, že poskytují opakovatelné a konzistentní nastavení projektu. Tyto strategie zajišťují, že projekty Vitis zůstanou zvládnutelné a spolupracující, a to i ve složitých vývojových prostředích.