MANUAL DE INSTALACIÓN DE APPIUM
Herramientas e Implementación. Para efectos del Appium Test Framework se han elegido el siguiente conjunto de herramientas: LENGUAJE DE PROGRAMACIÓN:
Python Versión 3.6 IDE (INTEGRATED DEVELOPMENT ENVIRONMENT)
Eclipse IDE (Oxygen o superior) Pydev (plugin para eclipse) DEPENDENCIAS
Node Js. Js. LIBRERÍAS:
pip (9.0.1) Appium Python Client. Client . APPIUM:
Appium Desktop. Desktop. Appium Server (Requiere NPM).
ANDROID STUDIO Y SDK:
Android Studio. Studio. Java JDK. Android JDK. o Ui Automator Viewer
Instalación De Python Desde 0 IMPORTANTE: Si ya tienes instalado python, omite este paso. 1. Desde la web de Python ubicada en este enlace descargue la Versión 3.6. 3.6. 2. Una vez que haya descargado el archivo .exe de instalación ejecútelo. En el siguiente paso se describe que debe tomar en cuenta durante la instalación. 3. La ruta de instalación por defecto de Python 3.6 corresponde a la carpeta de usuario, pero para efectos del Framework que vamos a crear, es importante mantener el conjunto de herramientas dentro de una misma ubicación. Para ello debemos crear un directorio en la raíz de nuestro disco local al cual llamaremos C:\AppiumFramework, dentro de esta ubicación crearemos otra carpeta a la cual le colocaremos el nombre de nuestra versión de Python quedando de la siguiente manera: C:\AppiumFramework\Python36. Ver la imagen a continuación:
4. Una vez elegido el directorio de la instalación hacer clic en “Install”, esto iniciara la instalación de todas las librerías y archivos a rchivos necesarios para correr Python en nuestro ordenador. 5. Una vez finalizada la instalación de Python, debemos corroborar que los archivos estén en la ruta dispuesta para la instalación. C:\AppiumFramework\Python36 En el directorio debe apreciarse la siguiente estructura de directorios: C:\AppiumFramework\Python36:
DLLs Doc Include Lib Libs python.exe python3.dll
python36.dll pythonw.exe Scripts Selenium Tcl Tools
6. También se debe corroborar la consola de comandos o el powershell de Windows puedan ejecutar Python ejecutando el siguiente comando:
Python --version
La consola debe devolver la versión actual de la instalación de python, en este caso: Python 3.6.3
Instalación De La Librería pip desde 0 IMPORTANTE: Si ya tienes instalado python, omite este paso. pip es una herramienta que permite instalar otras librerías o paquetes de Python, viene por defecto con Python desde la versión 2.7.9, podemos corroborar si quedo instalada a partir de la instalación de Python ya descrita en esta guía, ejecutando el siguiente comando desde el CMD de Windows o Powershell.
pip --version
La consola debe devolver la versión actual de la instalación de python, en este caso: pip 9.0.1 from C:\AppiumFramework\Python36\Lib\site-packages (python 3.6) La consola devuelve, en este caso, pip 9.0.1 y la ruta en la cual se encuentra alojada y debe coincidir con nuestra instalación de python, C:\AppiumFramework\Python36\Lib\site-packages C:\AppiumFramework\Python36\ Lib\site-packages (python 3.6). Si al ejecutar el comando pip – version, version, no se obtiene ningún resultado es probable que se deba hacer la instalación manual de pip sobre phyton. Para ello deberán ejecutarse los siguientes pasos:
Ingresar a https://bootstrap.pypa.io/get-pip.py https://bootstrap.pypa.io/get-pip.py.. Descargar el archivo get-pip.py en la ruta C:\AppiumFramework\Python36 Abrir la ventana de comandos (CMD) o el powershell. Ejecutar los comandos: o cd C:\AppiumFramework\Python36 (o ubicarse en la ruta donde se descargó el get-pip.py) g et-pip.py) o python – m get-pip.py (para ejecutar la instalación de pip utilizando python) Una vez que se haya ejecutado la instalación de pip, se debe corroborar nuevamente que esta se pueda ejecutar desde la ventana de comandos. Escribir en el powershell o en la ventana de comandos:
o
pip
–version
Añadiendo Las Variables De Entorno A Windows Según Wikipedia, las variables de entorno forman un conjunto de valores dinámicos que normalmente afectan al comportamiento de los procesos en una computadora. Necesitaremos añadir a las variables de entorno Windows los directorios de instalación de Python, así como a futuro el directorio de los proyectos que vayamos incorporando, esto para minimizar los fallos en la ejecución las pruebas y modulos .py presentes en cualquier proyecto. A continuación, se describen el conjunto de variables de entorno que deben ser incluidas hasta este punto del tutorial, ya que más adelante se deben agregar otro conjunto. C:\AppiumFramework\Python36\; C:\AppiumFramework\Python36\python.exe; C:\AppiumFramework\Python36\Lib; C:\AppiumFramework\Python36\libs; C:\AppiumFramework\Python36\Lib\site-packages; C:\AppiumFramework\Python36\Scripts\;
Para añadirlas siga los siguientes pasos: a. b. c. d. e. f.
Presione la tecla Windows + Inter-Pausa Se abrirá la ventana de propiedades del sistema. Haga clic en el enlace Configuración avanzada del sistema. Haga clic en Variables de entorno. Seleccione dentro de VARIABLES DEL SISTEMA la variable Path. Haga clic en editar, se deben visualizar las ventanas de la siguiente manera:
Una vez aquí puede Añadir Nuevas Variables de Entorno y agregarlas una por una, o si lo prefiere puede pulsar el botón editar texto e incluirlas todas bajo el siguiente formato:
C:\AppiumFramework\Python36\;C:\AppiumFramework\Python36\python.exe;C:\Appi C:\AppiumFramework\Python36\;C:\AppiumFramework\Python36\pyt hon.exe;C:\Appi umFramework\Python36\Lib;C:\AppiumFramework\Python36\libs;C:\AppiumFramewor k\Python36\Lib\site-packages;C:\AppiumFramework\Python36\Scripts\; Péguelas en la ventana:
Cada variable debe estar separada por punto y coma (;) por favor sea cuidadoso con esto, no dañara el sistema, pero si obstaculizara el objetivo si no se hace correctamente. La variable Path es leída por Windows y con ella podrá ejecutar los comandos relacionados a python desde la consola o el PowerShell.
Pero para efectos del Pydev, un plugin con el cual utilizaremos python a través de Eclipse IDE debemos añadir otra variable llamada PYTHONPATH. Para crear una nueva variable de entorno haga los siguiente: s iguiente: a. b. c. d. e. f.
Presione la tecla Windows + Inter-Pausa Se abrirá la ventana de propiedades del sistema. Haga clic en el enlace Configuración avanzada del sistema. Haga clic en Variables de entorno. Seleccione dentro de VARIABLES DEL SISTEMA el botón NUEVA. En la ventana Nueva variable del sistema añada:
Nombre de la Variable: PYTHONPATH Valor de la Variable: C:\AppiumFramework\Python36\;C:\AppiumFramework\Python36\python.e xe;C:\AppiumFramework\Python36\Lib;C:\AppiumFramework\Python36\lib s;C:\AppiumFramework\Python36\Lib\sitepackages;C:\AppiumFramework\Python36\Scripts\;
COMPROBACIÓN :
Una vez asignadas las variables de entorno se deben ejecutar las siguientes instrucciones en el PowerShell o en la consola de Windows: python --versión Devuelve: Python 3.6.3 pip --versión Devuelve: pip 9.0.1 from C:\AppiumFramework\Python36\Lib\site-packages (python 3.6)
Instalando Librerías en Python Una vez que hayamos configurado python en nuestro computador es importante instalar vía consola (CMD) o PowerShell algunas librerías necesarias para ejecutar los scripts. Estas librerías una vez descargadas desde su respectivo repositorio e instalada, se almacenará en el directorio: C:\AppiumFramework\Python36\Lib\site-packages C:\AppiumFramework\Python36\Lib\site-packages o en [Ruta_Instalacion_Python]\Lib\ site-packages Las librerías son las siguientes:
Selenium Webdriver para Python. Python. Utilizada para automatizar la interacción con el WebBrowser desde pyhton. Para instalarlo, abre la consola y ejecuta el siguiente comando: python -m pip install Appium-Python-Client
COMPROBACIÓN :
Para corroborar la instalación o la existencia de las librerías en python se deben ejecutar las siguientes instrucciones en el PowerShell o en la consola de Windows: pip list Devuelve: La lista de librerías instaladas en Pyhton 3.6
Configuración de Eclipse IDE con Pydev Eclipse es una plataforma de desarrollo, diseñada para ser extendida de forma indefinida a través de plug-ins. Fue concebida desde sus orígenes para convertirse en una plataforma de integración de herramientas de desarrollo. No tiene en mente un lenguaje específico, sino que es un IDE genérico, aunque goza de mucha popularidad entre la comunidad de desarrolladores del lenguaje Java usando el plug-in JDT que viene incluido en la distribución estándar del IDE. Pydev es el plugin que convierte a eclipse en un Python IDE. Pasos para configurar Eclipse con Pydev: 1. Descargue el Elipse IDE (Oxygen o superior). Es recomendable que descargue el paquete .zip y no el installer ya que será más fácil transportar la instalación hacia otros directorios dir ectorios y/o PC´s. 2. Descomprima el paquete dentro del directorio previamente establecido para la instalación de python y otros componentes. En este caso C:\AppiumFramework\, una vez descomprimido el paquete debe quedar de la siguiente manera: ma nera: C:\AppiumFramework\eclipse La instalación debe figurar dentro del directorio de la siguiente manera:
Ejecuté eclipse.exe, es recomendable que envié un acceso directo al escritorio o alguna otra ruta ya que se utilizara de d e manera frecuente.
3. Antes de iniciar eclipse te solicitara una ruta donde se almacenaran los nuevos proyectos, puede ser cualquier ruta, aunque para efectos del Framework que estamos creando hemos definido la ruta como: C:\TestTinyAutomationFramework y pulsamos Launch
Es importante resaltar que es necesario que sea la misma ruta, pero que si debe ser una ruta relativamente sencilla de ubicar dado a que esta se agregara posteriormente a las variables de entorno de Windows (path) y la variable de entorno de Python (PYTHONPATH). 4. Una vez iniciado el eclipse debemos ir al Marketplace para descargar Pydev (plugin para eclipse). Esto puede hacerse de la siguiente manera: 1. Menu Help Eclipse Marketplace
2. Buscar Pydev en la tiende de eclipse y presionar Install.
3. Confirmar la instalación de los componentes de Pydev.
5. Una vez realizada la instalación de Pydev en eclipse seguramente te solicitara reiniciar el eclipse para completar la instalación, seguidamente debemos configurar el intérprete de python, así como las librerías ya descargadas y las variables de entorno. Vamos a Menu Windows Preferencias Una vez abierta la ventana de preferencias, nos ubicamos en el apartado Pydev en la columna Izquierda y lo desplegamos. Navegamos hasta la siguiente sección del menú: Pydev Interpreters Python Interpreter.
6. Como se muestra en la imagen superior no existe ningún interprete agregado para Python, con lo cual tenemos que seleccionar la instalación de Python previamente realizada y seleccionarla s eleccionarla como nuestro interprete: Hacemos clic en New (esquina superior derecha) Browse y navegamos hasta el directorio de instalación de python 3.6 el cual debe ser C:\AppiumFramework\Python36 y seleccionamos el binario: python.exe. Se debe mostrar de la siguiente manera: o o o
Interpreter Name: C:\AppiumFramework\Python3 C:\AppiumFramework\Python36 6 Interpreter Executable: C:\AppiumFramework\Python36\python.exe
Como se muestra en la siguiente imagen:
7. Pydev se encargara de leer el PYTHONPATH agregado con anterioridad a las variables de entorno, durante la instalacion de phyton, debemos pulsar ok.
8. Pydev también leerá las librerías instaladas a través de pip en nuestra instalación de python. La configuración debe quedar de la siguiente manera:
9. ¡FELICIDADES! Hasta aquí haz logrado la configuración de python, Pydev y las librerías necesarias para empezar a automatizar.
Instalando Node JS Node.js® es un entorno de ejecución para JavaScript construido con el motor de JavaScript V8 de Chrome. Node.js usa un modelo de operaciones E/S sin bloqueo y orientado a eventos, que lo hace liviano y eficiente. El ecosistema de paquetes de Node.js, npm, es el ecosistema más grande de librerías de código abierto en el mundo. Ve al sitio: https://nodejs.org/es/ y descarga la última versión de Node.js
La instalación es relativamente sencilla, asegúrate que el directorio de instalación sea dentro de C:\AppiumFramework\nosejs aunque esto no es estrictamente necesario. Una vez que hayas instalado Node, ve a la consola de comandos o el powershell y verifica que la instalación se haya realizado correctamente:
Inicio CMD Enter Luego escribe en la consola de comandos: npm Esto debe mostrar la versión y la ruta de la instalación de Node
[email protected] C:\AppiumFramework\nodejs\node_ C:\AppiumFramework\nodejs\node_modules\npm modules\npm
Instalando Appium Server Appium server requiere de node.js por lo que es importante haber realizado correctamente el paso anterior. En la carpeta C:\AppiumFramework crea la carpeta:
C:\AppiumFramework\Appium_Server Vamos a la consola de comandos y escribimos: npm install appium -g --prefix C:\AppiumFramework\Appium_Se C:\AppiumFramework\Appium_Server rver g: instalara Appium de manera global para o npm install appium – g: todos los usuarios. o --prefix C:\AppiumFramework\Appium_Serv C:\AppiumFramework\Appium_Server: er: Le indica a npm la ruta personalizada para la instalación de Appium.
Una vez que se haya descargado los archivos de la instalación de Appium server, podrás verlo de esta manera en el directorio que indicaste:
Solo queda agregar Appium a las variables de entorno del sistema. Vamos a variables de entorno, hacemos clic en NUEVA y escribimos: o Nombre de La Variable: APPIUM o Valor De La Variable: C:\AppiumFramework\Appium_Server\node_modules\appium\node_mo dules\.bin o Aceptar.
Abrimos de nuevo la consola de comandos. Escribimos: o Appium – a 127.0.0.1 – p 4723 o – a 127.0.0.1 es la dirección local en el que se iniciara Appium o – p 4723 corresponde al puerto. Si inicia correctamente se vera de la siguiente manera:
Instalación de Java JDK (Java Developers Kit) Para que Appium pueda interactuar con las aplicaciones aplica ciones que serán sometidas a prueba, vamos a necesitar que se complete la instalación del SDK de android y setear ANDROID_HOME como variable de entorno, asi como instalar Java y setear su variable de entorno JAVA_HOME. Omitir este paso si ya tienes instalado el Java JDK
Ingresamos a la página oficial de java: http://www.oracle.com/technetwork/es/java/javase/downloads/index.html
y hacemos clic sobre el icono: Java Download.
Aceptamos las condiciones y descargamos la versión de java jdk.
Ejecuta el instalador de Java JDK y recuerda apuntar la ruta hacia el framework C:\AppiumFramework\java_jdk (tambien puede dejar la ruta por defecto C:\Program Files\Java\jdk1.8.0_VERSION\)
Una vez que se haya instalado el esquema de archivos de d e Java JDK se debe ver asi:
Ahora solo nos queda añadir la ruta C:\Program Files\Java\jdk1.8.0_VERSION a las variables de entorno como JAVA_HOME, tambien podemos añadirla como JDK_HOME, se podrian añadir ambas inclusive. Vamos a Variables de entorno del Sistema:
Nombre de la variable: JAVA_HOME Valor de la Variable: C:\Program Files\Java\jdk1.8.0_VERSION IMPORTANTE: Procura que el carácter punto y coma (;) no se agregue al final de la ruta Valor de la variable, si se agrega automaticamente asegurate de borrarlo, ya que se ha observado que este carácter ; modifica la ruta del archivo javac.exe en C:\Program Files\Java\jdk1.8.0_VERSION\bin
Para verificar la instalacion de Java, vaya a la consola y escriba: Java – version version Debe devolver lo siguiente:
Éxito! queda configurar el Android SDK de manera similar
Instalación de Android Studio y Android SDK Una vez configurado Java JDK, procedemos a la instalación del Android SDK.
Descargamos Android Studio: https://developer.android.com/studio/index.html?hl=es-419 Creamos la carpeta: Android_Studio dentro de C:\AppiumFramework
Ejecutamos el instalador de Android Studio y apuntamos la ruta de la instalación a C:\AppiumFramework\Android_Studio
Una vez culminada la instalación, ir a la ruta y familiarizarnos con el esquema de archivos. Las carpetas que deben estar creadas son las siguientes:
En la ruta C:\AppiumFramework\Android_Studio\bin, se encuentra el archivo studio64.exe, hacemos doble clic para ejecutarlo.
INSTALACIÓN INSTALACIÓN DE ANDROID SDK
Es hora de descargar el SDK (Software Development Kit) de Android o Iniciamos Android Studio. o Hacemos clic en Configure y después en SDK manager.
Vamos a la ubicacion C:\AppiumFramework\ y creamos la carpeta carpeta android_sdk, es el directorio donde apuntaremos el SDK manager para que descargue todas las librerias de desarrollo de android y las librerias nativas de cada version. En el SDK manager, configuramos la ruta C:\AppiumFramework\android_sdk, como Android SDK Location.
Para apuntar la descarga del SDK al directorio mencionado, mencionado, hacemos clic en editar y en la ventana SDK component. o Alli veremos la ruta la cual debemos buscar manualmente con el menu contextual
Luego seleccionamos todas las versiones de android que queremos tener presente en nuestro SDK y pulsamos ok.
Esperamos que termine la descargas de las versiones de android al SDK.
La ruta donde se instalaran nuestros archivos SDK tendra la siguiente estructura:
Al finalizar, solo nos queda un paso mas para terminar de configurar el Android SDK.
VARIABLES DE ENTORNO DE ANDROID SDK
Finalmente tenemos que agregar la variable de entorno ANDROID_HOME la cual tendra como valor la ruta de instalacion ins talacion del Android SDK.
Nombre de la variable: ANDROID_HOME Valor de la Variable: C:\AppiumFramework\android_sdk
IMPORTANTE: Procura que el carácter punto y coma (;) no se agregue agr egue al final de la ruta Valor de la variable.
Luego tenemos que añadir otras variables a Path, la cual debe estar creada por defecto. Las variables son las siguientes: o o o o o
%ANDROID_HOME%; %ANDROID_HOME%\platform-tools; %ANDROID_HOME%\tools; %ANDROID_HOME%\build-tools; %ANDROID_HOME%\tools\bin;
Al estar definida la variable ANDROID_HOME, cuyo valor es C:\AppiumFramework\android_sdk entonces podemos invocarla como %ANDROID_HOME% y al definirlas en la variable de entorno como Path como por ejemplo: %ANDROID_HOME%\platform-tools Es igual a la ruta: C:\AppiumFramework\android_sdk\platform-tools
COMPROBACIÓN:
Para verificar que la instalacion de los componentes Android SDK, Java JD K se hayan instalado correctamente, la mejor manera es ejecutar el Ui Automator Viewer:
Vamos a la ruta C:\AppiumFramework\android_sdk\tools\bin Hacemos doble clic sobre el archivo uiautomatorviewer.bat Si inicia el UI Automation Viewer es porque hemos configurado todo correctamente.
UI AUTOMATOR VIEWER: UI automator viewer es una herramienta de GUI para escanear y analizar los componentes de la interfaz de usuario de una aplicación de Android. Con UI automator viewer, puede inspeccionar la interfaz de usuario de una aplicación de Android para averiguar la jerarquía y ver diferentes d iferentes propiedades (id, texto ...) del elemento.
Para inspeccionar los elementos de una aplicación android necesitaremos:
Un telefono android y su driver para conectarse a la PC mediante un cable USB. El cable USB del telefono android. Activar el modo de Depuracion USB en android, si no sabe como hacerlo, consulte el siguiente enlace: https://elandroidelibre.elespanol.com/2015/01/como-activar-el-mododepuracion-usb-en-android.html UI automator viewer requiere de ADB (Android Debug Bridge), el cual se instala mediante el Android SDK, su ubicación esta definida en C:\AppiumFramework\android_sdk\platform-tools
Para saber si lo hemos instalado correctamente podemos verificarlo de la siguiente manera:
Vaya a la consola del sistema CMD Luego escriba adb version. La consola devolvera:
CONECTANDO CELULARES ANDROID AL IU AUTOMATOR VIEWER
Conectamos el celular al computador. Iniciamos IU automator Viewer. o o
Vamos a la ruta C:\AppiumFramework\android_sdk\tools\bin Hacemos doble clic sobre el archivo uiautomatorviewer.bat
Luego uego hac hacemo emos cli clicc sob sobre re el seg segun undo do ico icono
Debe empezar a verse el contenido del celular dentro del area de trabajo del IU Automator Viewer en computador.
Se recomienda ver el siguiente tutorial:
https://www.youtube.com/watch?v=uA54T6R8nhs
Instalando Appium Desktop. Appium desktop permite iniciar una interfaz gráfica para tu servidor de Appium.
Para ello necesitamos descargar el instalador en el sitio web de Appium: https://github.com/appium/appium-desktop/releases/tag/v1.2.7 Solo necesita hacer doble click en el instalador para que se ejecute. Por defecto Appium desktop se instala en la ubicación: C:\Users\TU_USUARIO\AppData\Local\Programs\appium-desktop\
Con el fin de mantener la mayoria de las herramientas en una misma ubicación, lo recomendable es cortar esta carpeta y pegarla en C:\AppiumFramework\appiumdesktop.
Una vez que se hayan transferido los archivos a la l a ubicación podremos ejecutar el archivo Appium.exe en la ruta C:\AppiumFramework\appium-desktop y comprobar si funciona. Esperamos un momento.
Podríamos iniciar el servidor haciendo clic en Start server v1.7., debe iniciar el log de la misma manera que se mostró a través de la consola de Windows.
Finalmente, podemos hacer clic derecho sobre el ejecutable y crear un acceso directo.
INICIANDO UNA APLICACIÓN EN APPIUM SERVER
Vamos a iniciar el inspeccionador de aplicaciones de Appium server, esto se maneja a través de sesiones:
Conectamos un dispositivo Android al computador. Inicia el servidor de Appium, y luego vamos a File-> New Session Window
En la pestaña de Capabilities (Desired Capabilities), vamos a configurarle los siguiente:
"platformName": "android", "platformVersion": "5.0.1", "deviceName": "Android Emulator", "app": "C:\\AppiumFramework\\APK\\ar.com.s "C:\\AppiumFramework\\APK\\ar.com.santander.rio.mbanking.a antander.rio.mbanking.apk", pk", "NoReset": true
La documentación oficial esta disponible en el siguiente enlace: https://github.com/appium/appium/blob/master/docs/en/writing-runningappium/caps.md platformName; es la plataforma sobre la cual se iniciarán las pruebas. platformVersion; debe coincidir con la versión de Android del dispositivo que conectes. deviceName; puedes llamarlo como quieras, pero lo mejor es colocarle el nombre del dispositivo que aparecen en la consola adb. Inicia la v entana de comandos y escribe adb devices, coloca el nombre que adb haya leído en el dispositivo. App; es la aplicación .apk que vamos a testear. Debes definir la ruta en donde se encuentra guardada en este caso C:\\AppiumFramework\\APK\\ar.com.santander.rio.mbanking.apk NoReset; resetear (true o false) la app después de finalizar la sesión.
Hacemos clic en “Start Session” y el resultado debe ser el siguiente:
Si hacemos clic sobre cualquier elemento de la app, nos devolvera su ID y su xpath.
Si todo funciona correctamente es porque has configurado todo de acuerdo a los requerimientos, en especial las variables de entorno de windows ANDROID_PATH, PATH y JAVA_HOME
PROYECTOS DE AUTOMATIZACIÓN CON APPIUM
Inicialmente vamos a probar nuestra configuración con un script elaborado en python, para empezar, necesitaremos:
Haber configurado Eclipse IDE, con el Plugin de Pydev. La librería Appium Python Client previamente instalada. Un paquete .apk con la app que deseamos testear. Iniciar el servidor de Appium ya sea mediante Appium Desktop o Appium Server, previamente instalados. 1. Iniciamos eclipse y creamos un proyecto nuevo proyecto Pydev. 2. Definimos el nombre del proyecto. 3. Definimos el intérprete que debe ser python en su versión 3.6. 4. Le daremos la siguiente estructura al proyecto:
5. En la carpeta apk debemos incluir el archivo .apk de la app que vamos a testear. 6. Iniciamos el Servidor de Appium ya sea en su versión Dektop o via consola:
SI deseamos iniciar Appium server debemos iniciar la consola de Windows y escribir: appium -a 127.0.0.1 -p 4723
Lo importante es que se inicialice el servidor ya sea en consola o en desktop:
Consola:
Appium Desktop:
Scripting Nuestra primer Test en Appium
Debemos crear un nuevo módulo dentro del paquete Test, y definimos lo siguiente: import unittest import unittest from appium from appium import import webdriver webdriver class ContactAppTestAppium(unittest.TestCase): def setUp(self ): ): desired_caps = {} desired_caps['platformName'] = 'android' desired_caps['platformVersion'] = '5.0.1' desired_caps['deviceName'] = 'GT-I9500' desired_caps['app'] = 'C:\\AppiumFramework\APK\\ar.com.sa 'C:\\AppiumFramew ork\APK\\ar.com.santander.rio.mb ntander.rio.mbanking.apk' anking.apk' desired_caps['NoReset'] = True self .driver .driver = webdriver.Remote( webdriver.Remote( 'http://127.0.0.1:4723/wd/hub', desired_caps) def test_ClickRefreshLink(self ): ): refreshButton = .driver.find_element_by_id("ar.com.santa self .driver.find_element_by_id( "ar.com.santander.rio.mbanki nder.rio.mbanking:id/messageAl ng:id/messageAlert" ert") self .assertTrue(refreshButton.is_displayed()) .assertTrue(refreshButton.is_displayed()) refreshButton.click()
## Right now we are just verify the displayed message on the Phone ## You can right code to handle that toast message and Verify that message def tearDown(self ): ): self .driver.quit() .driver.quit() if __name__ if __name__ == '__main__': suite = unittest.TestLoader().loadTes unittest.TestLoader().loadTestsFromTestCas tsFromTestCase(ContactAppT e(ContactAppTestAppium) estAppium) unittest.TextTestRunner(verbosity=2 unittest.TextTestRunner(verbosity= 2).run(suite)
Vamos a diseccionar el código:
Importamos las librerías Unittest y appium correspondiente a Appium Python Client. Client.
import unittest import unittest from appium from appium import import webdriver webdriver
Definimos en el método SetUp las mismas capabilities descritas para Appium Server:
desired_caps = {} desired_caps['platformName'] = 'android' desired_caps['platformVersion'] = '5.0.1' desired_caps['deviceName'] = 'GT-I9500' desired_caps['app'] = 'C:\\AppiumFramework\APK\\ar.com.sa 'C:\\AppiumFramew ork\APK\\ar.com.santander.rio.mb ntander.rio.mbanking.apk' anking.apk' desired_caps['NoReset'] = True
Con la diferencia que debe añadirse el servidor y el puerto con el cual se inicializo appium, ya sea en su versión desktop o server. .driver = webdriver.Remote( webdriver.Remote( 'http://127.0.0.1:4723/wd/hub', desired_caps) self .driver
Esta prueba consiste en hacer clic sobre s obre un elemento, básicamente aquí solo existen Xpath y ID´s, el cual vamos a extraer desde Appium desktop los ids correspondientes a la app que vamos a testear: def test_ClickRefreshLink(self ): ): refreshButton = self .driver.find_element_by_id( "ar.com.santander.rio.mbanki nder.rio.mbanking:id/messageAl ng:id/messageAlert" ert") .driver.find_element_by_id("ar.com.santa self .assertTrue(refreshButton.is_displayed()) .assertTrue(refreshButton.is_displayed()) refreshButton.click()
El método tearDown cierra la sesión. def tearDown(self ): ): self .driver.quit() .driver.quit()
Al ejecutar el script se debe reflejar el log en la consola con los datos inherentes a la conexión con el servidor appium.
