Golang 控制 iOS 裝置實現自動化操作

由於 Appium 的內容過於豐富。。我又不太想安裝那麼多我用不到的部分。。

而且 Appium 提供的 客戶端庫 並沒有 Golang 的實現版本。

於是我寫了使用 Golang 實現 appium/WebDriverAgent 的客戶端庫。

這些天重構了部分，相對來說使用會更接近 tebeka/selenium

靈感來自 Python 版的 facebook-wda : https://github.com/openatx/facebook-wda

擴充套件庫

• electricbubble/gwda-ext-opencv 直接通過指定圖片進行操作

如果使用 Android 裝置, 可檢視 electricbubble/guia2

安裝

必須先安裝好 WDA，安裝步驟可參考 ATX 文件 - iOS 真機如何安裝 WebDriverAgent 或者 WebDriverAgent 安裝

go get github.com/electricbubble/gwda

連線裝置

package main

import (
    "github.com/electricbubble/gwda"
    "log"
)

func main() {
    // var urlPrefix = "http://localhost:8100"
    // 該函式或許還需要 `iproxy 8100 8100` 先進行裝置埠轉發
    // driver, _ := gwda.NewDriver(nil, urlPrefix)

    // 通過 USB 直連裝置
    driver, _ := gwda.NewUSBDriver(nil)

    log.Println(driver.IsWdaHealthy())
}

手勢操作

package main

import (
    "github.com/electricbubble/gwda"
)

func main() {
    driver, _ := gwda.NewUSBDriver(nil)

    x, y := 50, 256

    driver.Tap(x, y)

    driver.DoubleTap(x, y)

    driver.TouchAndHold(x, y)

    fromX, fromY, toX, toY := 50, 256, 100, 256

    driver.Drag(fromX, fromY, toX, toY)

    driver.Swipe(fromX, fromY, toX, toY)

    // 需要 3D Touch 硬體支援
    // driver.ForceTouch(x, y, 0.8)
}

自定義手勢 driver.PerformW3CActions driver.PerformAppiumTouchActions

App 操作

package main

import (
    "github.com/electricbubble/gwda"
)

func main() {
    driver, _ := gwda.NewUSBDriver(nil)

    var bundleId = "com.apple.Preferences"

    driver.AppLaunchUnattached(bundleId)

    driver.AppDeactivate(2)

    driver.AppTerminate(bundleId)

    driver.AppActivate(bundleId)

    // 重置當前 App 的 相機? 許可權
    // driver.AppAuthReset(gwda.ProtectedResourceCamera)
}

鍵盤輸入

package main

import (
    "github.com/electricbubble/gwda"
)

func main() {
    driver, _ := gwda.NewUSBDriver(nil)

    driver.SendKeys("hello")
}

指定元素的輸入 element.SendKeys

Siri 操作

package main

import (
    "github.com/electricbubble/gwda"
)

func main() {
    driver, _ := gwda.NewUSBDriver(nil)

    driver.SiriActivate("What's the weather like today")
}

彈窗操作

package main

import (
    "github.com/electricbubble/gwda"
    "log"
)

func main() {
    driver, _ := gwda.NewUSBDriver(nil)

    text, _ := driver.AlertText()
    log.Println(text)

    alertButtons, _ := driver.AlertButtons()
    log.Println(alertButtons)

    driver.AlertAccept()
    // driver.AlertDismiss()

    // driver.SendKeys("ah")
}

基本裝置資訊

package main

import (
    "github.com/electricbubble/gwda"
    "log"
)

func main() {
    driver, _ := gwda.NewUSBDriver(nil)

    deviceInfo, _ := driver.DeviceInfo()
    log.Println(deviceInfo.Name)

    batteryInfo, _ := driver.BatteryInfo()
    log.Println(batteryInfo.State)

    windowSize, _ := driver.WindowSize()
    log.Println(windowSize)

    // screen, _ := driver.Screen()
    // log.Println(screen)
}

按鍵操作

package main

import (
    "github.com/electricbubble/gwda"
)

func main() {
    driver, _ := gwda.NewUSBDriver(nil)

    // driver.Homescreen()

    driver.PressButton(gwda.DeviceButtonHome)
    driver.PressButton(gwda.DeviceButtonVolumeUp)
    driver.PressButton(gwda.DeviceButtonVolumeDown)
}

截圖

package main

import (
    "github.com/electricbubble/gwda"
    "image"
)

func main() {
    driver, _ := gwda.NewUSBDriver(nil)

    screenshot, _ := driver.Screenshot()

    img, format, _ := image.Decode(screenshot)
    _, _ = img, format
}

除錯函式

package main

import (
    "fmt"
    "github.com/electricbubble/gwda"
)

func main() {
    driver, _ := gwda.NewUSBDriver(nil)

    source, _ := driver.Source()
    fmt.Println(source)

    // fmt.Println(driver.AccessibleSource())

    // gwda.SetDebug(true)
}