Documentation, tips, tricks for migrating from Selendroid to UIAutomator or UIAutomator2

[jarmy]

Hi,
I’m about to try to migrate a Appium 1.6.5 + Java-based codeline that has been running with Selendroid for many years. Are there any documents or guidelines that demonstrate best practices for changing locator strategies (what are the proper org.openqa.selenium.By strategies? I’m also looking for tips on inspecting elements to determine proper locators (what are the preferred tools).

Thanks in advance
-jason

[jarmy]

Our team completed the migration to UIAutomator2 and compiled these guidelines for converting our Java Element libraries:

You can use any of these locator strategies:

• MobileBy.id(“toolbar_title”) or By.id(“com.pandora.android:id/toolbar_title”)
• By.xpath("//android.widget.RelativeLayout[@content-desc=‘Now Playing’]")
• MobileBy.xpath("//android.widget.TextView[@resource-id=‘com.pandora.android:id/toolbar_title’]")
• MobileBy.AccessibilityId(“Play”) or By.id(“play”)

These locator strategies won’t work:

• By.name
• By.linkText, MobileBy.linkText or By.partialLinkText
• xpaths with @value or @id attributes

Replacement strategies:

• By.linkText(“I’m tired of this track”) --> By.xpath("//android.widget.TextView[@text=‘tired of this track’]")
• By.xpath("//AppCompatTextView[@text=‘foo’]") --> By.xpath("//android.widget.TextView[@text=‘foo’]")
• By.xpath("//AppCompatButton[@text=‘foo’]") --> By.xpath("//android.widget.Button[@text=‘foo’]")
• By.xpath("//AppCompatCheckedTextView[@text=‘foo’]") --> By.xpath("//android.widget.CheckedTextView[@text=‘foo’]")
• By.xpath("//MiniPlayerHandleView[@id=‘mini_player_handle’]") --> By.xpath("//android.widget.RelativeLayout[@resource-id=‘com.pandora.android:id/mini_player_handle’]")
  @name with @content-desc
• By.xpath("//PandoraImageButton[@name=‘Play’]") --> By.xpath("//android.widget.ImageButton[@content-desc=‘Play’]")