https://github.com/shamanec/gads-devices-provider
Set up iOS/Android devices for remote control with GADS UI and Appium test execution
https://github.com/shamanec/gads-devices-provider
android appium appium-android appium-ios device-farm ios linux macos remote-control windows
Last synced: 5 months ago
JSON representation
Set up iOS/Android devices for remote control with GADS UI and Appium test execution
- Host: GitHub
- URL: https://github.com/shamanec/gads-devices-provider
- Owner: shamanec
- License: mit
- Archived: true
- Created: 2022-07-23T08:32:46.000Z (almost 4 years ago)
- Default Branch: main
- Last Pushed: 2024-05-31T17:02:38.000Z (about 2 years ago)
- Last Synced: 2024-09-25T09:34:42.771Z (over 1 year ago)
- Topics: android, appium, appium-android, appium-ios, device-farm, ios, linux, macos, remote-control, windows
- Language: Go
- Homepage:
- Size: 80.4 MB
- Stars: 32
- Watchers: 5
- Forks: 4
- Open Issues: 5
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
## NOTE
The project is no longer maintained - the provider is now part of the mainstream [GADS](https://github.com/shamanec/GADS) project
## Introduction
[](https://discord.gg/5amWvknKQd)
* GADS-device-provider is a server that sets up devices for [Appium](https://github.com/appium/appium) tests execution and remote control with [GADS](https://github.com/shamanec/GADS).
* Supports both Android and iOS devices
* Supports Linux, macOS and Windows - notes below
**NB** I've been doing this having only small number of devices available. It looks like everything is pretty much working but I do not know how it would behave on a bigger scale.
## Features
* Straighforward setup
* Automatic provisioning when devices are connected
* Dependencies automatically installed on devices
* Appium server set up and started for each device
* Optionally Selenium Grid 4 node can be registered for each device Appium server
* [GADS-UI](https://github.com/shamanec/GADS) remote control support
* iOS video stream using [WebDriverAgent](https://github.com/appium/WebDriverAgent)
* Android video stream using [GADS-Android-stream](https://github.com/shamanec/GADS-Android-stream)
* Limited interaction wrapped around Appium - tap, swipe, touch&hold, type text, lock and unlock device
* Appium test execution - each device has its Appium server proxied on a provider endpoint for easier access
* Linux
* Supports both Android and iOS < 17
* Has some limitations to Appium execution with iOS devices due to actual Xcode tools being unavailable on Linux
* macOS
* Supports both Android and iOS
* Windows 10
* Supports Android and iOS < 17
Developed and tested on `Ubuntu 18.04 LTS`, `macOS Ventura 13.5.1`, `Windows 10`
## Setup
Read the setup very carefully before starting, I've tried to give as much information as I can - in case something is wrong or missed raise an issue, contact me or contribute :P
[Provider setup](./docs/setup.md)
## Thanks
| |About|
|---|---|
|[go-ios](https://github.com/danielpaulus/go-ios)|Many thanks for creating this tool to communicate with iOS devices on Linux, perfect for installing/reinstalling and running WebDriverAgentRunner without Xcode|
|[Appium](https://github.com/appium/appium)|Since the project revolves around Appium test execution and it is also used for the remote control with GADS, none of this would be actually possible without it, kudos!|
|[iOS App Signer](https://github.com/DanTheMan827/ios-app-signer)|This is an app for OS X that can (re)sign apps and bundle them into ipa files that are ready to be installed on an iOS device.|