Impostazioni

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

Suggerimento

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

Nota

È necessario la residenza dei dati dell'UE per Capgo Cloud? updateUrl Verso https://plugin.eu.capgo.app/updates, statsUrl Verso https://plugin.eu.capgo.app/statse channelUrl Verso https://plugin.eu.capgo.app/channel_self. Vedere Posizione dei dati.

allowModifyUrl

Consenti 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.

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’.

Disponibile su Android, iOS e Electron.

Predefinito: 10000 (10 secondi)

capacitor.config.json

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

autoDeleteFailed

Configura se il plugin dovrebbe eliminare automaticamente i pacchetti falliti.

Disponibile su Android, iOS e Electron.

Predefinito: true

capacitor.config.json

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

autoDeletePrevious

Configura se il plugin dovrebbe eliminare automaticamente i pacchetti precedenti dopo un aggiornamento riuscito.

Disponibile su Android, iOS e Electron.

Predefinito: true

capacitor.config.json

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

autoSplashscreen

Richiesto quando si utilizzano modalità di applicazione istantanea ("atInstall", "onLaunch", o "always"), compresa la versione obsoleta directUpdate Installare @capacitor/splash-screen e impostare launchAutoHide: false. Quando abilitato, il plugin nasconde la schermata di caricamento dopo le applicazioni degli aggiornamenti o quando non è necessario alcun aggiornamento. Ciò elimina la necessità di ascoltare manualmente gli eventi appReady e di chiamare SplashScreen.hide().

Disponibile su Android e iOS.

Impostazione predefinita: false

capacitor.config.json

{
  "plugins": {
    "CapacitorUpdater": {
      "autoUpdate": "atInstall",
      "autoSplashscreen": true
    },
    "SplashScreen": {
      "launchAutoHide": false
    }
  }
}

autoUpdate

Configura come il plugin controlla le aggiornamenti in tempo reale, scarica e applica gli aggiornamenti. Il plugin controlla le aggiornamenti quando l'app si sposta 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 il passato: 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 degli Aggiornamenti Automatici e degli Aggiornamenti Diretti.

• "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 gli aggiornamenti in tempo reale 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 le alternative CTA). | Frammento di testo HTML da una stringa di Capgo UI più lunga (chiave madre `appflow_cta_questions`). Pagina/Area: Copia di marketing per la migrazione di 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 la CTA di 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 la CTA di Capawesome). | 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 della 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 delle domande frequenti per la consulenza). | Pagina/Area: Copia di marketing per la migrazione di 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: Verifica e scarica automaticamente ogni volta che si esegue il controllo in primo piano, quindi applica l'aggiornamento la prossima volta che l'app si sposta in background
• "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 il primo controllo, ricade su "atBackground" comportamento
• "always": Verifica ogni volta che si passa da un stato di primo piano a uno di sfondo e applica immediatamente ogni volta che è disponibile un aggiornamento
• "onlyDownload": Verifica automaticamente e scarica, emette updateAvailable, e non impostare mai il prossimo pacchetto o applicare un aggiornamento automaticamente

Modalità di applicazione immediata ("atInstall", "onLaunch", "always") si applicano mentre l'utente attende. Carica con npx @capgo/cli@latest bundle upload --delta così solo i file modificati si scaricano. Un caricamento zip completo rallenta l'esperienza dell'utente. Su Android e iOS queste modalità richiedono autoSplashscreen: true e @capacitor/splash-screen con launchAutoHide: false.

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 al caso. 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 Questa opzione rimane supportata per le app esistenti. L'aggiornamento istantaneo dovrebbe essere caricato con "always"così da non rallentare l'esperienza dell'utente. Questi modi richiedono --delta string modes autoSplashscreen: true E e @capacitor/splash-screen con launchAutoHide: false.

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: (deprecated) Lo stesso di "always" : Per compatibilità con il passato

E disponibile su Android, iOS e Electron.

Predefinito: false

capacitor.config.json

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

disableJSLogging

Disabilita il logging JavaScript del plugin. Se vero, il plugin non loggerà nella console JavaScript. Sarà fatto solo il logging nativo.

Disponibile su Android, iOS e Electron.

Predefinito: false

capacitor.config.json

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

keepUrlPathAfterReload

Configura il plugin per mantenere la path URL dopo una ricarica.

Attenzione

Quando viene attivata una ricarica, ‘window.history’ verrà resettato.

Disponibile su Android, iOS e Electron.

Predefinito: false

capacitor.config.json

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

periodCheckDelay

Configura il periodo di ritardo 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 in tempo reale fine a fine con aggiornamenti live 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, utilizza l'encryption V2 con l'abilitazione della crittografia parziale e abilita l'enforcement del pacchetto crittografato se la tua organizzazione richiede che ogni upload sia crittografato. Non affidarti solo a questo come politica server-side per prevenire la pubblicazione di un Delta non crittografato. publicKey Sezione intitolata “resetWhenUpdate”

resetWhenUpdate

Disponibile su Android, iOS e Electron.

Available on Android, iOS and 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 / endpoint a cui vengono inviate le statistiche degli aggiornamenti.

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

Disabilitare statsUrl Non disabilita tutti i dati di archiviazione del dispositivo Capgo. Se updateUrl rimane abilitato, /updates continua a memorizzare la riga di fatturazione MAU, l'inventario dei dispositivi e i dati degli eventi di decisione degli aggiornamenti necessari per servire gli aggiornamenti e conteggiare MAU. Vedi Compliance per la suddivisione a livello di campo.

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

capacitor.config.json

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

updateUrl

Configura l'URL / endpoint 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 viene impostata, il plugin otterrà la versione dal code nativo.

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.

Default: 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 un server di aggiornamento auto-hostato.

Default: 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-hostato.

Default: 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 self-hosted.

Predefinito: undefined

capacitor.config.json

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

Suggerimenti

Ci sono ulteriori impostazioni disponibili nella Capgo app web che possono essere configurate per canale senza richiedere una rilascio dell'app nativa.

Continua da Impostazioni

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