From c7802de1542f2014d9fd6a3f1a1d4701b6f7ebba Mon Sep 17 00:00:00 2001 From: Michael Sanford Date: Tue, 29 Jan 2019 10:39:24 -0500 Subject: Document cross-platform console window details Fixes #55. Explain how to hide the console window when running on Windows / macOS.--- README.md | 28 ++++++++++++++++++++++++++++ 1 file changed, 28 insertions(+) diff --git a/README.md b/README.md index 626c132..1242372 100644 --- a/README.md +++ b/README.md @@ -44,6 +44,34 @@ go get go run main.go ``` +## Building and the Console Window + +By default, the binary created by `go build` will cause a console window to be opened on both Windows and macOS when run. + +### Windows + +To prevent launching a console window when running on Windows, add these command-line build flags: + +```sh +go build -ldflags -H=windowsgui +``` + +### macOS + +On macOS, you will need to create an application bundle to wrap the binary; simply folders with the following minimal structure and assets: + +``` +SystrayApp.app/ + Contents/ + Info.plist + MacOS/ + go-executable + Resources/ + SystrayApp.icns +``` + +Consult the [Official Apple Documentation here](https://developer.apple.com/library/archive/documentation/CoreFoundation/Conceptual/CFBundles/BundleTypes/BundleTypes.html#//apple_ref/doc/uid/10000123i-CH101-SW1). + ## Credits - https://github.com/xilp/systray -- cgit v1.2.3