Saltar al contenido

Dominio personalizado

Usa tu propio hostname, como updates.example.com, para las peticiones de Live Updates API de tu app, mientras Capgo sigue gestionando tus canales, bundles y rollouts.

Los dominios personalizados están disponibles en el plan Enterprise. Los admins de la organización pueden añadir un hostname de Live Updates API en la Console, publicar los registros DNS proporcionados y verificar su estado de activación.

  1. Abre la Console de Capgo y selecciona tu organización.
  2. Ve a Configuración → Organización → General y busca Dominio personalizado. Necesitas permiso para actualizar la configuración de la organización y un plan Enterprise activo para añadir un dominio.
  3. Introduce un nombre de host como updates.example.com, sin https://, ni una ruta ni un comodín.
  4. Haz clic Añadir dominio. La consola muestra los registros DNS a publicar y un Pendiente de verificación estado.

Puedes configurar un hostname de Live Updates API por organización. Debes poder editar sus registros DNS.

Si la Dominio personalizado opción no está disponible, contacta a tu responsable de soporte Enterprise o envía un correo a support@capgo.app con tu organización, los IDs de la app, el hostname deseado y el proveedor de DNS. También contacta con soporte antes de la configuración si necesitas región de residencia de datos específica o un hostname personalizado para las descargas de bundles.

En tu proveedor de DNS, añade los registros mostrados en la Consola o proporcionados por el soporte. Copia el tipo, el nombre y el valor del registro exactamente, incluyendo el CNAME y cualquier registro TXT de verificación de propiedad o certificado. Haz clic en un valor en la Consola para copiarlo. Si usas DNS de Cloudflare, mantén el CNAME solo DNS a menos que el soporte confirme una configuración diferente.

Usa el destino proporcionado en lugar de asumir que un CNAME a plugin.capgo.app es suficiente. Mantén los registros DNS en su lugar mientras el dominio esté en uso.

Una vez que el DNS se haya propagado, haz clic Actualizar estado. La consola muestra Activo solo cuando el nombre de host y su certificado HTTPS están activos; luego ofrece Copiar configuración del actualizador. Para una configuración asistida, pide a soporte que confirme la activación. También puedes inspeccionar DNS y verificar la conectividad TLS con:

Ventana de terminal
dig updates.example.com
curl -v https://updates.example.com/updates

Reemplazar updates.example.com con tu nombre de host aprovisionado. El curl comando verifica DNS, TLS y conectividad HTTP; una solicitud GET a /updates no es una comprobación de actualización válida y puede devolver un error API. Verifica el flujo de actualización real con una build de prueba nativa en el paso 4.

Una vez que el dominio esté activo, copia la configuración del updater desde la Console y combina las tres URLs en capacitor.config.ts. Para un hostname aprovisionado con las rutas estándar Capgo API, usa:

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;

Reemplaza las URLs de ejemplo por las URLs exactas que se muestran en la Console o que confirme soporte. Mantén los ajustes existentes de tu app y las demás opciones del plugin.

ConfiguraciónPropósito
updateUrlComprueba si hay un bundle disponible.
statsUrlReporta estadísticas de actualización.
channelUrlGestiona las operaciones de canal del dispositivo.

Sincroniza la configuración en tus proyectos nativos:

Ventana de terminal
npx cap sync

Compila e instala una versión nativa de prueba, luego:

  1. Sube un bundle de prueba a un canal de prueba usando tu flujo de trabajo normal de Capgo.
  2. Revisa los logs del dispositivo nativo para verificar que las solicitudes de actualización lleguen a tu hostname personalizado y que el bundle se descargue e instale correctamente.
  3. Confirma que las estadísticas de actualización aparezcan en la Console y prueba las operaciones del canal si tu app las usa.
  4. Lanza una nueva versión nativa de la app a través de tu proceso habitual de distribución en la tienda.

Las instalaciones nativas anteriores siguen usando sus URLs de endpoint configuradas hasta que los usuarios instalen la nueva versión nativa. El nombre de host predeterminado del updater es plugin.capgo.app, que Capgo gestiona. Si estás migrando desde otro nombre de host personalizado que controlas, mantén sus registros DNS y el servicio activos hasta que esos usuarios hayan migrado. Los canales, las subidas de bundles y los rollbacks siguen usando tu Capgo Console habitual y el flujo de trabajo de CLI.

Para eliminar un dominio, usa Eliminar dominio → Confirmar eliminación en la configuración de la organización. Primero, publica una versión nativa de la app usando endpoints de reemplazo y permite que los usuarios migren: las instalaciones anteriores perderán el acceso a través del nombre de host eliminado. Elimina el dominio antes de borrar su organización.

  • El DNS no resuelve: compara el nombre del registro y el destino con los valores proporcionados por soporte y verifica la propagación con tu proveedor de DNS.
  • HTTPS falla: Pide a soporte que verifique la activación del hostname y la provisión del certificado antes de publicar la build nativa.
  • Las solicitudes siguen usando plugin.capgo.app: confirma las tres URLs, ejecuta npx cap sync, reconstruye e instala la nueva versión nativa.
  • Las descargas de bundle usan otro hostname: la respuesta de la actualización proporciona la URL de descarga. Pregunta a soporte sobre la entrega personalizada de bundles o consulta Almacenamiento personalizado si quieres gestionar el almacenamiento de bundles tú mismo.
  • Updates fail despite valid HTTPS: comparte el ID de la app, el canal, la versión nativa, la marca de tiempo de la solicitud y los logs nativos con Soporte de Capgo.

Ver Configuración del actualizador para la referencia completa de configuración y Ubicación de datos para los requisitos de endpoints regionales.