Comment envoyer une mise à jour spécifique à un utilisateur ou un groupe

Avant-propos

Lorsque vous commencez à apprécier le système de mise à jour de Capgo, comme moi pour mes applications, vous allez commencer à ressentir le sentiment « Quoi si je veux plus ? »

J'ai ressenti ce sentiment également, mais puisque je suis le créateur de Capgo, j'ai pu jeter un coup d'œil !

Puisque tout est open-source, vous avez également ce pouvoir :)

Le prochain problème que j'ai eu dans le processus de distribution de l'application Capacitor est de faire tester les mises à jour à d'autres collègues.

Avec TestFlight, le problème est simple, mais apporter des personnes dans votre équipe et les faire comprendre comment obtenir cela prend du temps !

Et bien sûr, chaque fois que vous envoyez à Apple, vous avez un processus de révision aléatoire par un bot qui peut prendre 5 minutes ou 5 heures, vous ne savez jamais.

J'ai souvent eu mon présentation retardée par cela…

And pour Google, c'est même pire, le grand mystère de ma vie, la mise en production d'une version prend moins de 2 heures, mais la mise en bêta proche prend 1–2 jours.

Solution

Pour résoudre cela, j'ai créé le système de canal dans Capgo.

npx @capgo/cli@latest bundle upload -c production mettra à jour pour tous les utilisateurs (si le canal de production est défini par défaut)

Si vous le faites npx @capgo/cli@latest bundle upload -c development alors la version se rend sur un canal différent, cela peut être automatisé dans GitHub action.

Ensuite, vous avez 2 façons de permettre aux utilisateurs de recevoir les mises à jour du canal

Super façon automatique

Cela peut être utile lorsque vous ne voulez pas créer votre propre backend pour le canal, c'est rapide à mettre en œuvre.

Avec cela, la seule chose que vous devez faire est d'autoriser l'un de vos canaux à être auto-configuré.

And puis ajoutez cela dans le code de votre application Ionic, pour une meilleure expérience, utilisez cela après que l'utilisateur clique sur un bouton comme « s'inscrire pour la bêta »

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

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

Mode manuel

Cela peut être utile pour votre équipe interne, c'est rapide à mettre en œuvre. Permettez aux utilisateurs de copier leur ID de appareil depuis votre application et de le vous envoyer manuellement, ce code vous aidera à l'obtenir :

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

const deviceId = await CapacitorUpdater.getDeviceId()

Cacher un bouton quelque part dans votre application, ou afficher le bouton uniquement aux utilisateurs connectés avec un admin rôle, par exemple.

Ensuite, allez dans l'application Web ou l'application native Capgo, connectez-vous en tant qu'administrateur d'application, sélectionnez votre application, cliquez sur la liste des appareils.

Ensuite, insérez dans la barre de recherche l'ID de l'appareil, cliquez sur celui trouvé et puis cliquez sur le lien de la chaîne choisissez la development, demandez à votre collègue d'ouvrir l'application à nouveau, attendez 30 sec et ouvrez/fermez.

Vous devriez obtenir votre version.

Mode automatique

Cela peut être utile pour vos testeurs bêta, c'est plus long à mettre en œuvre.

Même chose que le mode manuel, vous devez obtenir l'ID de l'appareil

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

const deviceId = await CapacitorUpdater.getDeviceId()

Mais cette fois, vous devez l'envoyer automatiquement vers votre backend, je vous laisse décider comment vous le faites.

Je vous suggère simplement de le stocker dans une base de données, cela facilitera votre vie plus tard.

Ensuite, dans votre backend, vous devez l'envoyer également vers le backend Capgo. Voici deux exemples de code :

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)
}

Une fois cela configuré, essayez d'ajouter un bouton dans votre application pour vous abonner au canal, et vérifiez dans l'application web si cela a été configuré.

Vous pouvez également envoyer null pour supprimer la prise en charge

Si vous avez besoin de vérifier de manière programmée quelle prise en charge est définie sur un appareil, vous pouvez obtenir sur la même 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())

Continuez à partir de Comment envoyer une mise à jour spécifique à un utilisateur ou un groupe

Si vous utilisez Comment envoyer une mise à jour spécifique à un utilisateur ou un groupe pour planifier la routage du canal et la mise en production étape par étape, connectez-le à Canaux pour les détails d'implémentation dans Canaux, Canaux pour les détails d'implémentation dans Canaux, Canaux pour les détails d'implémentation dans Canaux, Solution de test bêta pour le flux de travail du produit dans Solution de test bêta, et Solution de ciblage de version pour le flux de travail du produit dans Solution de ciblage de version.