Canales

Los canales son la mecanismo fundamental para gestionar actualizaciones de la aplicación en Capgo. Permiten controlar cómo y cuándo los usuarios reciben actualizaciones, habilitando características como pruebas A/B, despliegues escalonados y actualizaciones específicas de plataforma.

Entendiendo los canales

Un canal representa un seguimiento de distribución para actualizaciones de la aplicación. Cada canal puede configurarse con reglas y restricciones específicas:

• Control de paquete (versión): Especificar qué paquete (versión) reciben los usuarios
• Plataformas Destinadas: Dirija específicas plataformas (iOS/Android/Electron)
• Políticas de Actualización: Controla cómo se entregan las actualizaciones
• Restricciones de Dispositivo: Administra qué dispositivos pueden acceder a las actualizaciones

Opciones de Configuración de Canal

• público: Establezca como canal predeterminado para nuevos dispositivos
• desactivarActualizaciónAutomáticaBajoAplicaciónNativa: Prevenga actualizaciones cuando la versión de la aplicación nativa del dispositivo es más reciente que el paquete de actualización (versión) disponible en el canal (por ejemplo, el dispositivo está en la versión de la aplicación nativa 1.2.3, pero el canal tiene el paquete (versión) 1.2.2)
• desactivarActualizacionesAutomaticas: Controlar el comportamiento de actualización (“mayor”, “menor”, “número de versión”, “ninguno”)
• ios/android/electron: Habilitar/deshabilitar para plataformas específicas
• permitirDispositivoAutoconfiguracion: Dejar que los dispositivos elijan su canal
• permitirEmulador: Permitir actualizaciones en dispositivos emulados
• permitirDesarrollo: Permitir actualizaciones en compilaciones de desarrollo

Prácticas Recomendadas

1. Canal de Prueba: Mantenga un canal de pruebas para la validación interna
2. Despliegue Etapa: Utilice varios canales para el despliegue de actualizaciones graduales
3. Separación de Plataformas: Cree canales separados para iOS, Android y Electron cuando sea necesario
4. Control de Paquete (versión): Utilice la "versión semántica" para caminos de actualización claros Puntos de Acceso

Sección titulada “Puntos de Acceso”

POST

https://api.capgo.app/channel/

Crear o actualizar una configuración de canal.

Cuerpo de la solicitud

type disable_update = "major" | "minor" | "version_number" | "none"
interface ChannelSet {
  app_id: string
  channel: string
  version?: string // bundle (version) name
  public?: boolean
  disableAutoUpdateUnderNative?: boolean
  disableAutoUpdate?: disable_update
  ios?: boolean
  android?: boolean
  electron?: boolean
  allow_device_self_set?: boolean
  allow_emulator?: boolean
  allow_dev?: boolean
}

Solicitud de ejemplo

curl -X POST \
  -H "authorization: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "app_id": "app_123",
    "channel": "beta",
    "version": "1.2.0",
    "public": false,
    "disableAutoUpdate": "minor",
    "ios": true,
    "android": true,
    "electron": true,
    "allow_emulator": true
  }' \
  https://api.capgo.app/channel/

Respuesta de éxito

{
  "status": "ok"
}

GET

https://api.capgo.app/channel/

Obtener información del canal. Devuelve 50 canales por página.

Parámetros de consulta

• app_id: Obligatorio. El ID de tu aplicación
• page: Opcional. Número de página para paginación
• channel: Opcional. Nombre específico del canal para recuperar

Solicitudes de ejemplo

# Get all channels
curl -H "authorization: your-api-key" \
  "https://api.capgo.app/channel/?app_id=app_123"

# Get specific channel
curl -H "authorization: your-api-key" \
  "https://api.capgo.app/channel/?app_id=app_123&channel=beta"

# Get next page
curl -H "authorization: your-api-key" \
  "https://api.capgo.app/channel/?app_id=app_123&page=1"

Tipo de respuesta

interface Channel {
    id: number;
    created_at: string;
    name: string;
    app_id: string;
    version: { // bundle (version) assigned to the channel
        id: number,
        name: string
    };
    created_by: string;
    updated_at: string;
    public: boolean;
    disableAutoUpdateUnderNative: boolean;
    disableAutoUpdate: boolean;
    allow_emulator: boolean;
    allow_dev: boolean;
}

En la respuesta a continuación, version se refiere al paquete (versión) asignado al canal.

Respuesta de ejemplo

{
  "data": [
    {
      "id": 1,
      "name": "production",
      "app_id": "app_123",
      "version": {
        "id": 1,
        "name": "1.0.0"
      },
      "created_at": "2024-01-01T00:00:00Z",
      "updated_at": "2024-01-01T00:00:00Z",
      "created_by": "user_123",
      "public": true,
      "disableAutoUpdateUnderNative": false,
      "disableAutoUpdate": false,
      "allow_emulator": false,
      "allow_dev": false
    }
  ]
}

Eliminar

https://api.capgo.app/channel/

Elimine un canal. Tenga en cuenta que esto afectará a todos los dispositivos que utilicen este canal.

Parámetros de consulta

interface Channel {
  channel: string
  app_id: string
}

Solicitud de ejemplo

curl -X DELETE \
  -H "authorization: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "app_id": "app_123",
    "channel": "beta"
  }' \
  https://api.capgo.app/channel/

Respuesta de éxito

{
  "status": "ok"
}

Gestión de errores

Escenarios de errores comunes y sus respuestas:

// Channel not found
{
  "error": "Channel not found",
  "status": "KO"
}

// Invalid bundle (version) format
{
  "error": "Invalid version format. Use semantic versioning",
  "status": "KO"
}

// Invalid update policy
{
  "error": "Invalid disableAutoUpdate value",
  "status": "KO"
}

// Permission denied
{
  "error": "Insufficient permissions to manage channels",
  "status": "KO"
}

Uso común

1. Pruebas de beta

{
  "app_id": "app_123",
  "channel": "beta",
  "version": "1.2.0-beta",
  "public": false,
  "allow_emulator": true,
  "allow_dev": true
}

2. Implementación en producción

{
  "app_id": "app_123",
  "channel": "production",
  "version": "1.2.0",
  "public": true,
  "disableAutoUpdate": "minor"
}

3. Actualizaciones específicas de plataforma

{
  "app_id": "app_123",
  "channel": "ios-hotfix",
  "version": "1.2.1",
  "ios": true,
  "android": false
}

Seguir desde Canales

Si estás utilizando Canales para planificar la ruta de los canales y la implementación en etapas, conecta con Canales para los detalles de implementación en Canales, Canales para los detalles de implementación en Canales, Solución de Pruebas Beta para el flujo de trabajo del producto en Solución de Pruebas Beta, Solución de Versionado de Objetivos para el flujo de trabajo del producto en Solución de Versionado de Objetivos, y Capgo Prácticas recomendadas del entorno: Etapa con un ID de aplicación móvil para el contexto práctico en Capgo Prácticas de Entorno: Etapa con un ID de Aplicación Móvil.