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

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.id1(“toolbar_title”) or By.id1(“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.id1(“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.CheckedTextView1[@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’]")