Impostazioni

Per avere un controllo più fine-granulare sul sistema di aggiornamento, puoi configurarlo con queste impostazioni:

Suggerimento

Qualsiasi modifica a queste impostazioni nel file capacitor.config richiede la sincronizzazione della piattaforma e la rilascio sullo store per gli app di produzione che ne ricevano.

Nota

Avete bisogno di residenza dei dati dell'UE per Capgo Cloud? updateUrl Verso https://plugin.eu.capgo.app/updates, statsUrl Verso https://plugin.eu.capgo.app/stats, e channelUrl Verso https://plugin.eu.capgo.app/channel_self. Vedere Posizione dei dati.

allowModifyUrl

Consentite al plugin di modificare dinamicamente l'updateUrl, statsUrl e channelUrl dal lato JavaScript.

Disponibile su Android, iOS e Electron.

Predefinito: false

capacitor.config.json

{
  "plugins": {
    "CapacitorUpdater": {
      "allowModifyUrl": true
    }
  }
}

appId

Configura l'ID dell'app per l'app nella configurazione.

Sono disponibile su Android, iOS e Electron.

Predefinito: undefined

capacitor.config.json

{
  "plugins": {
    "CapacitorUpdater": {
      "appId": "com.example.app"
    }
  }
}

appReadyTimeout

Configura il numero di millisecondi che il plugin nativo dovrebbe attendere prima di considerare un aggiornamento ‘fallito’.

Sono disponibile su Android, iOS e Electron.

Predefinito: 10000 (10 secondi)

capacitor.config.json

{
  "plugins": {
    "CapacitorUpdater": {
      "appReadyTimeout": 1000
    }
  }
}

autoDeleteFailed

Configura se il plugin dovrebbe cancellare automaticamente i bundle falliti.

Disponibile su Android, iOS e Electron.

Predefinito: true

capacitor.config.json

{
  "plugins": {
    "CapacitorUpdater": {
      "autoDeleteFailed": false
    }
  }
}

autoDeletePrevious

Configura se il plugin dovrebbe cancellare automaticamente i bundle precedenti dopo un aggiornamento riuscito.

Disponibile su Android, iOS e Electron.

Predefinito: true

capacitor.config.json

{
  "plugins": {
    "CapacitorUpdater": {
      "autoDeletePrevious": false
    }
  }
}

autoSplashscreen

Tratta automaticamente la nascita dello schermo di benvenuto quando si utilizzano modalità di applicazione istantanea. Abilitato, il plugin nasconderà automaticamente lo schermo di benvenuto dopo l'applicazione degli aggiornamenti o quando non è necessario alcun aggiornamento. Questo elimina la necessità di ascoltare manualmente gli eventi appReady e di chiamare SplashScreen.hide(). Funziona solo quando autoUpdate è impostato su "atInstall", "onLaunch", o "always". Valori di legacy sono ancora supportati per la compatibilità con le versioni precedenti. Richiede l'installazione e la configurazione del plugin @__CAPGO_KEEP_0__/splash-screen con launchAutoHide impostato su false. Richiede l'aggiornamento automatico abilitato. directUpdate values are still supported for backward compatibility. Requires the @capacitor/splash-screen plugin to be installed and configured with launchAutoHide: false. Requires Auto Update to be enabled.

Predefinito:

__CAPGO_KEEP_0__.config.json false

capacitor.config.json

{
  "plugins": {
    "CapacitorUpdater": {
      "autoUpdate": "atInstall",
      "autoSplashscreen": true
    }
  }
}

autoUpdate

Configura come il plugin controlla le nuove versioni, le scarica e le applica. Il plugin controlla le nuove versioni quando l'app si muove in primo piano e su un timer ripetuto mentre l'app rimane aperta. periodCheckDelay Controlla l'intervallo di quel timer. I valori booleani sono ancora supportati per la compatibilità con le versioni precedenti: true è lo stesso di "atBackground" e false contexto: Pagina/Area: Sito web di marketing Capgo. Ruolo: Etichetta breve o elemento di navigazione. Visto in: pagina trust.astro. Chiave di messaggio `e` (E). "off"è lo stesso di

. I valori di stringa combinano la configurazione precedente di Auto Update e Direct Update.

• "off" Opzioni: falseo
• "atBackground" contexto: Frammento di testo HTML da una stringa di Capgo UI più lunga (chiave madre `alternatives_cta_questions`). Pagina/Area: Pagina di confronto delle alternative per l'aggiornamento live di Capacitor. Ruolo: Paragrafo di marketing o legale lungo. Visto in: pagina alternatives.astro. Preservare i termini di prodotto e marchio di Capgo e i termini dei developer esattamente. Chiave di messaggio `alternatives_cta_questions` (Domande per l'alternativa CTA). | Frammento di testo HTML da una stringa di Capgo UI più lunga (chiave madre `appflow_cta_questions`). Pagina/Area: Copia di marketing di confronto/migrazione per Appflow. Ruolo: Paragrafo di marketing o legale lungo. Visto in: pagina ionic-appflow.astro. Preservare i termini di prodotto e marchio di Capgo e i termini dei developer esattamente. Chiave di messaggio `appflow_cta_questions` (Domande per l'alternativa CTA Appflow). | Frammento di testo HTML da una stringa di Capgo UI più lunga (chiave madre `capwesome_cta_questions`). Pagina/Area: Pagina di confronto di Capawesome. Ruolo: Paragrafo di marketing o legale lungo. Visto in: pagina capwesome.astro. Preservare i termini di prodotto e marchio di Capgo e i termini dei developer esattamente. Chiave di messaggio `capwesome_cta_questions` (Domande per l'alternativa CTA Capwesome). | Frammento di testo HTML da una stringa di Capgo UI più lunga (chiave madre `consulting_faq_subtitle`). Pagina/Area: Pagina dei servizi di consulenza. Ruolo: Sottotitolo o didascalia di sezione. Visto in: pagina consulting.astro. Preservare i termini di prodotto e marchio di Capgo e i termini dei developer esattamente. Chiave di messaggio `consulting_faq_subtitle` (Sottotitolo FAQ per la consulenza). | Pagina/Area: Copia di marketing di confronto/migrazione per Appflow. Ruolo: Etichetta breve o elemento di navigazione. Visto in: pagina ionic-appflow.astro, pagina ionic-enterprise-plugins.astro, pagina solutions/ionic-enterprise-plugins.astro. Chiave di messaggio `appflow_plugins_or` (Appflow Plugins o). true: Disabilita le verifiche automatiche di aggiornamento. o, contexto: Frammento di testo HTML da una stringa di Capgo UI più lunga (chiave madre `alternatives_cta_questions`). Pagina/Area: Pagina di confronto delle alternative per l'aggiornamento live di Capacitor. Ruolo: Paragrafo di marketing o legale lungo. Visto in: pagina alternatives.astro. Preservare i termini di prodotto e marchio di Capgo e i termini dei developer esattamente. Chiave di messaggio `alternatives_cta_questions` (Domande per l'alternativa CTA). | Frammento di testo HTML da una stringa di Capgo UI più lunga (chiave madre `appflow_cta_questions`). Pagina/Area: Copia di marketing di confronto/migrazione per Appflow. Ruolo: Paragrafo di marketing o legale lungo. Visto in: pagina ionic-appflow.astro. Preservare i termini di prodotto e marchio di Capgo e i termini dei developer esattamente. Chiave di messaggio `appflow_cta_questions` (Domande per l'alternativa CTA Appflow). | Frammento di testo HTML da una stringa di Capgo UI più lunga (chiave madre `capwesome_cta_questions`). Pagina/Area: Pagina di confronto di Capawesome. Ruolo: Paragrafo di marketing o legale lungo. Visto in: pagina capwesome.astro. Preservare i termini di prodotto e marchio di Capgo e i termini dei developer esattamente. Chiave di messaggio `capwesome_cta_questions` (Domande per l'alternativa CTA Capwesome). | Frammento di testo HTML da una stringa di Capgo UI più lunga (chiave madre `consulting_faq_subtitle`). Pagina/Area: Pagina dei servizi di consulenza. Ruolo: Sottotitolo o didascalia di sezione. Visto in: pagina consulting.astro. Preservare i termini di prodotto e marchio di Capgo e i termini dei developer esattamente. Chiave di messaggio `consulting_faq_subtitle` (Sottotitolo FAQ per la consulenza). | Pagina/Area: Copia di marketing di confronto/migrazione per Appflow. Ruolo: Etichetta breve o elemento di navigazione. Visto in: pagina ionic-appflow.astro, pagina ionic-enterprise-plugins.astro, pagina solutions/ionic-enterprise-plugins.astro. Chiave di messaggio `appflow_plugins_or` (Appflow Plugins o).
• "atInstall": Applica immediatamente solo dopo un'installazione fresca o un aggiornamento dell'applicazione nativa; altrimenti utilizza "atBackground" comportamento
• "onLaunch": Applica immediatamente solo quando l'app viene riportata in primo piano da uno stato ucciso (avvio freddo). Dopo la prima verifica, ricade su "atBackground" comportamento
• "always": Controlla ogni transizione in primo piano e applica immediatamente quando è disponibile un aggiornamento
• "onlyDownload": Controlla e scarica automaticamente, emette updateAvailable, e non imposta mai il prossimo pacchetto o applica un aggiornamento automaticamente

Disponibile su Android, iOS e Electron.

Predefinito: "atBackground" (true è ancora accettato)

capacitor.config.json

{
  "plugins": {
    "CapacitorUpdater": {
      "autoUpdate": "onlyDownload"
    }
  }
}

channelUrl

Configura l'URL / endpoint per le operazioni di canale.

Disponibile su Android, iOS e Electron.

Predefinito: https://plugin.capgo.app/channel_self

capacitor.config.json

{
  "plugins": {
    "CapacitorUpdater": {
      "channelUrl": "https://example.com/api/channel"
    }
  }
}

defaultChannel

Imposta il canale predefinito per l'app nella configurazione. Sensitive alla maiuscola. Questa impostazione sovrascriverà il canale predefinito impostato nel cloud, ma rispetterà comunque le sovrascritture effettuate nel cloud.

Disponibile su Android, iOS e Electron.

Predefinito: undefined

capacitor.config.json

{
  "plugins": {
    "CapacitorUpdater": {
      "defaultChannel": "production"
    }
  }
}

directUpdate

Obsoleto. Utilizza autoUpdate modi di stringa invece: "atInstall", "onLaunch", o "always". Questa opzione rimane supportata per le app esistenti.

Opzioni:

• false: Mai eseguire aggiornamenti diretti
• 'atInstall': Lo stesso di autoUpdate: "atInstall"
• 'onLaunch': Lo stesso di autoUpdate: "onLaunch"
• 'always': Lo stesso di autoUpdate: "always"
• true: (obsoleto) Lo stesso di "always" per compatibilità con le versioni precedenti

Disponibile su Android, iOS e Electron.

Predefinito: false

capacitor.config.json

{
  "plugins": {
    "CapacitorUpdater": {
      "autoUpdate": "atInstall"
    }
  }
}

disableJSLogging

Disabilita la registrazione JavaScript del plugin. Se true, il plugin non registrerà nella console JavaScript. Sarà fatto solo il log nativo.

Disponibile su Android, iOS e Electron.

Predefinito: false

capacitor.config.json

{
  "plugins": {
    "CapacitorUpdater": {
      "disableJSLogging": true
    }
  }
}

keepUrlPathAfterReload

Configura il plugin per mantenere la URL del percorso dopo il ricarico.

Attenzione

Quando viene attivato il reload, ‘window.history’ verrà cancellato.

Disponibile su Android, iOS e Electron.

Predefinito: false

capacitor.config.json

{
  "plugins": {
    "CapacitorUpdater": {
      "keepUrlPathAfterReload": true
    }
  }
}

periodCheckDelay

Configura il periodo di attesa per il controllo delle aggiornamenti periodici. L'unità è in secondi. Non può essere inferiore a 600 secondi (10 minuti).

Disponibile su Android, iOS e Electron.

Predefinito: 600 (10 minuti)

capacitor.config.json

{
  "plugins": {
    "CapacitorUpdater": {
      "periodCheckDelay": 600 // (10 minutes)
    }
  }
}

publicKey

Configura la chiave pubblica per l'encryption end-to-end delle aggiornamenti in tempo reale Versione 2.

Disponibile su Android, iOS e Electron.

Predefinito: undefined

capacitor.config.json

{
  "plugins": {
    "CapacitorUpdater": {
      "publicKey": "YOUR_PUBLIC_KEY"
    }
  }
}

Attenzione

publicKey configura l'encryption V2 e deve corrispondere alla chiave privata utilizzata durante l'upload. Per gli aggiornamenti Delta, utilizzare l'encryption V2 con la crittografia parziale abilitata e abilitare la politica di bundle crittografato se la tua organizzazione richiede che ogni upload sia crittografato. Non affidarti solo a questa politica per prevenire la pubblicazione di un Delta non crittografato. publicKey __CAPGO_KEEP_0__.config.json

resetWhenUpdate

Elimina automaticamente i bundle precedentemente scaricati quando viene installato un bundle di app nativa più recente sul dispositivo.

Disponibile su Android, iOS e Electron.

Predefinito: true

capacitor.config.json

{
  "plugins": {
    "CapacitorUpdater": {
      "resetWhenUpdate": false
    }
  }
}

responseTimeout

Configura il numero di millisecondi che il plugin nativo dovrebbe attendere prima di considerare API come timeout.

Disponibile su Android, iOS e Electron.

Predefinito: 20 (20 secondi)

capacitor.config.json

{
  "plugins": {
    "CapacitorUpdater": {
      "responseTimeout": 10 // (10 seconds)
    }
  }
}

shakeMenu

Abilita il gesto di scuotimento per visualizzare il menu di aggiornamento ai fini di debug/test.

Disponibile su Android, iOS e Electron.

Predefinito: false

capacitor.config.json

{
  "plugins": {
    "CapacitorUpdater": {
      "shakeMenu": true
    }
  }
}

statsUrl

Configura l'URL/punto di accesso a cui vengono inviate le statistiche di aggiornamento.

Disponibile su Android, iOS e Electron. Impostalo su "" per disabilitare la registrazione esplicita delle statistiche tramite /stats.

Disabilitare statsUrl non disabilita tutti i dati di archiviazione del dispositivo Capgo. updateUrl rimane abilitato, /updates conserva ancora la riga di fatturazione MAU, l'inventario dei dispositivi e i dati degli eventi di aggiornamento necessari per servire gli aggiornamenti e conteggiare MAU. Vedi Compliance per la suddivisione dettagliata per campo.

Predefinito: https://plugin.capgo.app/stats

capacitor.config.json

{
  "plugins": {
    "CapacitorUpdater": {
      "statsUrl": "https://example.com/api/stats"
    }
  }
}

updateUrl

Configura l'URL/punto di accesso a cui vengono inviate le richieste di aggiornamento.

Disponibile su Android, iOS e Electron.

Predefinito: https://plugin.capgo.app/updates

capacitor.config.json

{
  "plugins": {
    "CapacitorUpdater": {
      "updateUrl": "https://example.com/api/auto_update"
    }
  }
}

version

Configura la versione corrente dell'app. Questa verrà utilizzata per la prima richiesta di aggiornamento. Se non impostata, il plugin otterrà la versione dal nativo code.

Disponibile su Android, iOS e Electron.

Predefinito: undefined

capacitor.config.json

{
  "plugins": {
    "CapacitorUpdater": {
      "version": "1.0.0"
    }
  }
}

Impostazioni di sviluppo

localApi

Configura il CLI per utilizzare un api locale per le prove.

Predefinito: undefined

capacitor.config.json

{
  "plugins": {
    "CapacitorUpdater": {
      "localApi": "http://localhost:54321/functions/v1"
    }
  }
}

localApiFiles

Configura il CLI per utilizzare un file locale api per le prove.

Predefinito: undefined

capacitor.config.json

{
  "plugins": {
    "CapacitorUpdater": {
      "localApiFiles": "http://localhost:54321/functions/v1/files"
    }
  }
}

localHost

Configura il CLI per utilizzare un server locale per le prove o per un server di aggiornamento auto-hosted.

Predefinito: undefined

capacitor.config.json

{
  "plugins": {
    "CapacitorUpdater": {
      "localHost": "http://localhost:5173"
    }
  }
}

localSupa

Configura il CLI per utilizzare un server locale per le prove o un server di aggiornamento auto-hosted.

Predefinito: undefined

capacitor.config.json

{
  "plugins": {
    "CapacitorUpdater": {
      "localSupa": "http://localhost:54321"
    }
  }
}

localSupaAnon

Configura il CLI per utilizzare un server locale per le prove.

Predefinito: undefined

capacitor.config.json

{
  "plugins": {
    "CapacitorUpdater": {
      "localSupaAnon": "YOUR_LOCAL_ANON_KEY"
    }
  }
}

localWebHost

Configura il CLI per utilizzare un server locale per le prove o un server di aggiornamento auto-hosted.

Predefinito: undefined

capacitor.config.json

{
  "plugins": {
    "CapacitorUpdater": {
      "localWebHost": "http://localhost:5173"
    }
  }
}

Suggerimento

E' disponibile ulteriori impostazioni nella Capgo app web che possono essere configurate per canale senza richiedere una rilascio di app nativa.

Continua da Impostazioni

Se stai utilizzando Impostazioni per pianificare il dashboard e le API operazioni, connettilo con Utilizzare @capgo/capacitor-aggiornatore per la capacità nativa in Utilizzare @capgo/capacitor-aggiornatore, API Panoramica per il dettaglio di implementazione in API Panoramica, Introduzione per il dettaglio di implementazione in Introduzione, API Chiavi per il dettaglio di implementazione in API Chiavi, e Dispositivi per il dettaglio di implementazione in Dispositivi.