Sigue adelante desde Inicio

Instalación

Puedes utilizar nuestra configuración asistida por IA para instalar el complemento. Agrega las Capgo habilidades a tu herramienta de IA utilizando el siguiente comando:

npx skills add https://github.com/Cap-go/capgo-skills --skill capacitor-plugins

Luego utiliza el siguiente prompt:

Use the `capacitor-plugins` skill from `Cap-go/capgo-skills` to install the `@capgo/capacitor-updater` plugin in my project.

Si prefieres la configuración manual, instala el complemento ejecutando los siguientes comandos y sigue las instrucciones específicas de la plataforma a continuación:

npm

bun add @capgo/capacitor-updater
bunx cap sync

yarn

yarn add @capgo/capacitor-updater
bunx cap sync

pnpm

pnpm add @capgo/capacitor-updater
bunx cap sync

bun

bun add @capgo/capacitor-updater
bunx cap sync

Quick Start

Para la mayoría de los usuarios, recomendamos seguir la guía de inicio rápido principal which covers both the plugin installation and Capgo cloud integration.

integración de la nube __CAPGO_KEEP_0__.

Esta guía de inicio rápido se centra en los detalles técnicos del complemento para usuarios avanzados que desean comprender los mecanismos subyacentes o implementar actualizaciones autoadministradas.

The Capacitor Updater plugin enables over-the-air (OTA) updates for your Capacitor applications. This allows you to push updates to your app without going through app store reviews.

El complemento de actualización __CAPGO_KEEP_0__ permite actualizaciones en el aire (OTA) para sus aplicaciones __CAPGO_KEEP_1__. Esto le permite enviar actualizaciones a su aplicación sin pasar por las revisiones de las tiendas de aplicaciones.

1. Cómo Funciona (Capgo Builder / nube nativa de construcción de producto de página. Papel: Título de sección o página. Clave de mensaje `native_build_how_it_works_title` (Título de cómo funciona la construcción nativa). | Página/área: Sección de problemas/soluciones de la página de inicio. Papel: Etiqueta de UI corta o elemento de navegación. Visto en: página de soporte premium.astro. Clave de mensaje `ps_how_it_works` (Cómo funciona el soporte ps). | Página/área: Página de producto de actualizaciones en vivo. Papel: Título de sección o página. Visto en: página de actualización en vivo.astro. Clave de mensaje `live_update_how_it_works_title` (Título de cómo funciona la actualización en vivo). ): El plugin descarga paquetes de actualización (archivos ZIP que contienen tus activos web)
2. Extracción: Los paquetes se extraen al almacenamiento del dispositivo
3. Recarga caliente: La aplicación se cambia a el nuevo paquete sin requerir reiniciar
4. Fallo de seguridad: Si una actualización falla, la aplicación reversiona a la versión anterior que funcionaba

Modos de uso

1. Modo de actualización automática (Recomendado)

La forma más sencilla de usar el plugin con gestión de actualizaciones automática:

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

// Plugin handles everything automatically
// Configure in capacitor.config.ts

Agregar a tu capacitor.config.ts:

{
  plugins: {
    CapacitorUpdater: {
      autoUpdate: 'atBackground',
      updateUrl: 'https://your-update-server.com/api/updates'
    }
  }
}

2. Modo manual

Para un control avanzado sobre el proceso de actualización:

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

// Download an update
const bundle = await CapacitorUpdater.download({
  url: 'https://your-server.com/updates/v1.0.1.zip',
  version: '1.0.1'
});

// Set the bundle (will be used on next app start)
await CapacitorUpdater.set({
  id: bundle.id
});

// Or reload immediately
await CapacitorUpdater.reload();

Configuración de la plataforma

iOS

No se requiere ninguna configuración adicional. El plugin funciona de forma predeterminada.

Android

No se requiere ninguna configuración adicional. El plugin funciona de forma predeterminada.

Uso básico de API

Descargar una actualización

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

const bundle = await CapacitorUpdater.download({
  url: 'https://example.com/update.zip',
  version: '1.0.1'
});

console.log('Downloaded bundle:', bundle.id);

Establecer paquete activo

// Set bundle to be used on next app start
await CapacitorUpdater.set({
  id: bundle.id
});

Recargar con nuevo paquete

// Reload app immediately with new bundle
await CapacitorUpdater.reload();

Lista de Paquetes

const { bundles } = await CapacitorUpdater.list();
console.log('Available bundles:', bundles);

Eliminar un Paquete

await CapacitorUpdater.delete({
  id: 'bundle-id'
});

Obtener Paquete Actual

const { bundle } = await CapacitorUpdater.current();
console.log('Current bundle:', bundle.version);

Escuchadores de Eventos

Escuchar eventos de actualización:

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

// Listen for download progress
CapacitorUpdater.addListener('download', (info) => {
  console.log('Download progress:', info.percent);
});

// Listen for download completion
CapacitorUpdater.addListener('downloadComplete', (bundle) => {
  console.log('Download complete:', bundle.version);
});

// Listen for update failures
CapacitorUpdater.addListener('updateFailed', (error) => {
  console.error('Update failed:', error);
});

// Listen for successful updates
CapacitorUpdater.addListener('updateAvailable', (info) => {
  console.log('Update available:', info.version);
});

Opciones de configuración

Configurar el complemento en tu capacitor.config.ts:

{
  plugins: {
    CapacitorUpdater: {
      // Auto-update settings
      autoUpdate: 'atBackground',
      updateUrl: 'https://api.example.com/updates',

      // Update behavior
      resetWhenUpdate: true,

      // Version settings
      version: '1.0.0',

      // Security
      allowModifyUrl: false,

      // Stats collection
      statsUrl: 'https://api.example.com/stats',

      // Channel (for Capgo cloud)
      defaultChannel: 'production'
    }
  }
}

Patrones de integración

Con Capgo Cloud

La forma más sencilla de empezar:

// Install the Capgo CLI
bun add -g @capgo/cli

// Login to Capgo
npx @capgo/cli login

// Upload your first bundle
npx @capgo/cli bundle upload

// The plugin auto-updates from Capgo cloud

Ver el guía de inicio rápido principal para obtener más detalles.

Actualizaciones Autoalojadas

Alquila tu propio servidor de actualizaciones:

// Configure your update endpoint
{
  plugins: {
    CapacitorUpdater: {
      autoUpdate: 'atBackground',
      updateUrl: 'https://your-server.com/api/check-update'
    }
  }
}

Tu servidor debe devolver:

{
  "version": "1.0.1",
  "url": "https://your-server.com/updates/1.0.1.zip"
}

Ver Modo Autoalojado para obtener detalles completos.

Flujo de actualización manual

Control completo sobre las actualizaciones:

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

async function checkAndUpdate() {
  // Check for updates from your server
  const response = await fetch('https://api.example.com/check-update');
  const { version, url } = await response.json();

  // Download the update
  const bundle = await CapacitorUpdater.download({
    url,
    version
  });

  // Notify bundle is ready
  await CapacitorUpdater.notifyAppReady();

  // Set as next version
  await CapacitorUpdater.set({ id: bundle.id });

  // Reload when ready
  await CapacitorUpdater.reload();
}

Prácticas recomendadas

• Siempre llamar notifyAppReady() cuando su aplicación se carga con éxito
• Prueba las actualizaciones exhaustivamente antes de enviarlas a producción
• Implementar un manejo de errores adecuado para fallos de red
• Usar números de versión consistentemente
• Mantenga los tamaños de paquete pequeños para descargas más rápidas
• Monitorear las tasas de éxito de actualizaciones

Tardes siguientes

• Plugin API Reference Referencia del plugin API
• - Documentación completa de __CAPGO_KEEP_0__ Configuración del plugin
• - Todas las opciones de configuración Eventos
• - Actualizaciones disponibles Modo de alojamiento propio (self-hosted mode) - Ejecute su propio servidor de actualizaciones
• Desarrollo Local - Prueba actualizaciones localmente
• Depuración - Guía de depuración

Apoyo

• Sección titulada “Apoyo” Problemas conocidos
• GitHub Discussions __CAPGO_KEEP_0__ Discusiones
• - Apoyo de la comunidad Discord (Discord es un nombre de marca, no se traduce. El texto se traduce como: ‘Diálogo en tiempo real’) - Diálogo en tiempo real

Sigue adelante desde Inicio

Si estás utilizando Inicio para planificar el trabajo de plugin nativo, conecta con Usando @capgo/capacitor-actualizador para la capacidad nativa en Usando @capgo/capacitor-actualizador, Directorio de Plugins de Capgo para el flujo de trabajo del producto en Directorio de Plugins de Capgo, Plugins de Capacitor por Capgo para el detalle de implementación en Plugins de Capacitor por Capgo, Agregar o Actualizar Plugins para los detalles de implementación en la sección de Agregar o Actualizar Plugins, y Alternativas de Plugins de Ionic Enterprise para el flujo de trabajo del producto en Alternativas de Plugins de Ionic Enterprise.