# ninja-build-xpack **Repository Path**: xpack-dev-tools/ninja-build-xpack ## Basic Information - **Project Name**: ninja-build-xpack - **Description**: A binary xPack with the Ninja Build tool - **Primary Language**: Unknown - **License**: MIT - **Default Branch**: xpack - **Homepage**: https://xpack.github.io/ninja-build/ - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 0 - **Created**: 2022-02-08 - **Last Updated**: 2022-10-23 ## Categories & Tags **Categories**: Uncategorized **Tags**: build, xpm, ninja, xpack ## README [![GitHub release (latest by date)](https://img.shields.io/github/v/release/xpack-dev-tools/ninja-build-xpack)](https://github.com/xpack-dev-tools/ninja-build-xpack/releases) [![npm (scoped)](https://img.shields.io/npm/v/@xpack-dev-tools/ninja-build.svg)](https://www.npmjs.com/package/@xpack-dev-tools/ninja-build/) # The xPack Ninja Build A standalone cross-platform (Windows/macOS/Linux) **Ninja Build** binary distribution, intended for reproducible builds. In addition to the the binary archives and the package meta data, this project also includes the build scripts. ## Overview This open source project is hosted on GitHub as [`xpack-dev-tools/ninja-build-xpack`](https://github.com/xpack-dev-tools/ninja-build-xpack) and provides the platform specific binaries for the [xPack Ninja Build](https://xpack.github.io/ninja-build/). This distribution follows the official [Ninja](http://ninja-build.org) build system. The binaries can be installed automatically as **binary xPacks** or manually as **portable archives**. ## Release schedule This distribution is generally one minor release behind the upstream releases. In practical terms, when the minor release number changes, it awaits a few more weeks to get the latest patch release. ## User info This section is intended as a shortcut for those who plan to use the Ninja Build binaries. For full details please read the [xPack Ninja Build](https://xpack.github.io/ninja-build/) pages. ### Easy install The easiest way to install Ninja Build is using the **binary xPack**, available as [`@xpack-dev-tools/ninja-build`](https://www.npmjs.com/package/@xpack-dev-tools/ninja-build) from the [`npmjs.com`](https://www.npmjs.com) registry. #### Prerequisites The only requirement is a recent `xpm`, which is a portable [Node.js](https://nodejs.org) command line application. To install it, follow the instructions from the [xpm](https://xpack.github.io/xpm/install/) page. #### Install With the `xpm` tool available, installing the latest version of the package and adding it as a dependency for a project is quite easy: ```sh cd my-project xpm init # Only at first use. xpm install @xpack-dev-tools/ninja-build@latest ls -l xpacks/.bin ``` This command will: - install the latest available version, into the central xPacks store, if not already there - add symbolic links to the central store (or `.cmd` forwarders on Windows) into the local `xpacks/.bin` folder. The central xPacks store is a platform dependent folder; check the output of the `xpm` command for the actual folder used on your platform). This location is configurable via the environment variable `XPACKS_STORE_FOLDER`; for more details please check the [xpm folders](https://xpack.github.io/xpm/folders/) page. It is also possible to install Ninja Build globally, in the user home folder: ```sh xpm install --global @xpack-dev-tools/ninja-build@latest ``` #### Uninstall To remove the links from the current project: ```sh cd my-project xpm uninstall @xpack-dev-tools/ninja-build ``` To completely remove the package from the global store: ```sh xpm uninstall --global @xpack-dev-tools/ninja-build ``` ### Manual install For all platforms, the **xPack Ninja Build** binaries are released as portable archives that can be installed in any location. The archives can be downloaded from the GitHub [Releases](https://github.com/xpack-dev-tools/ninja-build-xpack/releases/) page. For more details please read the [Install](https://xpack.github.io/ninja-build/install/) page. ### Versioning The version strings used by the Ninja project are three number strings like `1.11.1`; to this string the xPack distribution adds a four number, but since semver allows only three numbers, all additional ones can be added only as pre-release strings, separated by a dash, like `1.11.1-1`. When published as a npm package, the version gets a fifth number, like `1.11.1-1.1`. Since adherence of third party packages to semver is not guaranteed, it is recommended to use semver expressions like `^1.11.1` and `~1.11.1` with caution, and prefer exact matches, like `1.11.1-1.1`. ## Maintainer info - [How to build](https://github.com/xpack-dev-tools/ninja-build-xpack/blob/xpack/README-BUILD.md) - [How to publish](https://github.com/xpack-dev-tools/ninja-build-xpack/blob/xpack/README-RELEASE.md) ## Support The quick answer is to use the GitHub [Discussions](https://github.com/xpack-dev-tools/ninja-build-xpack/discussions/). For more details please read the [Support](https://xpack.github.io/ninja-build/support/) page. ## License The original content is released under the [MIT License](https://opensource.org/licenses/MIT), with all rights reserved to [Liviu Ionescu](https://github.com/ilg-ul/). The binary distributions include several open-source components; the corresponding licenses are available in the installed `distro-info/licenses` folder. ## Download analytics - GitHub [`xpack-dev-tools/ninja-build-xpack`](https://github.com/xpack-dev-tools/ninja-build-xpack/) repo - latest xPack release [![Github All Releases](https://img.shields.io/github/downloads/xpack-dev-tools/ninja-build-xpack/latest/total.svg)](https://github.com/xpack-dev-tools/ninja-build-xpack/releases/) - all xPack releases [![Github All Releases](https://img.shields.io/github/downloads/xpack-dev-tools/ninja-build-xpack/total.svg)](https://github.com/xpack-dev-tools/ninja-build-xpack/releases/) - [individual file counters](https://somsubhra.github.io/github-release-stats/?username=xpack-dev-tools&repository=ninja-build-xpack) (grouped per release) - npmjs.com [`@xpack-dev-tools/ninja-build`](https://www.npmjs.com/package/@xpack-dev-tools/ninja-build/) xPack - latest release, per month [![npm (scoped)](https://img.shields.io/npm/v/@xpack-dev-tools/ninja-build.svg)](https://www.npmjs.com/package/@xpack-dev-tools/ninja-build/) [![npm](https://img.shields.io/npm/dm/@xpack-dev-tools/ninja-build.svg)](https://www.npmjs.com/package/@xpack-dev-tools/ninja-build/) - all releases [![npm](https://img.shields.io/npm/dt/@xpack-dev-tools/ninja-build.svg)](https://www.npmjs.com/package/@xpack-dev-tools/ninja-build/) Credit to [Shields IO](https://shields.io) for the badges and to [Somsubhra/github-release-stats](https://github.com/Somsubhra/github-release-stats) for the individual file counters.