Domaine personnalisé

Utilisez votre propre nom d'hôte, comme updates.example.com, pour les requêtes API de Live Update de votre application, tandis que Capgo continue de gérer vos canaux, bundles et déploiements progressifs.

Les domaines personnalisés sont disponibles avec le plan Enterprise. Les administrateurs d'organisation peuvent ajouter un nom d'hôte API pour Live Update dans la Console, publier les enregistrements DNS fournis et vérifier son statut d'activation.

1. Ajouter votre domaine personnalisé

1. Ouvrez le Console Capgo et sélectionnez votre organisation.
2. Accéder à Paramètres → Organisation → Général et recherchez Domaine personnaliséVous devez disposer des permissions pour modifier les paramètres de l'organisation et d'un plan Enterprise actif pour ajouter un domaine.
3. Saisissez un nom d'hôte tel que updates.example.com, sans https://, de chemin ou de wildcard.
4. Cliquez Ajouter le domaine. La Console affiche les enregistrements DNS à publier et un En attente de vérification statut.

Vous pouvez configurer un hôte API Live Updates par organisation. Vous devez pouvoir modifier ses enregistrements DNS.

Si l'option Domaine personnalisé n'est pas disponible, contactez votre contact support Enterprise ou envoyez un e-mail à support@capgo.app avec votre organisation, vos app IDs, l'hôte souhaité et votre fournisseur DNS. Contactez également le support avant la configuration si vous avez besoin d'un région de résidence des données spécifique ou d'un hôte personnalisé pour le téléchargement des bundles.

Attention

Un enregistrement DNS seul n'active pas un domaine personnalisé. Le routage et l'HTTPS doivent également être provisionnés. Attendez que la Console affiche Actif, ou le support confirme l'activation pour une configuration assistée, avant de modifier la configuration de production.

2. Configurer le DNS et vérifier l'HTTPS

Chez votre fournisseur DNS, ajoutez les enregistrements affichés dans la Console ou fournis par le support. Copiez exactement le type d'enregistrement, le nom et la valeur, y compris le CNAME et tout enregistrement TXT de vérification de propriété ou de certificat. Cliquez sur une valeur dans la Console pour la copier. Si vous utilisez le DNS Cloudflare, gardez le CNAME DNS uniquement sauf si le support confirme un paramètre différent.

Utilisez la cible fournie plutôt que de supposer qu'un CNAME vers plugin.capgo.app est suffisant. Conservez les enregistrements DNS en place tant que le domaine est utilisé.

Une fois la propagation DNS terminée, cliquez sur Actualiser le statut. La console l'affiche Actif uniquement lorsque l'hôte et son certificat HTTPS sont actifs ; elle propose alors Copier la configuration de l'updater. Pour une configuration assistée, demandez au support de confirmer l'activation. Vous pouvez aussi inspecter le DNS et vérifier la connectivité TLS avec :

dig updates.example.com
curl -v https://updates.example.com/updates

Remplacer updates.example.com avec votre hôte provisionné. La curl commande vérifie la connectivité DNS, TLS et HTTP ; une requête GET vers /updates n'est pas une vérification de mise à jour valide et peut retourner une erreur API. Vérifiez le flux de mise à jour réel avec un build natif de test à l'étape 4.

3. Configurer l'updater

Une fois le domaine actif, copiez la configuration de l'updater depuis la Console et fusionnez les trois URL dans capacitor.config.ts. Pour un hostname provisionné avec les chemins Capgo API standards, utilisez :

import type { CapacitorConfig } from '@capacitor/cli';

const config: CapacitorConfig = {
  appId: 'com.example.app',
  appName: 'My App',
  webDir: 'dist',
  plugins: {
    CapacitorUpdater: {
      autoUpdate: 'atBackground',
      updateUrl: 'https://updates.example.com/updates',
      statsUrl: 'https://updates.example.com/stats',
      channelUrl: 'https://updates.example.com/channel_self',
    },
  },
};

export default config;

Remplacez les URL d'exemple par les URL exactes affichées dans la Console ou confirmées par le support. Conservez vos paramètres d'application et autres options de plugins existants.

Paramètre	Objectif
updateUrl	Vérifie la disponibilité d'un bundle.
statsUrl	Affiche les statistiques de mise à jour.
channelUrl	Gère les opérations de canal de l'appareil.

Remarque

Ces paramètres modifient les endpoints de API. Le téléchargement des bundles utilise les URLs renvoyées par le serveur de mise à jour ; modifier ces paramètres ne permet donc pas automatiquement d'attribuer un domaine personnalisé au téléchargement des bundles. Vérifiez séparément les exigences relatives à l'hostname de téléchargement auprès du support.

4. Synchroniser, tester et publier

Synchronisez la configuration dans vos projets natifs :

npx cap sync

Compilez et installez une version de test native, puis :

1. Envoyez un bundle de test vers un canal de test en utilisant votre workflow Capgo habituel.
2. Consultez les logs de l'appareil natif pour vérifier que les requêtes de mise à jour atteignent votre hôte personnalisé et que le bundle est téléchargé et installé avec succès.
3. Confirmez que les statistiques de mise à jour s'affichent dans la Console et testez les opérations de canal si votre application les utilise.
4. Publiez une nouvelle version native de l'application via votre processus de distribution habituel sur les stores.

Attention

Changes to capacitor.config.ts nécessitent un build natif. L'envoi d'un bundle JS seul n'applique pas ces paramètres aux installations iOS et Android existantes. Les utilisateurs utiliseront le domaine personnalisé après avoir installé la nouvelle version native.

Les anciennes installations natives continuent d'utiliser leurs URL d'endpoint configurées jusqu'à ce que les utilisateurs installent la nouvelle version native. L'hôte par défaut de l'updater est plugin.capgo.app, que Capgo gère. Si vous migrez depuis un autre hôte personnalisé que vous contrôlez, conservez ses enregistrements DNS et son service actifs jusqu'à ce que ces utilisateurs aient migré. Les canaux, l'upload de bundles et les rollbacks continuent d'utiliser votre console Capgo et votre workflow CLI habituels.

Troubleshooting

Pour supprimer un domaine, utilisez Supprimer le domaine → Confirmer la suppression dans les paramètres de l'organisation. Publiez d'abord une version native de l'application utilisant les nouveaux points de terminaison et laissez les utilisateurs migrer : les anciennes installations perdront l'accès via l'hôte supprimé. Supprimez le domaine avant de supprimer son organisation.

• Le DNS ne se résout pas : vérifiez le nom de l'enregistrement et la cible par rapport aux valeurs fournies par le support, et vérifiez la propagation auprès de votre fournisseur DNS.
• L'HTTPS échoue : demandez au support de vérifier l'activation de l'hostname et le provisioning du certificat avant de publier le build natif.
• Les requêtes utilisent toujours plugin.capgo.app: confirmez les trois URL, lancez npx cap sync, reconstruisez et installez la nouvelle version native.
• Le téléchargement du bundle utilise un autre hostname : la réponse de la mise à jour fournit l'URL de téléchargement. Contactez le support pour la livraison de bundles personnalisés, ou consultez Stockage personnalisé si vous souhaitez gérer vous-même le stockage des bundles.
• Updates fail despite valid HTTPS: partagez l'ID de l'app, le canal, la version native, l'horodatage de la requête et les logs natifs avec le support Capgo.

Consultez Paramètres de l'updater pour la référence de configuration complète et Localisation des données for regional endpoint requirements.