Cómo enviar una actualización específica a un usuario o un grupo

Prefacio

Cuando comiences a disfrutar del sistema de actualizaciones de Capgo, como yo con mis aplicaciones, empezarás a sentir el sentimiento “¿Qué si quiero más?”

También lo sentí, pero como soy el creador de Capgo, pude echar un vistazo!

Dado que todo es de código abierto, también tienes esta potestad :)

The siguiente dolor que obtuve en el proceso de distribución de la aplicación Capacitor es hacer que otros compañeros de equipo prueben las actualizaciones!

Con TestFlight, el problema es simple, llevar a las personas a tu equipo y hacer que entiendan cómo obtenerlo es un proceso laborioso!

Y por supuesto, cada vez que envías a Apple tienes un proceso de revisión aleatorio por un bot que puede tomar 5 minutos o 5 horas, nunca sabes.

Me retrasé muchas veces mi presentación debido a esto…

Y para Google esto es incluso peor, el gran misterio de mi vida, lanzar una versión de producción toma menos de 2 horas, pero lanzar una versión beta cercana toma 1–2 días.

Solución

Para solucionar esto, creé el sistema de canales en Capgo.

npx @capgo/cli@latest bundle upload -c production actualizará a todos los usuarios (si el canal de producción está configurado como predeterminado)

Si haces npx @capgo/cli@latest bundle upload -c development entonces la versión llegará a un canal diferente, esto se puede automatizar en GitHub acción.

Luego tienes 2 formas de permitir que los usuarios obtengan las actualizaciones desde el canal

Vía automática extremadamente rápida

Esta puede ser útil cuando no deseas crear tu propio backend para el canal de configuración, esto es rápido de implementar.

Con eso, la única cosa que necesitas hacer es permitir que uno de tus canales sea autoconfigurado.

Y luego agrega esto en el code de tu aplicación Ionic, para una mejor experiencia, utiliza esto después de que el usuario haga clic en un botón como “registrar para la beta”

import { CapacitorUpdater } from '@capgo/capacitor-updater'

const deviceId = await CapacitorUpdater.setChannel({ channel: 'beta' })

Vía manual

Esta puede ser útil para tu equipo interno, esto es rápido de implementar. Permite a los usuarios copiar su dispositivoID desde tu aplicación y enviarlo a ti manualmente, esta code te ayudará a obtenerlo:

import { CapacitorUpdater } from '@capgo/capacitor-updater'

const deviceId = await CapacitorUpdater.getDeviceId()

Oculta un botón en algún lugar de tu aplicación, o muestra el botón solo a los usuarios conectados con un admin rol, por ejemplo.

Luego ve a la aplicación web o nativa Capgo, conecta como administrador de la aplicación, selecciona tu aplicación, haz clic en la lista de dispositivos.

Luego coloca en la barra de búsqueda el dispositivoID haz clic en el encontrado y luego haz clic en el enlace de canal elige el developmentPregúntale a tu compañero de equipo que abra la aplicación nuevamente, espera 30 segundos y cierra.

Debería obtener tu versión.

Método automático

Esto puede ser útil para tus probadores beta, esto es más largo de implementar.

Igual que el método manual, debes obtener el dispositivoID

import { CapacitorUpdater } from '@capgo/capacitor-updater'

const deviceId = await CapacitorUpdater.getDeviceId()

Pero esta vez debes enviarlo automáticamente a tu backend, te dejo decidir cómo lo haces.

Te sugiero almacenarlo en una base de datos, eso facilitará tu vida más adelante.

Luego en tu backend debes enviarlo a Capgo backend también. A continuación, dos code ejemplos:

import axios from 'axios'

await axios.post('https://api.capgo.app/device', {
  app_id: 'YOUR_APP_ID',
  device_id: 'DEVICE_ID',
  channel: 'CHANNEL_NAME', // The name of the channel, or undefined if version_id provided
  version_id: 'VERSION_NAME' // this is optional, if provide it will override the channel, that useful when you want to debug only one user.
}, {
  headers: {
    authorization: 'YOUR_API_KEY' // choose a key with 'write' or 'all' rights
  }
})

addEventListener('fetch', (event) => {
  event.respondWith(
    handleRequest(event.request).catch(
      err => new Response(err.stack, { status: 500 })
    )
  )
})

async function handleRequest(request) {
  const { pathname, method } = new URL(request.url)
  const body = await request.json()
  const newBody = JSON.stringify({
    app_id: 'YOUR_APP_ID',
    device_id: body.device_id,
    channel: 'alpha'
  })
  const newUrl = new URL('https://api.capgo.app/device')
  const options = {
    headers: {
      authorization: 'YOUR_API_KEY',
    },
    method: 'POST',
    body: newBody
  }

  if (request.method === 'DELETE') {
    // DELETE the channel link
    options.method = 'DELETE'
    return fetch(newUrl.toString(), options)
  }

  return fetch(newUrl.toString(), options)
}

Después de esto configurado, intenta agregar un botón en tu aplicación para optar a la canal, y verifica en la aplicación web si eso ha sido configurado.

También puedes enviar null para eliminar la sobrescritura

Si necesita verificar de forma programática qué sobrescritura está configurada en un dispositivo, puede obtenerla en la misma URL

import axios from 'axios'

const res = await axios.get('https://api.capgo.app/device?app_id=YOUR_APP_ID&device_id=DEVICE_ID', {
  headers: {
    authorization: 'YOUR_API_KEY' // choose a key with 'write' or 'all' rights
  }
})

console.log('data', res.json())

Sigue adelante desde Cómo enviar una actualización específica a un usuario o un grupo

Si está utilizando Cómo enviar una actualización específica a un usuario o un grupo para planificar la ruta de canal y la implementación en varias etapas, conéctelo con Canales para los detalles de implementación en Canales, 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, y Solución de Alcance de Versión para el flujo de trabajo del producto en Solución de Alcance de Versión.