Artefakt gcc
Prenosná binárna distribúcia natívneho hostiteľského toolchainu GNU Compiler Collection (GCC). Tento repozitár využíva Embedbits Platform Artifact Handler na vyhľadanie, stiahnutie, overenie a konfiguráciu hostiteľského GCC v následných embedded projektoch — používa sa na zostavenie nástrojov pre hostiteľa a spúšťanie unit testov na build stroji (na rozdiel od gcc-arm-none-eabi, ktorý cieli na embedded hardvér ARM Cortex).
Tento repozitár je rozdelený do troch vetiev/referencií podľa úlohy — vetva main (master), ktorú práve čítate, obsahuje iba túto dokumentáciu; skripty handlera sú vo vetve Core a verzované binárky sa publikujú ako GitHub Releases ukotvené vo vetve Bin.
Obsah repozitára
main / master
└── README.md ← This document — no other content
Core
├── ArtifactConfig.cmake ← Artifact metadata (name, version constraints, asset naming)
└── CMakeGccDefaults.cmake ← GCC integration logic (artifact init, version lookup)
Bin (anchor branch — no tracked binary files)
└── (empty commits only; each release tag points here)
Úloha v platforme
Tento repozitár je jednou z viacerých distribúcií artefaktov v platforme Embedbits. Celkový tok vyzerá takto:
GitHub (Embedbits)
──────────────────────────────────────────────────────────
Artifact-gcc
main / master → README only (this document)
Core → ArtifactConfig.cmake, CMakeGccDefaults.cmake
Bin → Anchor branch (empty commits)
Releases → gcc-<version>-<platform>.zip + .hash
tagged Bin/<version>-<platform> (platform: Win / Unix / DarwinARM)
Importovací skript v štýle Gcc publikuje každú verziu GCC ako GitHub Release — označené Bin/<version>-<platform> — namiesto súboru commitnutého do vetvy Bin. Samotná vetva Bin obsahuje iba prázdne kotviace commity, na ktoré ukazujú značky vydaní.
Platform Artifact Handler v následných projektoch odkazuje na vetvu Core ako na Git submodul. Počas konfigurácie CMake načíta ArtifactConfig.cmake, aby zistil, ktoré vydanie sa má stiahnuť, a potom stiahne a overí zodpovedajúci asset vydania pre aktuálnu platformu.
Štruktúra vetiev
| Vetva / referencia | Obsah |
|---|---|
main / master | Iba toto README — žiadny funkčný obsah |
Core | Skripty handlera CMake (ArtifactConfig.cmake, CMakeGccDefaults.cmake) na použitie artefaktu |
Bin | Iba kotviaca vetva — nie sú v nej commitnuté žiadne binárky |
Značka vydania Bin/<version>-<platform> | GitHub Release, ktoré ako assety vydania nesie samotnú binárku .zip a súbor s kontrolným súčtom .hash, pre platform ∈ Win, Unix, DarwinARM |
Poznámka: Samotný protokol Embedbits Artifact Handler nie je viazaný na GitHub Releases — len importovacie skripty hostované na GitHube publikujú binárky práve takto. Na Git hostingu bez ekvivalentného Releases API handler podporuje aj zabalené binárky commitnuté priamo ako sledované súbory vo vetve
Bin, označené značkou pre každú verziu/platformu (Bin/<version>-<platform>), namiesto nahrania ako assety vydania. Handler CMake transparentne spracuje obe formy.
⚠️ Stiahnutie vydania
Binárky nie sú uložené ako sledované súbory vo vetve Bin — skripty handlera získate klonovaním vetvy Core a binárky sťahujte ako assety vydania pre konkrétnu značku namiesto klonovania vetvy Bin.
# Core handler scripts
git clone --branch Core --single-branch --depth=1 <repository_url> gcc-core
# Binary + checksum for one specific version/platform (GitHub Release asset)
gh release download Bin/13.2.0-Unix --repo Embedbits/Artifact-gcc --pattern "gcc-13.2.0-Unix.*"
Súčasti balíka
| Komponent | Popis |
|---|---|
gcc, g++ | Ovládače kompilátorov C a C++ |
ar, ld, nm, objcopy, objdump | Priložené nástroje toolchainu Binutils |
gdb | Debugger (ak je súčasťou upstream vydania) |
Použitie
Artefakt sa inštaluje automaticky počas fázy nastavenia artefaktov príkazom:
cmake -P Artifacts/Gcc/ArtifactConfig.cmake
Skript zabezpečí, že toolchain GCC je dostupný, v prípade potreby rozbalí archív a pridá nástroj do systémovej PATH pre nasledujúce kroky buildu.
Funkcie handlera
Gcc_ArtifactInit(ARTIFACT_BIN_PATH)
Inicializuje artefakt: nájde (alebo stiahne) toolchain GCC a sprístupní jeho adresár bin/ v ARTIFACT_BIN_PATH.
Gcc_GetArtifactVersion()
Vráti verziu aktuálne vyriešeného toolchainu GCC.
Verzovanie
Verzie artefaktu zodpovedajú priamo oficiálnym verziám vydaní GCC:
12.2.0, 13.2.0, 14.2.0, ...
Nové verzie publikuje importovací skript v štýle Gcc v repozitári GithubArtifactsHandler, ktorý stiahne oficiálne binárky, zabalí ich do archívov .zip s overením SHA-256 a publikuje ich ako GitHub Release označené Bin/<version>-<platform> — samotná vetva Bin sa posúva iba prázdnym kotviacim commitom, na ktorý značka ukazuje.
Poznámky
- Inštalácia nie je potrebná — binárky sú prenosné a samostatné.
- Offline použitie je podporované, keď je artefakt lokálne v cache.
- V Azure DevOps pipeline sa odporúča cachovať priečinok artefaktu, aby sa skrátil čas buildu.
Licencia
GCC sa distribuuje pod licenciou GNU General Public License (GPL) v3 s výnimkou pre runtime knižnicu vzťahujúcou sa na skompilovaný výstup. Podrobnosti nájdete na: https://www.gnu.org/licenses/gcc-exception-3.1.html
Autori
- Mr.Nobody — embedbits.com
Príspevky sú vítané! Otvorte prosím pull request.