Ruby en el desarrollo móvil: Fastlane, CI/CD y automatización

¿Qué es Ruby?

Ruby es un lenguaje dinámico interpretado de código abierto creado por Yukihiro Matsumoto en 1995. El principio fundamental de Ruby es la "simplicidad óptima" (principle of least surprise). El lenguaje es conocido por los bloques (closures), un enfoque puro orientado a objetos (todo es un objeto, incluidos los números) y un potente sistema de metaprogramación.

Ruby se ejecuta en el intérprete YARV (Yet Another Ruby VM) con compilación JIT desde la versión 3.1. La versión actual Ruby 3.4 (2025) incluye decoradores, un mejorado analizador Prism y soporte experimental de tipos mediante RBS. RubyGems — el gestor de paquetes — contiene más de 200 000 gemas.

Ruby on Rails es el framework web más famoso construido con Ruby, pero en el desarrollo móvil Ruby se utiliza de forma diferente. Su nicho principal es Fastlane: un ecosistema de scripts y gemas de Ruby para automatizar todas las etapas del ciclo de vida de una aplicación móvil, desde la firma de código hasta la publicación en las tiendas.

Conceptos básicos de sintaxis de Ruby para Fastlane

Trabajar con Fastlane solo requiere conocimientos básicos de Ruby: métodos, bloques do-end, símbolos (:symbol) y sintaxis de hashes { key: value }. A diferencia de Python, Ruby usa end para cerrar bloques en lugar de sangría. Los métodos pueden llamarse sin paréntesis — esto se usa activamente en el DSL de Fastlane.

# Sintaxis básica de Ruby utilizada en Fastlane
def download_assets(version, platform: "ios")
  paths = {
    ios: "ios/Assets.car",
    android: "android/app/src/main/assets"
  }
  url = "https://cdn.example.com/assets/#{version}/#{paths[platform.to_sym]}"
  puts "Downloading from: #{url}"

  unless File.exist?("temp/assets")
    Dir.mkdir("temp/assets")
  end
  result = system("curl -o temp/assets.zip #{url}")
  raise "Download failed" unless result
end

download_assets("1.2.3", platform: "android")

En el ejemplo, el método download_assets recibe un argumento version y un parámetro nombrado opcional platform (por defecto "ios"). La interpolación de cadenas con #{...} inserta valores directamente en las cadenas. unless es lo contrario de if — ejecuta el código cuando la condición es falsa.

Fastlane: automatización de compilaciones móviles con Ruby

Fastlane es una herramienta de código abierto escrita en Ruby. Instalada mediante gem install fastlane, proporciona un conjunto de comandos para automatizar las tareas más rutinarias del desarrollador móvil: crear capturas de pantalla, firmar código, publicar en TestFlight y Google Play Console.

Fastlane consta de herramientas: sigh (gestión de certificados), match (sincronización de certificados en equipos), gym (compilaciones iOS), gradle (compilaciones Android), deliver (publicación iOS), supply (publicación Android), snapshot (capturas de pantalla), scan (pruebas). Todas las herramientas son accesibles desde un único Fastfile.

En proyectos grandes, Fastlane maneja más de 50 acciones en un solo pipeline: incremento de versión, descarga de assets desde CDN, compilación, firma, carga en App Store Connect, envío de notificaciones a Slack. Todo el pipeline se ejecuta con un solo comando: fastlane release.

Fastfile: configuración del pipeline de compilación

Fastfile es un archivo DSL similar a Ruby que describe una secuencia de acciones (lanes). Cada lane es una tarea independiente: beta (compilación de prueba), release, screenshots. Los lanes pueden llamar a otros lanes con parámetros pasados.

# Fastfile — configuración del pipeline de compilación de la aplicación iOS
fastlane_version "2.220.0"

default_platform :ios

platform :ios do
  desc "Compilación y despliegue del build de TestFlight"
  lane :beta do |options|
    increment_build_number(
      build_number: options[:build]
    )
    match(type: :appstore)
    gym(
      scheme: "MyApp",
      export_method: "app-store",
      configuration: "Release"
    )
    upload_to_testflight(
      app_identifier: "com.example.myapp"
    )
    slack(
      message: "Build #{options[:build]} subido a TestFlight"
    )
  end
end

El lane beta ejecuta secuencialmente: incrementar número de compilación (increment_build_number), sincronizar certificados (match), compilar archivo (gym), cargar en TestFlight (upload_to_testflight) y enviar notificación a Slack. El parámetro :build se pasa al lane como argumento nombrado.

Configuración de Android en Fastfile

Fastlane admite ambas plataformas en un único Fastfile. Para Android, use un lane dentro de platform :android con las acciones gradle, supply y google_play_track_version_codes.

platform :android do
  desc "Compilación de APK y publicación en Google Play Internal Testing"
  lane :beta do
    gradle(
      task: "assemble",
      build_type: "Release",
      flavor: "Production"
    )
    supply(
      track: "internal",
      apk_paths: ["app/build/outputs/apk/release/app-release.apk"]
    )
  end
end

Acciones clave de Fastlane para iOS y Android

Fastlane incluye más de 200 acciones integradas. A continuación, las más importantes para el desarrollo móvil, organizadas por categoría.

Match: gestión segura de certificados

match es una gema de Fastlane para sincronizar certificados iOS y perfiles de aprovisionamiento entre desarrolladores. Todos los secretos se almacenan en un repositorio Git cifrado o en S3. Match genera automáticamente certificados si faltan y los renueva al vencerse.

# Inicialización de match para un nuevo proyecto
$ fastlane match init

# Creación y sincronización de certificados de App Store
$ fastlane match appstore

# Creación de certificados de Development para el equipo
$ fastlane match development

# Renovación de todos los certificados al vencerse
$ fastlane match --force

Match almacena las claves privadas con una frase de contraseña que solo conocen los desarrolladores. Cada desarrollador clona el repositorio de certificados y ejecuta match para instalar los perfiles actuales. Los certificados de Apple tienen validez de 1 año; match los renueva automáticamente.

Integración de Fastlane con sistemas CI/CD

Fastlane se integra con cualquier plataforma CI/CD: GitHub Actions, GitLab CI, CircleCI, Bitrise, Jenkins y Xcode Cloud (a través de xcode-build). Fastlane se ejecuta en CI mediante fastlane <lane_name> y devuelve un código de error si algún paso falla.

La configuración para GitHub Actions incluye instalar Ruby, fastlane y ejecutar el lane mediante bundle exec fastlane. Las compilaciones iOS requieren un runner macOS. Las compilaciones Android pueden usar ubuntu-latest, que es más económico.

# .github/workflows/deploy.yml — CI/CD con Fastlane
name: Deploy Mobile App
on:
  push:
    branches: [main]

jobs:
  ios-deploy:
    runs-on: macos-14
    steps:
      - uses: actions/checkout@v4
      - uses: ruby/setup-ruby@v1
        with:
          ruby-version: "3.3"
      - run: bundle install
      - run: bundle exec fastlane beta
      - env:
          MATCH_PASSWORD: ${{ secrets.MATCH_PASSWORD }}

El workflow se ejecuta al hacer push a main. El runner macOS ejecuta bundle exec fastlane beta desde el Fastfile. MATCH_PASSWORD se pasa a través de GitHub Secrets para el descifrado de certificados. Tras completar el lane, una acción de Slack envía una notificación.

Ruby Gems y plugins de Fastlane

RubyGems es el gestor de paquetes para Ruby. Fastlane se amplía mediante plugins — gemas que añaden nuevas acciones. El plugin fastlane-plugin-versioning gestiona versiones, fastlane-plugin-firebase_app_distribution carga compilaciones en Firebase. Hay más de 500 plugins de Fastlane en GitHub.

El Gemfile en la raíz del proyecto fija las versiones de todas las dependencias para compilaciones reproducibles. bundle install instala las gemas desde Gemfile.lock. Las gemas esenciales para el desarrollo móvil incluyen: fastlane, cocoapods (dependencias iOS), xcodeproj (manipulación de .xcodeproj).

# Gemfile para un proyecto móvil
source "https://rubygems.org"

gem "fastlane", "~> 2.220"

plugins_path = File.join(File.dirname(__FILE__), 'fastlane', 'Pluginfile')
eval_gemfile(plugins_path) if File.exist?(plugins_path)

Fastlane frente a alternativas: comparación de enfoques

Fastlane no es la única herramienta de automatización. Comparémosla con las principales alternativas según criterios importantes para un equipo móvil.

Fastlane sigue siendo la herramienta más flexible para pipelines complejos. Bitrise es conveniente para equipos sin un desarrollador Ruby. Xcode Cloud funciona para proyectos iOS simples. GitHub Actions es ideal si el equipo ya usa GitHub.