go/goreleaser
go/goreleaser
1
0
Fork 0
mirror of https://github.com/goreleaser/goreleaser.git synced 2025-03-19 20:57:53 +02:00
Code Issues Releases Activity

docs: clarify cgo

Browse Source 
Signed-off-by: Carlos A Becker <caarlos0@users.noreply.github.com>
This commit is contained in:
Carlos A Becker 2022-11-24 18:17:46 -03:00
parent a1305d3912
commit eedf9578a6
No known key found for this signature in database
GPG Key ID: E61E2F7DC14AB940
2 changed files with 19 additions and 9 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

16
www/docs/cookbooks/cgo-and-crosscompiling.md
View File

@ -1,5 +1,15 @@
# Cross-compiling Go with CGO
Best option to cross-compile Go project with CGO dependencies would be in using Docker image.
[This project](https://github.com/goreleaser/goreleaser-cross) provides the docker [images](https://hub.docker.com/repository/docker/goreleaser/goreleaser-cross) with bunch of ready to use cross-compilers as well as how-to make sysroot.
All that wrapped into [example](https://github.com/goreleaser/goreleaser-cross-example)
The best option to cross-compile Go project with CGO dependencies would be in
using Docker image.
[This project](https://github.com/goreleaser/goreleaser-cross) provides the
[Docker images](https://hub.docker.com/repository/docker/goreleaser/goreleaser-cross)
with a bunch of ready-to-use cross-compilers as well as how-to make a `sysroot`.
All that wrapped into [this example](https://github.com/goreleaser/goreleaser-cross-example)
If you have [GoReleaser Pro](/pro), you can also use the split and merge feature
to build for each platform natively and merge the builds later.
Check [this article][1] for an example, and the [documentation here][2].
[1]: https://carlosbecker.com/posts/goreleaser-split-merge/
[2]: /customization/partial

12
www/docs/limitations/cgo.md
View File

@ -1,11 +1,11 @@
# CGO
If you need to cross-compile with CGO enabled, our Docker image is not
supported, and your configuration will not look that "clean", unfortunately.
Compiling with CGO is a bit trickier.
It won't work "out of the box" with or without GoReleaser: you have to set more
things up.
You can check [this cookbook](/cookbooks/cgo-and-crosscompiling/) for an
example.
[This cookbook](/cookbooks/cgo-and-crosscompiling/) contains more information.
You can also see the discussion about CGO in
[this issue](https://github.com/goreleaser/goreleaser/issues/708).
Tools like `xgo` are not natively supported, and we make no promises about
whether or how well they work withing GoReleaser or not.