joejulian/gio
1
0
Fork 1
mirror of https://git.sr.ht/~eliasnaur/gio synced 2026-07-01 07:35:40 +00:00
Code Issues Packages Projects Releases Wiki Activity

README.md: update for -buildmode=exe default

Browse Source 
Also, move the exe section to the beginning of the mobile sections,
leaving -buildmode=archive second.

Signed-off-by: Elias Naur <mail@eliasnaur.com>
This commit is contained in:
Elias Naur
2019-07-07 11:41:39 +02:00
parent 2c5b7496d2
commit 5b7a7334c8
1 changed files with 24 additions and 25 deletions
Download Patch File Download Diff File Expand all files Collapse all files
README.md
+24 -25
View File
@@ -52,43 +52,31 @@ with the `-token` flag:
## Android
For Android you need the Android SDK with the NDK installed. Point the ANDROID_HOME to the SDK root
directory.
directory. Use the gio tool to build a Gio program for Android:
To build a Gio program as an .aar package, use the gio tool. For example,
$ export ANDROID_HOME=...
$ go run gioui.org/cmd/gio -target android gioui.org/apps/gophers
produces gophers.aar, ready to use in an Android project. To run
a Gio program on an Android device or emulator, use -buildmode=exe:
$ go run gioui.org/cmd/gio -buildmode exe -target android gioui.org/apps/gophers
Install the apk to a running emulator or attached device with adb:
$ adb install gophers.apk
The gio tool passes command line arguments to os.Args at runtime:
$ go run gioui.org/cmd/gio -buildmode exe -target android gioui.org/apps/gophers -token <github token>
$ go run gioui.org/cmd/gio -target android gioui.org/apps/gophers -token <github token>
To build a Gio program as an .aar package, use -buildmode=archive. For example,
$ export ANDROID_HOME=...
$ go run gioui.org/cmd/gio -target android -buildmode archive gioui.org/apps/gophers
produces gophers.aar, ready to use in an Android project.
## iOS/tvOS
To build a Gio program for iOS or tvOS you need a macOS machine with Xcode installed.
To build a Gio program for iOS or tvOS you need a macOS machine with Xcode installed. The gio
tool can produce .ipa files for devices and .app directories for simulators. For a device:
The gio tool can produce a framework ready to include in an Xcode project. For example,
$ go run gioui.org/cmd/gio -target ios gioui.org/apps/gophers
outputs Gophers.framework with the demo program built for iOS. For tvOS, use `-target tvos`:
$ go run gioui.org/cmd/gio -target tvos gioui.org/apps/gophers
Building for tvOS requires (the not yet released) Go 1.13.
To run a Gio program on an iOS device, use -buildmode=exe:
$ go run gioui.org/cmd/gio -buildmode exe -target ios -appid <bundle-id> gioui.org/apps/gophers
$ go run gioui.org/cmd/gio -target ios -appid <bundle-id> gioui.org/apps/gophers
where <bundle-id> is a valid bundle identifier previously provisioned in Xcode for your device.
@@ -100,12 +88,23 @@ you can install the app directly to your device:
To run a program on a running simulator, use the -o flag with a .app directory:
$ go run gioui.org/cmd/gio/ -o gophers.app -buildmode=exe -target ios gioui.org/apps/gophers
$ go run gioui.org/cmd/gio/ -o gophers.app -target ios gioui.org/apps/gophers
Install the app with simctl:
$ xcrun simctl install booted gophers.app
Pass the -buildmode=archive flag to the gio tool to produce a framework ready to include in an
Xcode project. For example,
$ go run gioui.org/cmd/gio -target ios -buildmode archive gioui.org/apps/gophers
outputs Gophers.framework with the demo program built for iOS. For tvOS, use `-target tvos`:
$ go run gioui.org/cmd/gio -target tvos -buildmode archive gioui.org/apps/gophers
Building for tvOS requires (the not yet released) Go 1.13.
## Webassembly/WebGL
To run a Gio program in a browser with WebAssembly and WebGL support, use the Go webassembly