Configurando Appium en Mac por primera vez

En este post nuevo trataré de explicar todo lo que se tiene que hacer para hacer un setup correcto de Appium, el cual tiene muchas dependencias de diferentes herramientas y librerías, sobre todo en Mac.

¿Que es Appium?

De la pagina oficial se desprende la siguiente definición: Appium es un framework de automatización de pruebas open source para usar con apps nativas, webs, móvil e híbridas. Sirve para usar con iOs, Android y Windows usando el protocolo WebDriver.

Flujo Básico

Instalación

Primero mostraré un pequeño diagrama con sus dependencias para tener una visión general del setup.

Pasos

1. En Mac OSX el primer paso es instalar/actualizar Xcode. Esto a veces conlleva a la actualización del sistema operativo.
   1. Si no tienes OSX actualizado, actualízalo.
   2. Para instalar/actualizar Xcode hay que buscarlo en la app store.
   3. Necesitas tu apple account.
   4. Ponlo a bajar y ve por una ?
   5. Luego ve por otra más porque el download es de 4 Gb y luego sigue la instalación con reinicios y todo eso incluído
2. Instalar Homebrew.
   1. Abrir una terminal.
   2. Teclear brew --version
   3. Si recibes -bash: brew: command not found entonces corre lo siguiente: /usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"
   4. Si en vez de eso recibes un error entonces tienes Brew descompuesto por un update de Yosemite (Si tienes rato con tu Mac). Hay que hacer which brew Si regresa un path, eso significa que sí está instalado.
   5. Necesitamos hacer cd /usr/local/Library
   6. Luego git pull origin master
   7. Luego brew update && brew uninstall nodejs && brew install nodejs
   8. Finalmente para estar seguros que quedó instalado: brew --version
3. El siguiente paso es instalar Java.
   1. Hay que ir aquí
   2. Aceptar Términos y Condiciones.
   3. Bajar el JDK para Mac OSX.
   4. Instalar el JDK.
4. Luego hay que instalar Android Studio (se puede instalar solo el SDK o todo el Android Studio, lo que realmente necesitamos aqui es el SDK pero el Android Studio lo incluye).
   1. Ir aquí
   2. Bajarlo e instalar.
5. Obtener Paths for Android SDK y Java JDK.
   1. Primero vamos con Java, hay que abrir la terminal.
   2. Teclear /usr/libexec/java_home -V
   3. Copiémoslo en algun lado para después.
   4. Luego vamos con Android. Teclear find ~ -name "adb"
   5. Hay que copiar el path que lanza (ignorando los ejemplos).
6. Ahora tenemos que agregar esas rutas a nuestro path.
   1. Teclear nano ~/.bash_profile en la terminal.
   2. Ahí tenemos que agregar las siguientes líneas.

   export PATH=$PATH:path/a/android-sdk/platform-tools/:path/a/android-sdk/tools/
   export JAVA_HOME="/path/a/java/home/"
   export ANDROID_HOME="/path/a/android/sdk"

   3. Para guardar y salir hay que teclear.

   ctrl + X
   luego
   enter

   4. Finalmente teclear source ~/.bash_profile en la terminal para que los cambios hagan efecto.
7. Actualizar Android SDK.
   1. En la terminal de nuevo teclear android. Esto funciona debido a la primer linea que agregamos en el archivo .bash_profile.
   2. Abrirá una GUI, ahi hay que seleccionar todas las versiones desde la mas actual hasta al menos la 4.0, todo bajo “extras” y todo bajo “tools”.
   3. Click en el botón “Install XX packages” (donde XX es un número).
   4. Seleccionar un ítem de la lista de la izq. en la siguiente ventana y seleccionar aceptar términos.
   5. De nuevo es tiempo para una :beer:
   6. Repetir estos 5 pasos previos para actualizar hasta que ya no haya actualizaciones disponibles.
8. Instalar Node.js.
   1. Primero veremos si ya está instalado con el siguiente comando en la terminal: node --version
   2. Luego which node
   3. Si aparece -bash: node: command not found después del primer comando y nada aparece luego del segundo comando, no está instalado. Si tenemos una versión en el primero podemos saltar esto.
   4. Si no está instalado para hacerlo tecleamos brew install node
9. ¡Finalmente a instalar Appium!
   1. Abrir la terminal y correr los siguientes comandos de uno por uno.

      npm install -g appium
      npm install wd
      npm install -g appium-doctor

   2. Correr appium doctor para revisar la instalación. En la terminal escribir appium-doctor --ios. Si hay errores seguir las sugerencias.
   3. Luego escribir appium-doctor --android. Igual que en la anterior, Si encuentra errores, seguir las sugerencias para corregirlos.
10. Instalar RVM en Mac. Para mas información acerca de RVM https://rvm.io/
    1. Teclear \curl -sSL https://get.rvm.io | bash en la terminal.
    2. Esperar a que descargue.
11. Crear un proyecto en donde trabajar.
    1. Crear una carpeta en el lugar deseado.
    2. Dentro de esa carpeta vamos a usar nuestro editor favorito y crear un archivo llamado Gemfile. Así, con G mayúscula y sin extensión.
    3. Adentro de ese archivo vamos a escribir las siguientes líneas.

       source 'http://rubygems.org'
       gem 'appium_lib'
       gem 'rspec'
       gem 'appium_console', '=1.0.4'
       gem 'os'
       gem 'allure-rspec'

    4. Guardamos y luego vamos y abrimos la terminal.
    5. Teclear cd /path/a/la/carpeta/del/proyecto
    6. Correr lo siguiente desde esa carpeta rvm use --create 2.3.0 En caso de querer usar ruby 2.3.0. Puedes cambiar la versión de ruby modificando esta línea.
    7. Luego correr gem install bundler
    8. Luego, finalmente correr bundle install
    9. Esperar a que todas las Gemas se instalen y listo.

¡Listo! Ya puedes empezar a codear tu proyecto usando Appium.