Saltar al contenido

Descubre el Nuevo SDK de Valido App y potencia la validación visual de tu ecommerce

En el evolutivo mundo del desarrollo de software, la calidad y la eficiencia son fundamentales. Es por eso que en Orienteed, estamos entusiasmados de presentar una emocionante mejora para nuestra herramienta Valido. Si eres un profesional que busca llevar tus pruebas al siguiente nivel, sigue leyendo para descubrir cómo nuestro nuevo SDK puede revolucionar la forma en que te acercas a la validación de tus aplicaciones de comercio electrónico.

La validación visual ha demostrado ser una parte esencial del proceso de desarrollo de software, permitiendo a los equipos identificar rápidamente problemas de diseño, errores de presentación y otros aspectos visuales críticos. Hasta ahora, nuestros clientes han confiado en la interfaz intuitiva de la herramienta Valido Testing para llevar a cabo estas pruebas.

Sin embargo, para aquellos que buscan una mayor flexibilidad y la posibilidad de integrar estas pruebas en sus flujos de trabajo automatizados, hemos desarrollado el SDK de Valido.

En esta entrada, te explicaré cómo el SDK de Valido App puede potenciar tus esfuerzos de validación visual. Desde la creación e integración con tus pruebas automáticas.

¡Prepárate para llevar tu proceso de validación visual al siguiente nivel con el poderoso SDK de Valido!

Valido App SDK

¿Qué es un SDK?

Un SDK (Software Development Kit, por sus siglas en inglés) es un conjunto de herramientas y recursos que facilitan la creación y desarrollo de aplicaciones. Proporciona componentes predefinidos, documentación y funciones clave para agilizar el proceso de programación, permitiendo a los desarrolladores crear software de manera eficiente y rápida. 

A continuación te mostraré varios puntos clave por lo cuales El SDK de Valido es importante para la realización de pruebas en un ecommerce:

  1. Automatización eficiente: Los ecommerce suelen tener una gran cantidad de páginas, productos y variaciones. Gracias al SDK nos permite ahorrar recursos al ejecutar pruebas en todas estas áreas de manera consistente y rápida. 
  2. Detección temprana de problemas: Las pruebas automatizadas a través del SDK pueden detectar problemas de diseño, elementos faltantes o errores de presentación en etapas iniciales de desarrollo, lo que ayuda a abordar estos problemas antes de que lleguen a los usuarios finales.
  3. Compatibilidad múltiple: La mayoría de ecommerce son puestos a prueba en diversos navegadores y dispositivos. El SDK puede realizar pruebas en diferentes configuraciones para asegurarse de que la experiencia sea coherente en todas las plataformas.
  4. Ahorro de tiempo y recursos: La automatización mediante el SDK reduce la necesidad de realizar pruebas manuales repetitivas, lo que libera al equipo de pruebas para centrarse en aspectos más estratégicos y complejos. 

En resumen, el SDK de Valido proporciona a los ecommerce una solución potente para garantizar la calidad visual y la experiencia de usuario en un entorno online altamente competitivo.

¿Qué necesitas para usar el SDK de Valido App?

Para empezar a aprovechar el potencial del SDK de Valido es más sencillo de lo que piensas. Solo necesitarás un par de elementos esenciales: credenciales AWS IAM y  tus propias credenciales de Valido. Además asegúrate de contar con un proyecto Java 11.

En esta guía, te mostraremos una serie de pasos sencillos para realizar la configuración y empezar a sacarle provecho al SDK de Valido.

Credenciales

En primer lugar, necesitamos tener los dos tipos de credenciales necesarias para trabajar con el SDK así que ponte en contacto con el equipo de Valido App para conseguirlas en caso de que no las tengas.

Credenciales de AWS

Las credenciales de AWS son necesarias para escribir datos en S3 y para acceder al repositorio S3 de Maven. Tienes tres formas de configurar estas credenciales:

– Añadirlas al archivo ~/.aws/config. En caso de que no lo tengas, puedes crearlo:

 [default]
    aws_access_key_id= value from AWS access portal
    aws_secret_access_key= value from AWS access portal

– Estableciendo variables de entorno: AWS_ACCESS_KEY_ID y `AWS_SECRET_ACCESS_KEY`.

– Usando AWS CLI.
ℹ Puedes ir a Proporcionar credenciales temporales al SDK de AWS para Java para obtener más detalles sobre las credenciales IAM de AWS.

Credenciales de Valido App 

Para acceder a la API de Valido y enviar los resultados de la ejecución, debes crear un archivo de propiedades de Java con la siguiente estructura:

username=myusername
password=supersecretpassword
secretHash=supersecrethash

Por otro lado, también tienes la opción de añadirlas mediante variables de entorno: VALIDO_USERNAME, VALIDO_PASSWORD y VALIDO_SECRETHASH.

Configuración del proyecto

El SDK de Valido está almacenado en el repositorio privado de Maven en S3, por eso necesitas la siguiente configuración en el archivo POM de tu proyecto. En este .pom de ejemplo, las únicas etiquetas que te deben importar son:  <repositories>, <distributionManagement>, <extensions> y el valido-framework <dependency>.

<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>
    <groupId>com.orienteed.valido</groupId>
    <artifactId>sdk-test</artifactId>
    <packaging>jar</packaging>
    <version>0.1.0</version>
    <repositories>
        <repository>
            <id>s3.release</id>
            <name>Orienteed S3 Maven Release Repo</name>
            <url>s3://maven-repo.orienteed.com/release</url>
        </repository>
        <repository>
            <id>s3.snapshot</id>
            <name>Orienteed S3 Maven Snapshot Repo</name>
            <url>s3://maven-repo.orienteed.com/snapshot</url>
        </repository>
    </repositories>
       
    <distributionManagement>
        <snapshotRepository>
            <id>s3.snapshot</id>
            <url>s3://maven-repo.orienteed.com/snapshot</url>
        </snapshotRepository>
        <repository>
            <id>s3.release</id>
            <url>s3://maven-repo.orienteed.com/release</url>
        </repository>
    </distributionManagement>
   
    <dependencies>
        <dependency>
            <groupId>com.orienteed.valido</groupId>
            <artifactId>valido-framework</artifactId>
            <version>0.13.1-SNAPSHOT</version>
        </dependency>
    </dependencies>
   
    <build>
        <plugins>
            <plugin>
                <artifactId>maven-compiler-plugin</artifactId>
                <version>3.6.1</version>
                <configuration>
                    <source>11</source>
                    <target>11</target>
                    <fork>true</fork>
                    <encoding>UTF-8</encoding>
                </configuration>
            </plugin>
            <plugin>
                <artifactId>maven-surefire-plugin</artifactId>
                <version>2.22.2</version>
            </plugin>
        </plugins>
        <extensions>
            <extension>
                <groupId>com.allogy.maven.wagon</groupId>
                <artifactId>maven-s3-wagon</artifactId>
                <version>1.2.0</version>
            </extension>
        </extensions>
    </build>
</project>

Creando una prueba con el SDK de Valido App

Configurar las propiedades del flow

Primero, antes de empezar con el código, necesitamos crear un archivo Java .properties para cada flujo. Para Valido un flow es un test.

env=pro
secretsPath=location/of/valido-credentials.properties
region=ES
resolution=DESKTOP
device=1400x800
os=windows
browser=chrome
driverPath=location/of/driver

– `env` El entorno de Valido al que va dirigido.

– `secretsPath` La ubicación del archivo de credenciales de Valido.

– `region` Debe ser un código de país ISO de dos letras.

– `resolution` La resolución viene determinada por el dispositivo: DESKTOP, MOBILE, TABLET.

– `device` Puedes especificar un ID de dispositivo o una resolución con el formato *ancho x alto*.

– `os` Sistema operativo para la prueba de ejecución.

– `browser` Especifica el navegador donde se ejecutará el test. *chrome, firefox,safari…*

– `driverPath` La ubicación del driver del navegador que se utilizará para ejecutar el test.

Es posible que para tus proyectos esta configuración pueda ser de carácter genérico, por lo que para facilitar el proceso puedes establecerlas también como variables de entorno. Para establecerlas como variables de entorno deben seguir el siguiente formato: VALIDO_(PROPERTY_KEY), todo en mayúsculas.

Suscríbete a nuestro newsletter.

Mantente informado con las mejores prácticas y estrategias para hacer comercio electrónico y crecer el negocio como una marca líder en tu industria.

Implementación de una prueba

Dirígete a la aplicación Valido y haz clic en Valido Lab [beta] situado en la barra lateral izquierda.En esta sección debes dar un nombre a tu test y seleccionar la marca u organización, en la que estará este test, y pulsa sobre el botón crear. La aplicación devuelve un *flow ID*, debes guardarlo, porque lo necesitarás para referenciar este flow dentro de nuestro proyecto.

Valido App SDK

Ahora si quieres implementar el SDK en tu test, debes:

– Extender la clase ValidoCore

– Pasar el ID del flujo y la ruta de los archivos de propiedades al constructor.

package com.orienteed.valido.cores;
import static org.junit.jupiter.api.Assertions.assertTrue;
import java.io.IOException;
import java.net.URISyntaxException;
import org.junit.jupiter.api.Test;
import com.orienteed.valido.api.ValidoAPIException;
public class SdkExecutor {
    String flowId = "00000xx0-x000-00xx-0000-0x0x0x0d0xx0";
    String path = "src/test/resources/valido/chrome-flow-specs.properties";
    @Test
    public void test1() throws IOException, ValidoAPIException, URISyntaxException {
        new SdkFlow(flowId, path).run();
    }  
}

Para poder acceder  al driver, solo tienes que hacer uso del método getDriver(). En caso de querer establecer uno, tambien existe el metodo setDriver().

package com.orienteed.valido.cores;
import java.io.IOException;
import java.net.URISyntaxException;
import com.orienteed.valido.api.ValidoAPIException;
public class SdkFlow extends ValidoCore {
    public SdkFlow(String flowId, String path) throws IOException, ValidoAPIException, URISyntaxException {
        super(flowId, path);
    }
    @Override
    public void flow() throws IOException, ValidoAPIException {
        getDriver().get("www.valido.ai");
        compare("Home page");
    }
}

Ahora ya puedes lanzar tu primera prueba y ver los resultados en Valido App.

Integración con sistemas CI/CD

Para realizar la integración con una plataforma como puede ser Jenkins, en este caso es tan simple como establecer en la configuración de nuestro job las credenciales, siguiendo las reglas de seguridad que estén establecidas en tu organización y asegurate de que los ficheros .properties tienen los parámetros requeridos. Estos ficheros son mandatorios para el SDK de Valido.

Conclusión

En resumen, el nuevo SDK de Valido App ha llegado para transformar la manera en que abordamos la validación visual en el desarrollo de software. Desde su capacidad para generar pruebas de validación visual mediante código hasta su integración perfecta con herramientas de automatización como Jenkins, este SDK es una herramienta poderosa que empodera a los equipos de desarrollo a garantizar una experiencia de usuario impecable.

La sinergia entre la facilidad de uso de Valido y la versatilidad del SDK permite a los desarrolladores concentrarse en la creatividad y la innovación, mientras se aseguran que la apariencia y la funcionalidad de sus aplicaciones estén siempre en su mejor forma. Ya sea que estés desarrollando una aplicación web, una aplicación móvil, el SDK de Valido está listo para acompañarte en tu viaje hacia la excelencia visual de tu ecommerce.

Así que, ¿estás listo para dar el salto y explorar el potencial del SDK de Valido? No dudes en comenzar hoy mismo y experimentar de primera mano cómo esta nueva herramienta puede mejorar tus flujos de trabajo de validación visual.

En Orienteed, estamos emocionados por la perspectiva de ver cómo nuestros clientes aprovechan al máximo esta innovación en sus procesos de desarrollo. 

¡Únete a nosotros en esta nueva era de validación visual potenciada por la tecnología de Valido App! Contáctanos aquí.