Files
sanderling/internal/ios/ios.go
T
pj 007dcddd69 feat(ios): iOS e2e support — Kotlin Native SDK + simulator driver + test-ios (#38)
* feat(ios): add simulator management package

* feat(testrun): add iOS platform path (simctl launch + direct TCP)

* feat(cli): add --ios-device flag and IosDevice option

* feat(sdk-ios): add Kotlin Native iOS SDK (TCP agent + POSIX socket + dispatch pauser)

* feat(folio-ios): wire SanderlingIos.start() in MainViewController

* feat(folio-ios): add test-ios justfile recipe

* fix(sdk-ios): remove unavailable C macros; manual byte swap + no-cast warnings

* fix(testrun): simctl-first launch order for iOS; Maestro init after SDK connects
2026-04-23 17:29:53 +07:00

154 lines
3.9 KiB
Go

package ios
import (
"context"
"encoding/json"
"fmt"
"io"
"os"
"os/exec"
"strings"
"time"
)
type simDevice struct {
UDID string `json:"udid"`
State string `json:"state"`
Name string `json:"name"`
IsAvailable bool `json:"isAvailable"`
}
type simctlDeviceList struct {
Devices map[string][]simDevice `json:"devices"`
}
func EnsureSimulator(ctx context.Context, deviceName string, stdout io.Writer) error {
booted, err := bootedSimulator(ctx)
if err != nil {
return fmt.Errorf("list booted simulators: %w", err)
}
if booted != nil {
fmt.Fprintf(stdout, "using booted simulator: %s (%s)\n", booted.Name, booted.UDID)
return nil
}
available, err := availableSimulators(ctx)
if err != nil {
return fmt.Errorf("list available simulators: %w", err)
}
target, err := pickSimulator(deviceName, available)
if err != nil {
return err
}
fmt.Fprintf(stdout, "booting simulator %q (%s)...\n", target.Name, target.UDID)
if err := bootSimulator(ctx, target.UDID); err != nil {
return fmt.Errorf("boot simulator %q: %w", target.UDID, err)
}
if err := waitForSimulatorBoot(ctx, target.UDID, 60*time.Second); err != nil {
return fmt.Errorf("wait for simulator boot: %w", err)
}
fmt.Fprintf(stdout, "simulator %q ready\n", target.Name)
return nil
}
func LaunchApp(ctx context.Context, bundleID string, env map[string]string) error {
args := []string{"simctl", "launch", "--terminate-running-process", "booted", bundleID}
cmd := exec.CommandContext(ctx, "xcrun", args...)
cmd.Env = os.Environ()
for k, v := range env {
cmd.Env = append(cmd.Env, "SIMCTL_CHILD_"+k+"="+v)
}
out, err := cmd.CombinedOutput()
if err != nil {
return fmt.Errorf("launch %s: %w\n%s", bundleID, err, strings.TrimSpace(string(out)))
}
return nil
}
func bootedSimulator(ctx context.Context) (*simDevice, error) {
out, err := exec.CommandContext(ctx, "xcrun", "simctl", "list", "devices", "booted", "--json").Output()
if err != nil {
return nil, err
}
var list simctlDeviceList
if err := json.Unmarshal(out, &list); err != nil {
return nil, err
}
for _, devices := range list.Devices {
for _, d := range devices {
if d.State == "Booted" {
return &d, nil
}
}
}
return nil, nil
}
func availableSimulators(ctx context.Context) ([]simDevice, error) {
out, err := exec.CommandContext(ctx, "xcrun", "simctl", "list", "devices", "available", "--json").Output()
if err != nil {
return nil, err
}
var list simctlDeviceList
if err := json.Unmarshal(out, &list); err != nil {
return nil, err
}
var result []simDevice
for _, devices := range list.Devices {
for _, d := range devices {
if d.IsAvailable {
result = append(result, d)
}
}
}
return result, nil
}
func pickSimulator(deviceName string, available []simDevice) (*simDevice, error) {
if deviceName != "" {
for i, d := range available {
if d.Name == deviceName || d.UDID == deviceName {
return &available[i], nil
}
}
return nil, fmt.Errorf("simulator %q not found among available simulators; run `xcrun simctl list devices available` to see options", deviceName)
}
if len(available) == 0 {
return nil, fmt.Errorf("no available iOS simulators found; create one in Xcode -> Window -> Devices and Simulators")
}
for i, d := range available {
if strings.HasPrefix(d.Name, "iPhone") {
return &available[i], nil
}
}
return &available[0], nil
}
func bootSimulator(ctx context.Context, udid string) error {
return exec.CommandContext(ctx, "xcrun", "simctl", "boot", udid).Run()
}
func waitForSimulatorBoot(ctx context.Context, udid string, timeout time.Duration) error {
deadline, cancel := context.WithTimeout(ctx, timeout)
defer cancel()
ticker := time.NewTicker(2 * time.Second)
defer ticker.Stop()
for {
booted, _ := bootedSimulator(deadline)
if booted != nil && (booted.UDID == udid || udid == "") {
return nil
}
select {
case <-deadline.Done():
return deadline.Err()
case <-ticker.C:
}
}
}