mirror of
https://github.com/golang/go
synced 2024-11-23 20:30:04 -07:00
869c02ce1f
Update the README to mention the emulator. Remove reference to gomobile while here; there are multiple ways to develop for iOS today, including using the c-archive buildmode directly. Updates #38485 Change-Id: Iccef75e646ea8e1b9bc3fc37419cc2d6bf3dfdf4 Reviewed-on: https://go-review.googlesource.com/c/go/+/255257 Run-TryBot: Elias Naur <mail@eliasnaur.com> TryBot-Result: Go Bot <gobot@golang.org> Trust: Elias Naur <mail@eliasnaur.com> Reviewed-by: Cherry Zhang <cherryyz@google.com>
51 lines
2.4 KiB
Plaintext
51 lines
2.4 KiB
Plaintext
Go on iOS
|
|
=========
|
|
|
|
To run the standard library tests, run all.bash as usual, but with the compiler
|
|
set to the clang wrapper that invokes clang for iOS. For example, this command runs
|
|
all.bash on the iOS emulator:
|
|
|
|
GOOS=ios GOARCH=amd64 CGO_ENABLED=1 CC_FOR_TARGET=$(pwd)/../misc/ios/clangwrap.sh ./all.bash
|
|
|
|
To use the go tool to run individual programs and tests, put $GOROOT/bin into PATH to ensure
|
|
the go_ios_$GOARCH_exec wrapper is found. For example, to run the archive/tar tests:
|
|
|
|
export PATH=$GOROOT/bin:$PATH
|
|
GOOS=ios GOARCH=amd64 CGO_ENABLED=1 go test archive/tar
|
|
|
|
The go_ios_exec wrapper uses GOARCH to select the emulator (amd64) or the device (arm64).
|
|
However, further setup is required to run tests or programs directly on a device.
|
|
|
|
First make sure you have a valid developer certificate and have setup your device properly
|
|
to run apps signed by your developer certificate. Then install the libimobiledevice and
|
|
ideviceinstaller tools from https://www.libimobiledevice.org/. Use the HEAD versions from
|
|
source; the stable versions have bugs that prevents the Go exec wrapper to install and run
|
|
apps.
|
|
|
|
Second, the Go exec wrapper must be told the developer account signing identity, the team
|
|
id and a provisioned bundle id to use. They're specified with the environment variables
|
|
GOIOS_DEV_ID, GOIOS_TEAM_ID and GOIOS_APP_ID. The detect.go program in this directory will
|
|
attempt to auto-detect suitable values. Run it as
|
|
|
|
go run detect.go
|
|
|
|
which will output something similar to
|
|
|
|
export GOIOS_DEV_ID="iPhone Developer: xxx@yyy.zzz (XXXXXXXX)"
|
|
export GOIOS_APP_ID=YYYYYYYY.some.bundle.id
|
|
export GOIOS_TEAM_ID=ZZZZZZZZ
|
|
|
|
If you have multiple devices connected, specify the device UDID with the GOIOS_DEVICE_ID
|
|
variable. Use `idevice_id -l` to list all available UDIDs. Then, setting GOARCH to arm64
|
|
will select the device:
|
|
|
|
GOOS=ios GOARCH=arm64 CGO_ENABLED=1 CC_FOR_TARGET=$(pwd)/../misc/ios/clangwrap.sh ./all.bash
|
|
|
|
Note that the go_darwin_$GOARCH_exec wrapper uninstalls any existing app identified by
|
|
the bundle id before installing a new app. If the uninstalled app is the last app by
|
|
the developer identity, the device might also remove the permission to run apps from
|
|
that developer, and the exec wrapper will fail to install the new app. To avoid that,
|
|
install another app with the same developer identity but with a different bundle id.
|
|
That way, the permission to install apps is held on to while the primary app is
|
|
uninstalled.
|