AppiumLibCore

Travis, Ubuntu	Azure, Windows

This library is a Ruby client for Appium. The gem is available via appium_lib_core.

This library wraps selenium-webdriver and adapts WebDriver APIs for Appium. ruby_lib calls all of Appium/Selenium related APIs via this core library. It works instance based driver.

Documentation

• http://www.rubydoc.info/github/appium/ruby_lib_core

Related library

• https://github.com/appium/ruby_lib

How to start

Run tests

Unit Tests

Run unit tests which check each method and commands, URL, using the webmock.

$ bundle install
$ bundle exec parallel_test test/unit/

Functional Tests

Run functional tests which require the Appium server and real device, Simulator/Emulator.

• Start Appium server

  $ npm install -g appium opencv4nodejs
  $ appium --relaxed-security # To run all tests in local
  

• Conduct tests

  $ bundle install
  $ rake test:func:android # Andorid, uiautomator2
  $ AUTOMATION_NAME=espresso rake test:func:android # Andorid, uiautomator2
  $ rake test:func:ios     # iOS
  

Run parallel tests with parallel_tests gem

Android

# Generate 3 emulators. Running 3 emulators require much machine power.
# It requires an image which is for Google Play and x86 CPU architecture's image.
$ bundle exec rake android:gen_device
$ PARALLEL=1 bundle exec parallel_test test/functional/android -n 3

iOS

• Create iPhone simulators named iPhone 8 - 8100 and iPhone 8 - 8101
• Run iOS functional tests with below command

$ PARALLEL=1 bundle exec parallel_test test/functional/ios -n 2

Run a test case

1. Launch the Appium server locally.
2. Run the following script.

• test.rb ```ruby require 'rubygems' require 'appium_lib_core'

opts = { desired_capabilities: { # or { caps: .... } platformName: :ios, platformVersion: '11.0', deviceName: 'iPhone Simulator', automationName: 'XCUITest', app: '/path/to/MyiOS.app' }, appium_lib: { wait: 30 } } @core = Appium::Core.for(opts) # create a core driver with opts @driver = @core.start_driver

Launch iPhone Simulator and MyiOS.app

@driver.find_element(:accessibility_id, 'some accessibility') # find an element

- Run the script
```bash
# shell 1
$ appium --log-level warn:error # show only warning and error logs

# shell 2
$ ruby test.rb

Development

• Demo app
  • https://android.googlesource.com/platform/development/+/master/samples/ApiDemos

Release

Use appium_thor to release this gem.

$ thor bump # bumpy,
$ thor release

Contribution

1. Fork it ( https://github.com/appium/ruby_lib_core/fork )
2. Create your feature branch (git checkout -b my-new-feature)
3. Commit your changes (git commit -am 'Add some feature')
4. Push to the branch (git push origin my-new-feature)
5. Create new Pull Request

License

Apache License v2