Domaine personnalisé
Copiez un prompt de configuration incluant les étapes d'installation et le guide markdown complet pour ce plugin.
Utilisez votre propre nom de domaine, par exemple updates.example.com, pour les requêtes Live Update API de votre application, tandis que Capgo continue de gérer vos canaux, bundles et déploiements progressifs.
Les domaines personnalisés sont disponibles sur le plan Enterprise. Les administrateurs d’organisation peuvent ajouter un nom de domaine Live Update API dans la Console, publier les enregistrements DNS fournis et vérifier son statut d’activation.
1. Ajouter votre domaine personnalisé
Section intitulée « 1. Ajouter votre domaine personnalisé »- Ouvrez le Console Capgo et sélectionnez votre organisation.
- Accéder à Paramètres → Organisation → Général et trouvez Domaine personnalisé. Vous avez besoin de l'autorisation de modifier les paramètres de l'organisation et d'un plan Enterprise actif pour ajouter un domaine.
- Saisissez un nom d'hôte tel que
updates.example.com, sanshttps://, chemin ou joker. - Cliquez Ajouter un domaine. La Console affiche les enregistrements DNS à publier et un En attente de vérification statut.
Vous pouvez configurer un nom d'hôte Live Updates API par organisation. Vous devez pouvoir modifier ses enregistrements DNS.
Si l'option Domaine personnalisé n'est pas disponible, contactez votre interlocuteur support Enterprise ou envoyez un e-mail à support@capgo.app avec votre organisation, vos IDs d’app, 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 un hôte personnalisé pour les téléchargements de bundles.
2. Configurer le DNS et vérifier l'HTTPS
Section intitulée « 2. Configurer le DNS et vérifier l'HTTPS »Chez votre fournisseur DNS, ajoutez les enregistrements indiqués dans la Console ou fournis par le support. Copiez exactement le type, le nom et la valeur de l'enregistrement, y compris le CNAME et tous les enregistrements 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 suffit. 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 affiche Actif uniquement lorsque le nom d'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.comcurl -v https://updates.example.com/updatesRemplacer updates.example.com avec votre nom d'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
Section intitulée « 3. Configurer l’updater »Une fois le domaine actif, copiez la configuration du updater depuis la Console et fusionnez les trois URL dans capacitor.config.ts. Pour un hôte provisionné avec les chemins standard Capgo API, 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 existants et les autres options de plugin.
| Paramètre | Objectif |
|---|---|
updateUrl | Vérifie la présence d’un bundle disponible. |
statsUrl | Signale les statistiques de mise à jour. |
channelUrl | Gère les opérations de canal de l’appareil. |
4. Synchroniser, tester et publier
Section intitulée « 4. Synchroniser, tester et publier »Synchronisez la configuration dans vos projets natifs :
npx cap syncCompilez et installez une version de test native, puis :
- Envoyez un bundle de test sur un canal de test en utilisant votre workflow Capgo habituel.
- 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.
- Vérifiez que les statistiques de mise à jour s’affichent dans la Console et les opérations du canal de test, si votre application les utilise.
- Publiez une nouvelle version native de l’application via votre processus habituel de distribution sur les stores.
Les anciennes installations natives continuent d’utiliser leurs URL d’endpoint configurées jusqu’à ce que les utilisateurs installent la nouvelle version native. Le nom d’hôte par défaut de l’updater est plugin.capgo.app, géré par Capgo. Si vous migrez depuis un autre nom d’hôte personnalisé que vous contrôlez, conservez ses enregistrements DNS et son service actifs jusqu’à ce que ces utilisateurs aient migré. Les canaux, les envois de bundles et les rollbacks continuent d’utiliser votre console Capgo et votre workflow CLI habituels.
Troubleshooting
Section intitulée « Dépannage »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 des endpoints de remplacement et laissez le temps aux utilisateurs de migrer : les installations antérieures perdront l’accès via le nom d’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 du hostname et le provisionnement du certificat avant de publier le build natif.
- Les requêtes utilisent toujours
plugin.capgo.app: confirmez les trois URL, lanceznpx cap sync, reconstruisez et installez la nouvelle version native. - Le téléchargement des bundles 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.
- Échec des mises à jour malgré un HTTPS valide : 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.