20131227_appium+rspec
- 2. 目的/目標 ● 目的 ○ 自プロジェクトのiOS/Androidアプリを実行し、Appiumを 使いテストすることができるようになることで、Appiumに 対するノウハウを蓄積する ■ その他、必要な知識（nvm/npm/rvm）も知る ○ Appiumでできることを知り、何ができそうか見立てをた てる ● 目標 ○ 何らかのシナリオに記述した操作を、アプリ起動後1回 でも行うことができるようにする ○ rvm/nvm/npmの存在を知る ● 言及しないこと ○ 自動化できる箇所/できない箇所/設計などには言及しま
- 3. about appium ● WebDriverをもとに、iOS/Android/FireFoxOS向けアプリを テストできるように開発されているOSS ○ イメージとしては、SeleniumのiOS/Android向け版 ○ Sauce Labs が開発の中心 ● WebDriverはW3Cとして仕様が固まってきている ○ FireFoxOSはWebDriver APIに対応している ■ https://dvcs.w3.org/hg/webdriver/rawfile/tip/webdriver-spec.html ● AppiumのWebページ ○ http://appium.io ● Github ○ https://github.com/appium/appium
- 9. デモ
- 10. ここからの流れ 1. nvm/npmを使いAppiumをインストール 2. rvmを使い、シナリオに使うRSpecの実行環境 を整える 3. 試しにappiumを動かしてみる 4. サンプルプロジェクトを動かしてみる 5. デモで動かしたRSpecシナリオを読んで、どうい う操作ができるのか見てみる
- 11. install “nvm” to manage node $ git clone git://github.com/creationix/nvm.git ~/.nvm $ source ~/.nvm/nvm.sh $ nvm install v0.11.9 ※ $ nvm ls-remote にて、現在インストール可能なすべてのリ ストを取得可能
- 12. install “nvm” to manage node $ nvm alias default v0.11.9 次回以降、ターミナルを開くたびにnvm関連を有効にしたいの で、bash_profileに以下を入力しておきましょう。 $ vi ~/.bash_profile > source ~/.nvm/nvm.sh > npm_dir=${NVM_PATH}_modules > export NODE_PATH=$npm_dir
- 13. install appium インストール用ライブラリは NODE_PATH に保存 されます。 $ sudo npm install -g appium@0.12.3 ※20131227現在、0.13.0がインストールできるの ですが、動作確認している0.12.3を使います
- 15. appiumの実行環境のチェック（標準出力） > Running iOS Checks > ✔ Xcode is installed at /Applications/Xcode.app/Contents/Developer > ✔ Xcode Command Line Tools are installed. > ✔ DevToolsSecurity is enabled. > ✔ The Authorization DB is set up properly. > ✔ Node binary found using which command at /Users/username/.nvm/v0.11.9/bin/node > ✔ iOS Checks were successful. > Running Android Checks > ✔ ANDROID_HOME is set to "/Applications/android-sdk-macosx" > ✔ JAVA_HOME is set to "/System/Library/Frameworks/JavaVM.framework/Home." > ✔ ADB exists at /Applications/android-sdk-macosx/platform-tools/adb > ✔ Android exists at /Applications/android-sdk-macosx/tools/android > ✔ Emulator exists at /Applications/android-sdk-macosx/tools/emulator > ✔ Android Checks were successful. > ✔ All Checks were successful
- 16. rvmのインストール rvmによるrubyのインストール $ bash -s stable < <(curl -s https://raw.github.com/wayneeseguin/rvm/master/binscripts/rvm-installer) $ rvm install 1.9.3 $ rvm use 1.9.3 $ ruby -v
- 17. Appium向けサンプルシナリオの取得 RSpecのサンプルダウンロード $ git clone https://github.com/KazuCocoa/sampleSenarioForAppium.git Git clone後、カレントディレクトリを移動 $ cd sampleSenarioForAppium $ bundle install
- 18. Appium向けサンプルシナリオの実行 appiumの起動 $ appium -a localhost エラー？ ※直ぐにわからないエラーの場合、別案でappiumを起動します。 シナリオ実行 bundle installしたディレクトリ配下で・・・ $ rspec sample_ios.rb エラー？ xcodeのバージョン？ xcodeに所定のシミュレータが入っていない？ ※サンプルでは、ios7向けシミュレータがあれば動作はします
- 19. サンプルシナリオの中身:Gemfile ● Gemfile source "https://www.rubygems.org" gem "rest-client" gem "rspec" gem "selenium-webdriver" gem "cucumber" gem "rspec-expectations"
- 20. サンプルシナリオの中身: sample-ios.rb - 1 require 'rubygems' require 'selenium-webdriver' require 'date' require 'rspec' require '../parameters' # obtain each parameters describe 'sample senario' do
- 21. サンプルシナリオの中身: sample-ios.rb - 2 (RSpecの基本構成) describe 'sample senario' do before :all do end after :all do end before :each do end after :each do end # sinario
- 22. サンプルシナリオの中身: sample-ios.rb - 3 describe 'sample senario' do before :all do @client = Selenium::WebDriver::Remote::Http::Default.new @client.timeout = 120 # secound @driver = Selenium::WebDriver.for(:remote, :http_client => @client, :desired_capabilities => IOS_CAPABILITIES, :url => SERVER_RUL) @driver.manage.timeouts.implicit_wait = 10 # seconds @driver_wait = Selenium::WebDriver::Wait.new :timeout => 30 end after :all do @driver.quit if @driver end
- 23. サンプルシナリオの中身: sample-ios.rb - 4 before :each do end after :each do end # sinario # 初期化 describe '' do context '' do it '' do 実際は、ここにシナリオを記述する end end end end
- 24. サンプルシナリオの中身: ../parameters.rb - 1 APP_PATH_IOS = 'https://dl.dropboxusercontent.com/u/1265532/SampleForAppium.app.zip'.freeze APP_PATH_ANDROID = '/Users/username/Documents/test.apk'.freeze TARGET_SERVER = 'http://localhost:4723'.freeze SCREENSHOT_SAVE_PATH = "#{Date::today.to_s}/".freeze FileUtils.mkdir_p(SCREENSHOT_SAVE_PATH) unless FileTest.exist? (SCREENSHOT_SAVE_PATH) # capabilities for Appium IOS_CAPABILITIES = { 'browserName' => '', 'device' => 'iPhone', 'deviceName' => 'iPhone Retina (4-inch)', #only for ios simulator: 'iPhone Retina (3.5-inch)' 'version' => '7.0', 'app' => APP_PATH_IOS }.freeze SERVER_RUL = "#{TARGET_SERVER}/wd/hub".freeze
- 29. Tips
- 30. こんなことできる