Preskočiť na hlavný obsah

Artefakt Ninja

Prenosná binárna distribúcia Ninja, malého a rýchleho build systému zameraného na rýchlosť. Tento repozitár využíva Embedbits Platform Artifact Handler na vyhľadanie, stiahnutie, overenie a konfiguráciu Ninja v následných embedded projektoch.

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)
└── CMakeNinjaDefaults.cmake      ← Ninja 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-ninja
  main / master →  README only (this document)
  Core          →  ArtifactConfig.cmake, CMakeNinjaDefaults.cmake
  Bin           →  Anchor branch (empty commits)
  Releases      →  ninja-<version>-<platform>.zip + .hash
                    tagged Bin/<version>-<platform>  (platform: Win / Unix / DarwinARM)

NinjaImporter.sh publikuje každú verziu Ninja 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 / referenciaObsah
main / masterIba toto README — žiadny funkčný obsah
CoreSkripty handlera CMake (ArtifactConfig.cmake, CMakeNinjaDefaults.cmake) na použitie artefaktu
BinIba 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> ninja-core

# Binary + checksum for one specific version/platform (GitHub Release asset)
gh release download Bin/1.12.1-Unix --repo Embedbits/Artifact-ninja --pattern "ninja-1.12.1-Unix.*"

Súčasti balíka​

KomponentPopis
ninja / ninja.exeSpustiteľný build súbor v jedinom súbore — jediná binárka dodávaná v tomto artefakte

Použitie​

Artefakt sa inštaluje automaticky počas fázy nastavenia artefaktov príkazom:

cmake -P Artifacts/Ninja/ArtifactConfig.cmake

Skript zabezpečí, že binárka Ninja je dostupná, v prípade potreby rozbalí archív a pridá nástroj do systémovej PATH pre nasledujúce kroky buildu.

Funkcie handlera​

ninja_ArtifactInit(ARTIFACT_BIN_PATH)

Inicializuje artefakt: nájde (alebo stiahne) binárku Ninja a sprístupní ju v ARTIFACT_BIN_PATH na použitie ako spustiteľný generátor CMake (-G Ninja).

ninja_GetArtifactVersion()

Vráti verziu aktuálne vyriešenej binárky Ninja.

Verzovanie​

Verzie artefaktu zodpovedajú priamo oficiálnym verziám vydaní Ninja:

1.11.1, 1.12.0, 1.12.1, ...

Nové verzie publikuje NinjaImporter.sh 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​

Ninja sa distribuuje pod licenciou Apache License 2.0. Podrobnosti nájdete na: https://github.com/ninja-build/ninja/blob/master/COPYING

Autori​

Príspevky sú vítané! Otvorte prosím pull request.