faq.html.haml

---
layout: base
title: Frequently Asked Questions (faq)
author: Dominik Dary
---
.container-fluid
  .row-fluid
    .span3
      #sidebar
        %ul.nav.nav-tabs.nav-stacked
          %li
            %a{:href=>"#q-does-selendroid-require-to-modify-your-app"} Does selendroid require to modify your app?
          %li
            %a{:href=>'#q-can-only-the-app-itself-be-automated'} Can only the app itself be automated?
          %li
            %a{:href=>'#q-can-selendroid-automate-hybrid-apps-web-views'} Can selendroid automate hybrid apps (web views)?
          %li
            %a{:href=>'#q-does-selendroid-creates-and-starts-automatically-emulators-for-you'} Does selendroid creates and starts automatically emulators for you?
          %li
            %a{:href=>'#q-how-can-i-solve-resigning-issues'} How can I solve resigning issues?
          %li
            %a{:href=>'#q-what-are-the-drawbacks-of-using-the-locale-property-in-the-capabilities'} What are the drawbacks of using the locale property in the capabilities?
          %li
            %a{:href=>'#q-how-do-you-test-that-actually-selendroid-works-fine'} How do you test that actually selendroid works fine?
          %li
            %a{:href=>'#q-how-can-i-chat-with-the-developers'} How can I chat with the developers?
          %li
            %a{:href=>'#q-are-there-talks-about-selendroid'} Are there articles/talks about selendroid?
          %li
            %a{:href=>'#q-how-can-i-get-the-html-source-of-the-webview'} How can I get the HTML source of the webview?
          %li
            %a{:href=>'#q-what-is-the-architecture-of-selenium'} What is the architecture of Selenium
    .span9
      %h1 Frequently Asked Questions
      %h3#q-does-selendroid-require-to-modify-your-app Q: Does selendroid require to modify your app?
      %p A: No, the app that you would like to automate must not be modified.
      %h3#q-can-only-the-app-itself-be-automated Q: Can only the app itself be automated?
      %p A: Yes, only the app itself can be automated becasue selendroid depends on the Android instrumentation framework.
      %h3#q-can-selendroid-automate-hybrid-apps-web-views Q: Can selendroid automate hybrid apps (web views)?
      %p A: Yes, selendroid can automate native and hybrid apps.
      %h3#q-does-selendroid-creates-and-starts-automatically-emulators-for-you Q: Does selendroid creates and starts automatically emulators for you?
      %p A: Yes, when using you use selendroid-standalone then existing emulators are started automatically if the desired capabilities are matching to one of the existing Emulators. Since version 0.9.0 selendroid can also interact with already started emulators.
      %h3#q-how-can-i-solve-resigning-issues Q: How can I solve resigning issues?
      %p A: Usually resigning issues are caused when the <em>JAVA_HOME</em> is pointing to an Java Runtime Environment (JRE) instead of a Java Software Development Kit (SDK). When a IDE is used to start <em>selendroid-standalone</em>, please have a look at your test runner. In some cases the IDE pointed to a JRE and which caused the failure.  
      %h3#q-what-are-the-drawbacks-of-using-the-locale-property-in-the-capabilities Q: What are the drawbacks of using the locale property in the capabilities?
      %p A: When selendroid is starting emulators, for that test session the locale can be changed. If already started emulators are used, the locale cannot be changed, because that would cause an emulator restart, which wouldn't make sense to use already started emulators in the first place. On hardware devices the locale cannot be changed programmatically. 
      %p When you have multiple devices connected to a node with multiple locales and you are using the selenium grid, then you can add the locale property to the registration request that the <em>grid-node</em> is sending to the <em>grid-hub</em> and write your own <a target="_blank", href="https://github.com/selendroid/selendroid/blob/master/selendroid-grid-plugin/src/main/java/io/selendroid/grid/SelendroidCapabilityMatcher.java#L30">CapabilityMatcher</a> that considers the locale property. More details about how to used the Grid you find <a href="https://code.google.com/p/selenium/wiki/Grid2" target="_blank">here</a>.
      %h3#q-how-do-you-test-that-actually-selendroid-works-fine Q: How do you test that actually selendroid works fine?
      %p >A: We are maintaining a special test app with a bunch of automated tests. Those tests are executed before we release and also every time a commit is done. We use Travis CI: <a href="https://travis-ci.org/selendroid/selendroid">https://travis-ci.org/selendroid/selendroid</a>.
      %h3#q-how-can-i-chat-with-the-developers Q: How can I chat with the developers?
      %p A: Come and join us on IRC: #selendroid on freenode.net
      %h3#q-are-there-talks-about-selendroid Q: Are there articles/talks about selendroid?
      %p A: Yes: There is an article on <a href="http://www.methodsandtools.com/tools/selendroid.php">Methods and Tools Magazine</a>. 
      %p Currently there are three talks available:
      %ul
        %li Luke Semerau: <a href="http://www.youtube.com/watch?v=RE2OKy2fY_s">Driving iOS MobileSafari app and cross platform testing</a>
        %li Martin Konicek: <a href="https://skillsmatter.com/skillscasts/5630-testing-applications-at-facebook">Testing apps at Facebook</a> & <a href="https://speakerdeck.com/mkonicek/testing-apps-at-facebook">Slides</a>
        %li Simon Stewart: <a href="http://www.youtube.com/watch?v=EpnlAtAkPJ8">How Open Source Powers Facebook on Android</a>
        %li Dominik Dary: <a href="http://www.youtube.com/watch?v=gIPxxF4lhGo">GTAC 2014: Selendroid - Selenium for Android</a> & <a href="http://www.slideshare.net/DominikDary/gtac2014selendroid-final">Slides</a>
        %li Dominik Dary: <a href="http://www.youtube.com/watch?v=oxhqOYWulfU">Android Test Automation - one year later</a>
      %h3#q-how-can-i-get-the-html-source-of-the-webview Q: How can I get the HTML source of the webview?
      %p Selendroid's inspector is able to display the HTML source of the web view. The other option is to use selendroid's build in mechanism to get the page source via <code>driver.getPageSource()</code>.
      %h3#q-what-is-the-architecture-of-selenium Q: What is the architecture of Selenium?
      %p A: A very good article about all the architecture details of the selenium project can be found <a href="http://www.aosabook.org/en/selenium.html">here</a>.