mirror of
https://github.com/appium/appium.git
synced 2026-10-23 17:19:04 +08:00
ed2002d90d
- appium@2.0.0-beta.38 - @appium/execute-driver-plugin@2.0.2 - @appium/fake-plugin@2.0.2 - @appium/images-plugin@1.3.2 - @appium/relaxed-caps-plugin@1.0.0-beta.9 - @appium/universal-xml-plugin@1.0.0-beta.11
Appium Images Plugin
This is an official Appium plugin designed to facilitate image comparison, visual testing, and image-based functional testing.
Features
- Image Comparison (docs) - A new Appium command and route that allows sending in two different images and comparing them in various ways.
- Finding Elements by Image (docs) - Using a template image, find a matching screen region of an app and interact with it via standard Appium element semantics.
Prerequisites
- OpenCV 3.x native libraries
- opencv4nodejs NPM module: install with
npm i -g opencv4nodejs. By default the preinstall script of this module also downloads and makes all the required OpenCV libs from source, but this requires developer tools to be available on the host system. - Appium Server 2.0+
Installation - Server
Install the plugin using Appium's plugin CLI:
appium plugin install images
Installation - Client
No special action is needed to make the features available in the various Appium clients, as this plugin used to be a core Appium feature and its commands are already supported in the official clients.
Activation
The plugin will not be active unless turned on when invoking the Appium server:
appium --use-plugins=images
Usage
Check the docs links above for usage for each of the features provided.