Skip to main content

Adaptador Móvil

English

Introducción

La funcionalidad del Adaptador Móvil es usar e interactuar con dispositivos Android, incluyendo ambos emuladores como dispositivos físicos. La configuración necesaria se encuentra en el apartado Guía para Adaptador Móvil de TAST

Parámetros de inicialización

Los parámetros que debemos completar son los que enumeramos a continuación: 

  • Device: Nexus7 o custom. Elige “custom” si no estas usando Nexus como emulador.
  • Device Json Capabilities: hay que poner las JSON capabilities de tu dispositivo. Son las mismas que las añadidas al configurar Appium.
  • URL HUB: esta es la URL por defecto para tu hub: http://localhost:4723/wd/hub 
  • URL Browser(Opt.): aquí es donde se indica la URL que quieres abrir si vas a usar un navegador.
  • Validate insert values: si se marca la casilla, valida los valores insertados. Comprueba que sean los que se han puesto.
  • Full Screenshot: si se marca la casilla, toma un pantallazo completo.
  • Incognito mode: al marcar esta casilla el navegador trabajará en modo incógnito.

Funciones Predefinidas (PF's)

  • activateApp(App package): esta función activa (trae al frente) la aplicación especificada y que no está actualmente activa, o está corriendo en segundo plano. Se especifica el paquete de app en el parámetro.

  • clear(Element): limpia el valor del elemento.

  • clearAndType(InputElement): limpia el valor del elemento, y escribe a continuación.

  • clearNotificationBar: limpia mensajes de la barra notificaciones. Parámetro de entrada opcional:  Id Clear Button (Botón de borrado de identificación).
  • click(Element): hace clic en un elemento específico.

  • clickLink(Element): hace clic en un elemento que sea un link.

  • closeAllWindows(): cierra todas las ventanas abiertas.

  • closeApp(): cierra la aplicación.

  • countElements(Element): cuenta los elementos encontrados en html y guarda el valor en una variable entera. Como parámetro de entrada tenemos Element, con el cual indicamos que parte de dicho html queremos que cuente, por ejemplo, si indicamos el body de la página contará todos los elementos de este.

  • executeBridgeMobileCommand(Command): ejecuta commandos shell ADB sobre Appium (por ej.: adb uninstall package). Link para comandos de ADB útiles: https://www.inviul.com/adb-commands/. Esta función se recomienda para usuarios avanzados.

  • executeMobileCommand(CommandName, JSONArguments): se usa para ejecutar comandos de móvil, como batteryInfo, swipe, drag, etc. Permite el uso de argumentos JSON.

  • getAttribute(Element, Attribute): recibe el texto, valor o atributo del element y lo guarda en una variable.

  • getNotificationText(): obtiene el texto de notificación del área de notificaciones. Opcionalmente, quita notificaciones de esta zona.

  • installApp(appPath): instala una aplicación. El archivo .apk especificado tiene que ser un path en tu PC.

  • isAppInstalled(appId): verifica si una aplicación está instalada.

  • isExist(Element): comprueba si el elemento existe e imprime el resultado en el archivo de registro del usuario.

  • javascriptExecuteWithParameters(code, argument): permite la ejecución de Código Javascript personalizado durante el test, con los valores como parámetros.

  • networkSettings(wifi, data, airplanemode): establece la configuración de red del dispositivo. Los parámetros permiten activar o desactivar el Wifi, los datos y el modo avión. Los datos solo se pueden activar y desactivar en dispositivos rooteados o emuladores. El modo avión solo funciona en OS 6.0 y menor.

  • openUrl(String URL): abre la URL especificada en un navegador.

  • pressBack(): presiona el botón de volver hacia atrás en el dispositivo.

  • pressHome(): presiona el botón “Home” en el dispositivo.

  • pressOverview(): presiona el botón “Menú” (resumen de aplicaciones) en el dispositivo.

  • removeApp(appId): desinstala la aplicación especificada del dispositivo.

  • runAppInBackground: ejecuta la aplicación en segundo plano.

  • scrollToElement(Element): se desplaza hacia arriba o abajo, hasta el elemento especificado.

  • select: seleccione una opción de la lista de opciones del elemento html seleccionado. 

  • sendSMS(Phone number, Text): manda un SMS al dispositivo. Solo funciona en emulador.

  • startApp(appPackage, appActivity): inicia la aplicación especificada.

  • submit(Element): hace clic en el elemento y manda el formulario.

  • swipeScreen(): arrastra la pantalla en una dirección. Acepta duración, número de veces para arrastrar, e inicio y fin de coordenadas.

  • switchToNativeApp(): cambia al modo Native App.

  • switchToWebView(): cambia al modo Web View.

  • terminateApp(identifier, JSONArguments): cierra la aplicación especificada. Acepta argumentos JSON.

  • type(InputElement): añade el valor escrito al valor ya existente del elemento.

  • validateAttribute(Element, Attribute, Operator, Value to validate): valida los atributos del elemento como: id, clase, href, tamaño, ancho, valor, texto … etc. Imprime el resultado en el archivo de log.

  • waitFor(Time in seconds): espera el tiempo especificado en segundos.

  • waitForElement(Time in seconds, Element): esta función espera a que aparezca el elemento especificado en pantalla.