selendroid 0.1.0

data/.gitignore

@@ -0,0 +1,19 @@
+*.gem
+*.rbc
+.bundle
+.config
+.yardoc
+Gemfile.lock
+InstalledFiles
+_yardoc
+selendroid-test-app-0.1-SNAPSHOT.apk
+selendroid-server-0.0.1.apk
+coverage
+doc/
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp

data/Gemfile

@@ -0,0 +1,4 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in selendroid.gemspec
+gemspec

data/LICENSE.txt

@@ -0,0 +1,15 @@
+Copyright (c) 2013 Dary, Dominik
+
+Apache License 2.0
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+    http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.

data/README.md

@@ -0,0 +1,48 @@
+Selendroid
+==========
+
+Selendroid is an attempt to implement the Selenium JSON Wire Protocol for Android native and hybrid apps.
+
+Getting started
+---------------
+
+Selendroid is based on the Android instrumentation framework, so therefor only testing one specific app is supported.
+Selendroid-server in combination with the application under test (aut) must be installed on the device in order to be able to run automated end-to-end tests.
+
+To write and run tests with selendroid, first a customized selendroid-server for your aut must be created. To simplify this process I have created a Ruby gem:
+
+		sudo gem install selendroid
+		selendroid build pathToYour.apk
+		
+Now you will find your customized selendroid-server. To run the server:
+
+		# start the selendroid server: 
+		adb shell am instrument -e main_activity 'org.openqa.selendroid.testapp.HomeScreenActivity' org.openqa.selendroid.server/org.openqa.selendroid.server.ServerInstrumentation
+		# activate port forwarding.
+		adb forward tcp:8080 tcp:8080
+
+A sample test looks like:
+
+		driver = new AndroidDriver(new URL("http://localhost:8080/wd/hub"), getDefaultCapabilities());
+		driver.findElement(By.id("startUserRegistration")).click();
+		
+		WebDriverWait wait = new WebDriverWait(driver, 5);
+		WebElement inputUsername =
+    	wait.until(ExpectedConditions.presenceOfElementLocated(By.id("inputUsername")));
+		inputUsername.sendKeys(user.getUsername());
+		Assert.assertEquals(nameInput.getText(), "Mr. Burns");
+		nameInput.clear();
+		nameInput.sendKeys(user.getName());
+		takeScreenShot("User data entered.");
+		driver.findElement(By.id("btnRegisterUser")).click();
+
+More details about selendroid can be found in the [wiki](https://github.com/DominikDary/selendroid/wiki/).
+
+Current state
+-------------
+
+Please keep in mind that this project is in very early stages. Help is appreciated. Reach us out in the issues or via email.
+
+You can track the current progress on the following [link](https://github.com/DominikDary/selendroid/wiki/JSON-Wire-Protocol)
+
+

data/Rakefile

@@ -0,0 +1 @@
+require "bundler/gem_tasks"

data/bin/selendroid

@@ -0,0 +1,59 @@
+#!/usr/bin/env ruby
+
+require 'fileutils'
+require 'selendroid/selendroid_builder'
+require 'rbconfig'
+
+# for ruby 1.9.1 and earlier
+unless defined? RbConfig.ruby
+  def RbConfig.ruby
+    File.join(RbConfig::CONFIG["bindir"], RbConfig::CONFIG["ruby_install_name"] + RbConfig::CONFIG["EXEEXT"])
+  end
+end
+
+def print_comamndline_help
+  puts <<EOF
+  Usage: selendroid <command-name> [parameters]
+  <command-name> can be one of
+    help
+      Prints more detailed help information.
+    build <apk>
+      Builds the selendroid-server for the given apk.
+   To find help, please visit the official selendroid wiki: http://goo.gl/z30pj    
+EOF
+end
+
+
+def is_apk_file?(file_path)
+  file_path.end_with? ".apk" and File.exist? file_path
+end
+
+def relative_to_full_path(file_path)
+  File.expand_path(file_path)
+end
+
+def raise_if_android_home_not_set
+  raise "Please set the ANDROID_HOME environment variable" unless ENV["ANDROID_HOME"]
+end
+
+if (ARGV.length == 0)
+  print_comamndline_help
+  exit 0
+end
+cmd = ARGV.shift
+if cmd == 'help'
+  print_comamndline_help
+  exit 0
+elsif cmd == 'build'
+  raise_if_android_home_not_set
+  puts "Please specify the app you want to build a selendroid-server for" if (ARGV.empty? or not is_apk_file?(ARGV.first))
+  while not ARGV.empty? and is_apk_file?(ARGV.first)
+    rebuild_selendroid(relative_to_full_path(ARGV.shift))
+  end
+  exit 0
+else
+  print_comamndline_help
+  exit 0
+end
+
+

data/lib/selendroid.rb

@@ -0,0 +1,3 @@
+module Selendroid
+  # Your code goes here...
+end

data/lib/selendroid/selendroid_builder.rb

@@ -0,0 +1,64 @@
+require "selendroid/version"
+require 'zip/zip'
+require 'tempfile'
+
+def rebuild_selendroid(app)
+    aut_base_package = %x[ aapt dump badging '#{app}' | grep package  | cut -d '=' -f2-|awk '{ print $1}' | tr -d "'" ]
+    puts "Building selendroid-server for package #{aut_base_package}"
+    
+    test_server_file_name = selendroid_server_path(aut_base_package)
+    FileUtils.mkdir_p File.dirname(test_server_file_name) unless File.exist? File.dirname(test_server_file_name)
+
+    unsigned_test_apk = File.join(File.dirname(__FILE__), '..','..', 'selendroid-prebuild/selendroid-server.apk')
+    android_platform = Dir["#{ENV["ANDROID_HOME"].gsub("\\", "/")}/platforms/android-*"].last
+    raise "No Android SDK found in #{ENV["ANDROID_HOME"].gsub("\\", "/")}/platforms/" unless android_platform
+    Dir.mktmpdir do |workspace_dir|
+      Dir.chdir(workspace_dir) do
+        FileUtils.cp(unsigned_test_apk, "TestServer.apk")
+        FileUtils.cp(File.join(File.dirname(__FILE__), '..','..', 'selendroid-prebuild/AndroidManifest.xml'), "AndroidManifest.xml")
+
+        unless system %Q{"#{RbConfig.ruby}" -pi.bak -e "gsub(/#targetPackage#/, '#{aut_base_package}')" AndroidManifest.xml}
+          raise "Could not replace package name in manifest"
+        end
+
+        unless system %Q{"#{ENV["ANDROID_HOME"]}/platform-tools/aapt" package -M AndroidManifest.xml  -I "#{android_platform}/android.jar" -F dummy.apk}
+          raise "Could not create dummy.apk"
+        end
+
+        Zip::ZipFile.new("dummy.apk").extract("AndroidManifest.xml","customAndroidManifest.xml")
+        Zip::ZipFile.open("TestServer.apk") do |zip_file|
+          zip_file.add("AndroidManifest.xml", "customAndroidManifest.xml")
+        end
+      end
+      sign_apk("#{workspace_dir}/TestServer.apk", test_server_file_name)
+      begin
+
+      rescue Exception => e
+        puts e
+        raise "Could not sign test server"
+      end
+    end
+    puts "Done signing the test server. Moved it to #{test_server_file_name}"
+end
+
+def is_windows?
+  (RbConfig::CONFIG['host_os'] =~ /mswin|mingw|cygwin/)
+end
+
+def sign_apk(app_path, dest_path)
+  if is_windows?
+    jarsigner_path = "\"#{ENV["JAVA_HOME"]}/bin/jarsigner.exe\""
+  else
+    jarsigner_path = "jarsigner"
+  end
+
+  cmd = "#{jarsigner_path} -sigalg MD5withRSA -digestalg SHA1 -signedjar #{dest_path} -storepass android -keystore ~/.android/debug.keystore #{app_path} androiddebugkey"
+  unless system(cmd)
+    puts "jarsigner command: #{cmd}"
+    raise "Could not sign app (#{app_path}"
+  end
+end
+
+def selendroid_server_path(base_package)
+  "selendroid-server-#{Selendroid::VERSION}.apk"
+end

data/lib/selendroid/version.rb

@@ -0,0 +1,3 @@
+module Selendroid
+  VERSION = "0.1.0"
+end

data/selendroid-prebuild/AndroidManifest.xml

@@ -0,0 +1,22 @@
+<?xml version="1.0" encoding="utf-8"?>
+<manifest xmlns:android="http://schemas.android.com/apk/res/android"
+    package="org.openqa.selendroid"
+    android:versionCode="1"
+    android:versionName="0.1" >
+    <uses-sdk android:minSdkVersion="16" />
+
+    <instrumentation
+        android:name="org.openqa.selendroid.ServerInstrumentation"
+        android:targetPackage="org.openqa.selendroid.testapp" />
+
+    <uses-permission android:name="android.permission.INTERNET" />
+    <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
+    <uses-permission android:name="android.permission.ACCESS_MOCK_LOCATION" />
+    <uses-permission android:name="android.permission.INJECT_EVENTS" />
+
+    <application
+        android:label="Selendroid" >
+        <uses-library android:name="android.test.runner" />
+    </application>
+
+</manifest>

data/selendroid.gemspec

@@ -0,0 +1,19 @@
+# -*- encoding: utf-8 -*-
+$:.push File.expand_path("../lib", __FILE__)
+require 'selendroid/version'
+
+Gem::Specification.new do |gem|
+  gem.name          = "selendroid"
+  gem.platform      = Gem::Platform::RUBY
+  gem.version       = Selendroid::VERSION
+  gem.authors       = ["Dominik Dary"]
+  gem.email         = ["ddary@acm.org"]
+  gem.homepage      = "http://github.com/DominikDary/"
+  gem.description   = %q{Helper to create the selendroid-server}
+  gem.summary       = %q{Selendroid Project}
+
+  gem.files         = `git ls-files`.split("\n") + Dir["selendroid-prebuild"]
+  gem.executables   = "selendroid"
+  gem.require_paths = ["lib"]
+  gem.add_dependency( "rubyzip")
+end

metadata

@@ -0,0 +1,85 @@
+--- !ruby/object:Gem::Specification 
+name: selendroid
+version: !ruby/object:Gem::Version 
+  prerelease: false
+  segments: 
+  - 0
+  - 1
+  - 0
+  version: 0.1.0
+platform: ruby
+authors: 
+- Dominik Dary
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2013-02-20 00:00:00 +01:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: rubyzip
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 0
+        version: "0"
+  type: :runtime
+  version_requirements: *id001
+description: Helper to create the selendroid-server
+email: 
+- ddary@acm.org
+executables: 
+- selendroid
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- .gitignore
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- bin/selendroid
+- lib/selendroid.rb
+- lib/selendroid/selendroid_builder.rb
+- lib/selendroid/version.rb
+- selendroid-prebuild/AndroidManifest.xml
+- selendroid-prebuild/selendroid-server.apk
+- selendroid.gemspec
+has_rdoc: true
+homepage: http://github.com/DominikDary/
+licenses: []
+
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      segments: 
+      - 0
+      version: "0"
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.3.6
+signing_key: 
+specification_version: 3
+summary: Selendroid Project
+test_files: []
+