appium/sample-code/examples/ruby/android_on_sauce.rb

# This example automates a test of the Android example notepad app.
#
# To run this example, make sure you've run:
#   $ bundle install
#
# And set the environment variables:
#   SAUCE_USERNAME = your-sauce-username
#   SAUCE_ACCESS_KEY = your-sauce-key
#
# Then just:
#   $ rspec android_on_sauce.rb 
#
# Of note compared to the iOS example, here we're giving the package and
# activity, no OS and an empty browserName
#
# Of note compared to the non-sauce examples, you need to host your app
# somewhere Sauce Labs' cloud can fetch it for your test.

require "selenium-webdriver"
require "rspec"

def capabilities
  {
    "device" => "Android",
    "browserName" => "",
    "version" => "4.2",
    "app" => "http://appium.s3.amazonaws.com/NotesList.apk",
    "app-package" => "com.example.android.notepad",
    "app-activity" => ".NotesList"
  }
end

def url_with_credentials
  un = ENV["SAUCE_USERNAME"]
  pw = ENV["SAUCE_ACCESS_KEY"]
  
  unless un && pw
    STDERR.puts <<-EOF
      Your SAUCE_USERNAME or SAUCE_ACCESS_KEY environment variables 
      are empty or missing.
      
      You need to set these values to your Sauce Labs username and access
      key, respectively.

      If you don't have a Sauce Labs account, you can get one for free at
      http://www.saucelabs.com/signup
    EOF

    exit
  end

  return "http://#{un}:#{pw}@ondemand.saucelabs.com:80/wd/hub"
end

describe "Notepad" do
  before :all do
    @driver ||= Selenium::WebDriver.for(
      :remote, 
      :desired_capabilities => capabilities,
      :url => url_with_credentials
    )
  end

  after :all do
    @driver.quit if @driver
  end

  it "can create and save new notes" do
    new_button = @driver.find_element(:name, "New note")
    new_button.click

    text_field = @driver.find_element(:tag_name, "textfield")
    text_field.send_keys "This is a new note, from Ruby"

    save_button = @driver.find_element(:name, "Save")
    save_button.click

    notes = @driver.find_elements(:tag_name, "text")
    puts "The number of notes is: #{notes.length}"
    notes[2].text.should eq "This is a new note, from Ruby"
  end
end