From 63b56940db066ec654de000f1ae4eabee25e81b2 Mon Sep 17 00:00:00 2001 From: knoflook Date: Tue, 19 Apr 2022 16:00:28 +0200 Subject: [PATCH] add cross-compiling docs --- docs/abra/hack.md | 10 ++++++++++ 1 file changed, 10 insertions(+) diff --git a/docs/abra/hack.md b/docs/abra/hack.md index 341e462..91298c5 100644 --- a/docs/abra/hack.md +++ b/docs/abra/hack.md @@ -20,6 +20,16 @@ Our [Drone CI configuration](https://git.coopcloud.tech/coop-cloud/abra/src/bran Please use the [conventional commit format](https://www.conventionalcommits.org/en/v1.0.0/) for your commits so we can automate our change log. +### Cross-compiling + +If there's no official release for the architecture you use, you can cross-compile `abra` very easily. Clone the source code from [here](https://git.coopcloud.tech/coop-cloud/abra) and then: + +- enter the `abra` directory +- run `git tag -l` to see the list of tags, choose the latest one +- run `git checkout `, where `` is the latest version +- run `GOOS= GOARCH= [GOARM=] make build`. You only have to use `GOARM` if you're building for ARM, this specifies the ARM version (5,6,7 etc). See [this](https://go.dev/doc/install/source#environment) for a list of all supported OS'es and architectures. + + ## Release management We use [goreleaser](https://goreleaser.com) to help us automate releases. We use [semver](https://semver.org) for versioning all releases of the tool. While we are still in the public alpha release phase, we will maintain a `0.y.z-alpha` format. Change logs are generated from our commit logs. We are still working this out and aim to refine our release praxis as we go.