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

Introducción

Cuando comiences a disfrutar del sistema de actualizaciones de Capgo, como lo hago con mis aplicaciones, empezarás a sentir el deseo de ‘¿Qué si quiero más?’

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

Como todo es de código abierto, también tienes ese poder :)

El siguiente dolor de cabeza 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, pero llevar a las personas a tu equipo y hacer que entiendan cómo obtenerlo es un proceso que consume tiempo!

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

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

Y para Google, esto es incluso peor, el gran misterio de mi vida, publicar una versión de producción toma menos de 2 horas, pero publicar 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.

Entonces tienes 2 formas de permitir a los usuarios obtener las actualizaciones desde el canal

Vía automática super

Esto 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 'regístrate para la beta'

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

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

Vía manual

Esto 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 introduce 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 de nuevo, espera 30 segundos y cierra.

Debería obtener tu versión.

Forma automática.

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

Lo mismo que la forma 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 que decidas cómo lo haces.

Te sugiero que lo almacenes 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, te muestro 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 configurado, intenta agregar un botón en tu aplicación para optar a la canalización, y verifica en la aplicación web si eso ha sido configurado.

También puedes enviar null para eliminar la sobrescritura

Si necesita comprobar 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())

Siga 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 canales y el despliegue en etapas, conéctelo con Canales contexto: nombre de la característica de canales de Capgo. Página/área: página de marketing de soluciones de Capgo. Rol: etiqueta de IU corta o elemento de navegación. Visto en: página solutions/white-label.astro. Clave de mensaje `solutions_white_label_visual_cell2_value` (Valor de celda visual de Solutions White Label) para los detalles de implementación en Canales, Canal contexto: nombre de la característica de canales de Capgo. Página/área: página de marketing de soluciones de Capgo. Rol: etiqueta de IU corta o elemento de navegación. Visto en: página solutions/white-label.astro. Clave de mensaje `solutions_white_label_visual_cell2_value` (Valor de celda visual de Solutions White Label) 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 Enfoque de Versión para el flujo de trabajo del producto en Solución de Enfoque de Versión.