electricbubble / gwda

WebDriverAgent ( iOS ) Client Library in Golang

Golang-WDA

appium/WebDriverAgent Client Library in Golang

Android can use electricbubble/guia2

English | 🇨🇳中文

Installation

First, install WebDriverAgent for iOS devices

go get github.com/electricbubble/gwda

QuickStart

Connection Device

package main

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

func main() {
	// var urlPrefix = "http://localhost:8100"
	// The function may also require 'iproxy 8100 8100' to forward the device port first
	// driver, _ := gwda.NewDriver(nil, urlPrefix)

	// Connect devices via USB
	driver, _ := gwda.NewUSBDriver(nil)

	log.Println(driver.IsWdaHealthy())
}

Touch

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)

	// requires hardware support: 3D Touch 
	// driver.ForceTouch(x, y, 0.8)
}

AssistiveTouch driver.PerformW3CActions driver.PerformAppiumTouchActions

App Actions

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)

	// Resets the 📷 camera authorization status of the current application
	// driver.AppAuthReset(gwda.ProtectedResourceCamera)
}

Keyboard

package main

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

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

	driver.SendKeys("hello")
}

specified element element.SendKeys

Siri

package main

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

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

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

Alert

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")
}

Device information

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)

	location, err := driver.Location()
	if err != nil {
		log.Fatalln(err)
	}
	log.Println(location)

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

Hardware button

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)
}

Screenshot

package main

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

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

	screenshot, _ := driver.Screenshot()

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

Debug

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)
}

Extensions

	About
electricbubble/gwda-ext-opencv	Operate with pictures

Alternatives

	About
openatx/facebook-wda	Facebook WebDriverAgent Python Client Library (not official)

Thanks

Thank you JetBrains for providing free open source licenses

gwda's Issues

解析截图失败

版本：

• webdriveragent-xcode_12.3.zip v2.32.2
• github.com/electricbubble/gwda v0.1.1
• iOS 13.4.1

bs, err := driver.Screenshot()
session, _ := driver.ActiveSession()
t.Log(session.SessionId)
if nil != err {
	t.Error("screenshot", err)
} else {
	// dst := base64.StdEncoding.EncodeToString(bs.Bytes())
	// t.Log(dst)
	img, format, err := image.Decode(bs)
	if nil != err {
		t.Error("decode", err) // image: unknown format <===
	} else {
		t.Log(bs.Len(), img, format)
	}
}

经浏览器直接请求截图看到，返回的图片 base64 是带有 \r\n 换行符的，是否因这个问题解析失败呢？

如下图所示：

如何区分usb上连接的两个不同设备?

	driver, _ := gwda.NewUSBDriver(nil)

传参中 如何指定某一台设备

How does USBDriver work？

I found this code in NewUSBDriver

if wd.urlPrefix, err = url.Parse("http://" + dev.serialNumber); err != nil {
		return nil, err
}

but why http://xxxxxx can work in code？

请问有支持安卓手机的版本吗？

请问有支持安卓手机的版本吗？

多设备的话如何管理？

如果多个设备连接到pc，怎么去识别多个设备呢？

Error on info example.

With the info example i get the following error:

2021/07/16 18:44:36 create connection: usbmux receive: connection refused
exit status 1

src/github.com/electricbubble/gidevice/pkg/ipa/ipa.go:35:17: undefined: io.ReadAll

我的代码是这样的

	driver, err := gwda.NewUSBDriver(nil)
	if err != nil {
		log.Fatalln(err)
	}

	log.Println(driver.IsWdaHealthy())

但运行时报了个这个错

src/github.com/electricbubble/gidevice/pkg/ipa/ipa.go:35:17: undefined: io.ReadAll

go get错误，建议增加相应的安装说明

$ go get -v github.com/ElectricBubble/gwda
go: finding github.com/ElectricBubble/gwda latest
go: downloading github.com/ElectricBubble/gwda v0.0.0-20200511015801-0e9736d3712a
go: extracting github.com/ElectricBubble/gwda v0.0.0-20200511015801-0e9736d3712a
go get: github.com/ElectricBubble/[email protected]: parsing go.mod:
	module declares its path as: github.com/electricbubble/gwda
	        but was required as: github.com/ElectricBubble/gwda

在执行ios自动化的时候，会出现Invalid parameter not satisfying: point.x != INFINITY && point.y != INFINITY这个错误

并且只要出现一次这个错误，接下来短时间内大概率还会出现多次。

然后过一会儿，又自己恢复了

使用这个gwda给视频点赞（或者点关注），会掉赞（掉关注）

使用这个gwda给视频点赞（或者点关注），会掉赞（掉关注），可能的原因有哪些，流程肯定没问题，我在担心是不是gwda这个东西被抖音标记了

demo usb连接失败是什么错误

2020/08/19 15:52:28 连接设备 usb connect: connection refused

如何连接指定的手机，通过usb

您好，一台Mac上有4台手机，通过usb连接，如何指定某个手机进行连接，请问是不是需要我修改代码，因为gwda.NewUSBDriver(nil)方法中的device参数没有公共成员。

Android不可以吗

开启抖音，跑测试的时候卡死了

开启抖音，跑测试的时候程序卡死了，抖音也卡死了

能不能通过IP地址连接iphone呢？

不想连数据线

unknown command: Unhandled endpoint:

测试了 其他的指令都能用 点击不能用
func main() {
driver, _ := gwda.NewUSBDriver(nil)

x, y := 50, 256

driver.Tap(x, y)

}

报错：
2024/03/10 20:35:58 unknown command: Unhandled endpoint: /session/320F2B62-A685-4848-B6CF-C2AFE4542E1E/wda/tap/0 -- http://00008101-0016191811C2001E/ with parameters {
wildcards = (
"session/320F2B62-A685-4848-B6CF-C2AFE4542E1E/wda/tap/0"
);
}