Aquesta és una revisió antiga del document

---

Tests funcionals amb Android

Emprarem la llibreria https://appium.io

Podrem fer tests funcionals de forma molt similar a com utilitzem Selenium per a web.

Instal·lació

Necessitarem NodeJS versió LTS.

Instal·lem la llibreria Appium i el Driver UIAutomator2

$ sudo npm i -g appium
$ appium driver install uiautomator2

Provem servidor en una shell a part (escoltarà al port 4723):

$ appium

El podem parar amb CTRL+C.

També hem d'instal·lar:

• Android Studio IDE
• Android SDK (podem emprar el SDK Manager de l'Android Studio).
• Java SDK >=11 per a Android SDK>=30
• Crear un emulador Android i engegar-lo (podem emprar AVD Manager).

Exemple Python

La documentació oficial de Appium ens ofereix un exemple en Python i altres llenguatges (Javascript, Java, Ruby).

Creem un virtualenv per no interferir la instal·lació del sistema operatiu:

$ python -m venv envtest
$ source envtest/bin/activate
(envtest) $ pip install Appium-Python-Client pytest

Prenem aquest codi d'exemple que obre l'aplicació com.android.settings i cerca la opció Battery amb Xpath:

test_example.py

import unittest
from appium import webdriver
from appium.webdriver.common.appiumby import AppiumBy
 
# Import Appium UiAutomator2 driver for Android platforms (AppiumOptions)
from appium.options.android import UiAutomator2Options
 
capabilities = dict(
    platformName='Android',
    automationName='uiautomator2',
    deviceName='Android',
    appPackage='com.android.settings',
    appActivity='.Settings',
    language='en',
    locale='US'
)
 
# Converts capabilities to AppiumOptions instance
capabilities_options = UiAutomator2Options().load_capabilities(capabilities)
 
appium_server_url = 'http://localhost:4723'
 
class TestAppium(unittest.TestCase):
    def setUp(self) -> None:
        self.driver = webdriver.Remote(command_executor=appium_server_url,options=capabilities_options)
 
    def tearDown(self) -> None:
        if self.driver:
            self.driver.quit()
 
    def test_find_battery(self) -> None:
        el = self.driver.find_element(by=AppiumBy.XPATH, value='//*[@text="Battery"]')
        el.click()
 
if __name__ == '__main__':
    unittest.main()

Engeguem el servidor Appium en una shell a part (escoltarà al port 4723):

$ appium

Engeguem els tests en una altra shell:

$ python3 test_example.py

…i podrem veure com entra als Settings de l'emulador i clica en la secció «Battery» (sempre i quan l'emulador estigui en anglès).