forked from joejulian/gio
Elias Naur
a12912c944
The `gio` name clashes with a widely deployed GNOME tool. Rename our tool to `gogio`, "the go tool for gio programs". Fixes gio#20 Signed-off-by: Elias Naur <mail@eliasnaur.com>
52 lines
1.9 KiB
Go
52 lines
1.9 KiB
Go
// SPDX-License-Identifier: Unlicense OR MIT
|
|
|
|
package main
|
|
|
|
const mainUsage = `The gogio command builds and packages Gio (gioui.org) programs.
|
|
|
|
Usage:
|
|
|
|
gogio -target <target> [flags] <package> [run arguments]
|
|
|
|
The go tool is sufficient to build, install and run Gio programs on platforms
|
|
where a single executable is sufficient. The gogio tool can build and package Gio
|
|
programs for platforms where additional metadata or support files are required.
|
|
|
|
The package argument specifies an import path or a single Go source file to
|
|
package. Any run arguments are appended to os.Args at runtime.
|
|
|
|
If the package contains an appicon.png file, it is used as the app icon on
|
|
supported platforms.
|
|
|
|
The mandatory -target flag selects the target platform: ios or android for the
|
|
mobile platforms, tvos for Apple's tvOS, js for WebAssembly/WebGL.
|
|
|
|
The -arch flag specifies a comma separated list of GOARCHs to include. The
|
|
default is all supported architectures.
|
|
|
|
The -o flag specifies an output file or directory, depending on the target.
|
|
|
|
The -buildmode flag selects the build mode. Two build modes are available, exe
|
|
and archive. Buildmode exe outputs an .ipa file for iOS or tvOS, an .apk file
|
|
for Android or a directory with the WebAssembly module and support files for
|
|
a browser.
|
|
|
|
As a special case for iOS or tvOS, specifying a path that ends with ".app"
|
|
will output an app directory suitable for a simulator.
|
|
|
|
The other buildmode is archive, which will output an .aar library for Android
|
|
or a .framework for iOS and tvOS.
|
|
|
|
The -appid flag specifies the package name for Android or the bundle id for
|
|
iOS and tvOS. A bundle id must be provisioned through Xcode before the gogio
|
|
tool can use it.
|
|
|
|
The -version flag specifies the integer version for Android and the last
|
|
component of the 1.0.X version for iOS and tvOS.
|
|
|
|
The -work flag prints the path to the working directory and suppress
|
|
its deletion.
|
|
|
|
The -x flag will print all the external commands executed by the gogio tool.
|
|
`
|