Skip to content

Latest commit

 

History

History
104 lines (64 loc) · 2.82 KB

README.md

File metadata and controls

104 lines (64 loc) · 2.82 KB

NAME

Appium - Perl bindings to the Appium mobile automation framework (WIP)

VERSION

version 0.02

SYNOPSIS

my $appium = Appium->new(caps => {
    app => '/url/or/path/to/mobile/app.zip'
});

$appium->hide_keyboard;
$appium->quit;

DESCRIPTION

Appium is an open source test automation framework for use with native and hybrid mobile apps. It drives iOS and Android apps using the WebDriver JSON wire protocol. This module is a thin extension of Selenium::Remote::Driver that adds Appium specific API endpoints and Appium-specific constructor defaults.

For details on how Appium extends the Webdriver spec, see the Selenium project's spec-draft document

This module is woefully incomplete at the moment. Feel free to pitch in!

NEW OR UPDATED FUNCTIONALITY

Contexts

Instead of using windows to manage switching between native applications and webviews, use the analogous context methods:

my $current = $appium->current_context;
my @contexts = $appium->contexts;

my $context = 'WEBVIEW_1'
$appium->switch_to->context( $context );

Note that this module uses the ->switch_to->context syntax, unlike its parent module.

METHODS

contexts ()

Returns the contexts within the current session

$appium->contexts;

current_context ()

Return the current active context for the current session

$appium->current_context;

switch_to->context ( $context_name )

Switch to the desired context for the current session

$appium->switch_to->context( 'WEBVIEW_1' );

hide_keyboard( key_name|key|strategy => $key_or_strategy )

Hides the software keyboard on the device. In iOS, you have the option of using key_name to close the keyboard by pressing a specific key. Or, you can specify a particular strategy; the default strategy is tapOutside. In Android, no parameters are used.

$appium->hide_keyboard;
$appium->hide_keyboard( key_name => 'Done');
$appium->hide_keyboard( strategy => 'tapOutside', key => 'Done');

SEE ALSO

Please see those modules/websites for more information related to this module.

BUGS

Please report any bugs or feature requests on the bugtracker website https://github.com/appium/perl-client/issues

When submitting a bug or request, please include a test-file or a patch to an existing test-file that illustrates the bug or desired feature.

AUTHOR

Daniel Gempesaw [email protected]

COPYRIGHT AND LICENSE

This software is copyright (c) 2014 by Daniel Gempesaw.

This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.