FAQ
Copia un prompt di configurazione con i passaggi di installazione e la guida markdown completa per questo plugin.
Se hai domande non risposte qui, per favore chiedi! Entrambi aprire un problema o chiedere su Discord work.
Cosa è “code push”?
Sezione intitolata “Cosa è “code push”?”Il “Code push”, noto anche come “aggiornamenti over-the-air” (OTA), è un servizio cloud che consente ai sviluppatori di Capacitor di distribuire aggiornamenti ai loro app in produzione. Attualmente Capgo funziona su Android, iOS e Electron.
Il “Code Push” è un riferimento al nome di una funzione di distribuzione utilizzata dalla community di React Native da Microsoft e ExpoNessuno dei due, che non supportano Capacitor.
Do Capgo CLI majors need to match my plugin or Capacitor version?
I Capgo CLI devono corrispondere alla mia estensione o alla versione di Capacitor?No. Always use the latest Capgo CLI (npx @capgo/cli@latest. I Console CLI e Capgo seguono la propria versione e rimangono compatibili con qualsiasi plugin di aggiornamento maggiore supportato. I plugin Capgo seguono i maggiori Capacitor; vedere versioning Capgo per le etichette LTS come @lts-v7.
Qual è la differenza tra un bundle e una release?
Sottosezione intitolata “Qual è la differenza tra un bundle e una release?”Utilizziamo il termine “release” per indicare la preparazione di un binario per le store di app. Per poter generare successivamente un bundle Capgo è necessario conoscere il binario esatto che è stato inviato alle store di app.
Utilizziamo il termine “bundle” per indicare un patch che può essere applicato a una release per aggiornarla a nuove code. Il npx @capgo/cli@latest bundle upload è utilizzato per generare un bundle dal tuo nuovo code locale, che viene poi inviato ai tuoi utenti.
Are there Delta update file-path limitations?
Sono presenti limitazioni per i percorsi dei file di aggiornamento Delta?Yes:
- File di dimensione zero: Il registro dei CLI
Ignoring empty file...e esclude i file vuoti dai file del delta. Non interrompe l'upload, quindi un file vuoto può modificare il bundle risultante senza fermare la tua distribuzione. Non includere i file di dimensione zero nelle percorso dei bundle Delta. - Percorsi con spazi: Gli upload del delta falliscono presto con un chiaro errore quando un percorso del bundle contiene uno spazio. Rinomina i file o le directory per eliminare gli spazi prima di caricare un aggiornamento Delta.
Vedi Aggiornamenti del delta per i dettagli di configurazione.
Cos'è il piano di sviluppo?
Sezione intitolata “Cos'è il piano di sviluppo?”I nostri board di progetto sono anche pubblici e si trovano a: https://github.com/orgs/Cap-go/progetti
Il nostro team opera anche in modo pubblico, quindi potete vedere cosa stiamo facendo in qualsiasi momento. Siamo felici di rispondere a qualsiasi domanda che avete sulla nostra roadmap o priorità via Github issues o Discord.
Posso utilizzare Capgo con il mio team?
Posso utilizzare Capgo con il mio team?Sì! Tutti i piani supportano un numero illimitato di sviluppatori. Limitiamo solo le metriche dell'app (MAU, archiviazione e banda) per ogni organizzazione.
Teams Teams Il __CAPGO_KEEP_0__ conserva il mio codice __CAPGO_KEEP_1__?
Does Capgo conservare il mio code originale?
Sezione intitolata “Quale Capgo conserva il mio code di origine?”No. I server di Capgo non vedono mai il tuo code di origine. Quando esegui npx @capgo/cli@latest bundle upload, Capgo conserva un file zip del code minificato/compilato - lo stesso code che un browser riceverebbe, non il tuo code di origine.
Per ulteriori informazioni sulla sicurezza, hai due opzioni:
- Chiaro da Fine a Fine: Cifra il tuo bundle prima di caricarlo per proteggerlo in archiviazione e in transito e per impedire a terze parti di generare aggiornamenti crittografati validi senza la tua chiave privata. Ciò non rende impossibile per gli ingegneri web reversare gli asset distribuiti perché la chiave pubblica è presente nell'applicazione distribuita.
- Caricamento di URL Esterno: Conserva il bundle sul tuo server e fornisce a Capgo solo il collegamento di download con l'opzione
--external <url>
Vedi anche la nostra politica sulla privacy: https://capgo.app/privacy
Sono i file del bundle dati privati?
Sottosezione intitolata “Sono i file del bundle dati privati?”No. I file del bundle sono asset web pubblici destinati a essere scaricati dagli utenti del tuo app. Chiunque conosca l'URL del bundle può estrarre quei file, e Capgo informa gli utenti di ciò durante la configurazione e nella documentazione.
Access to bundle files is not considered a data breach. Do not put secrets, credentials, personal data, or regulated data in your app bundle. If you need stronger confidentiality for high-security use cases, use end-to-end encryption, but still treat shipped app code and assets as public from a security-reporting perspective.
Posso utilizzare Capgo dal mio sistema CI?
Posso utilizzare Capgo dal mio sistema di integrazione continua?Sì. Capgo è destinato a essere utilizzato dai sistemi di integrazione continua. Abbiamo pubblicato una guida per Android e Github Actions e iOS, e per GitLab. Altri sistemi CI dovrebbero essere simili.
Per favore, non esitare a contattarci per GitHub o Discord se incontrate problemi.
Come si relaziona a Firebase Remote Config o Launch Darkly?
Sottosezione intitolata “Come si relaziona a Firebase Remote Config o Launch Darkly?”Code push consente di aggiungere nuovi code / sostituire code sul dispositivo. Firebase Remote Config e Launch Darkly sono entrambi sistemi di configurazione. Consentono di modificare la configurazione dell'app senza dover inviare una nuova versione. Non sono destinati a sostituire code.
Quanto grande è l'impronta di dipendenza che aggiunge?
Sottosezione intitolata “Quanto grande è l'impronta di dipendenza che aggiunge?”Non ho misurato di recente, ma mi aspetto che la libreria code push aggiunga meno di un megabyte agli app Capacitor. Sappiamo come ridurlo quando diventa una priorità. Se il peso è un blocco per te, per favore, fammelo sapere!
Funziona Capgo sul simulatore iOS 18.4?
Titolo della sezione “Funziona Capgo sul simulatore iOS 18.4?”No. A causa di un problema upstream che colpisce il simulatore iOS 18.4, Capgo non funziona in modo affidabile lì. Per favore, testa su un dispositivo reale o utilizza una versione diversa del simulatore iOS.
Vedi i dettagli nell'issue React Native: facebook/react-native#50510
Funziona code push con applicazioni grandi?
Titolo della sezione “Funziona code push con applicazioni grandi?”Sì. Non esiste un limite di dimensione per l'applicazione che può essere aggiornata con code push. Come notato di seguito, Capgo può modificare qualsiasi code JS nella tua applicazione, indipendentemente dalle dimensioni.
Da notare: una dimensione più grande rende più difficile per gli utenti scaricare gli aggiornamenti. Consigliamo di mantenere il tuo app il più piccolo possibile.
Cosa posso utilizzare Capgo code per inviare?
Sezione intitolata “Cosa posso utilizzare Capgo code per inviare?”Abbiamo visto una varietà di utilizzi, tra cui:
- Riparazioni di emergenza per le app in produzione.
- Invio di correzioni di bug ai utenti con versioni più vecchie del tuo app.
- Invio costante (ad esempio ogni ora).
Nota che la maggior parte delle librerie di app non consente lo shipping di code che modifica in modo significativo il comportamento dell'app. Vedi di seguito Cosa conta come un ‘MAU’ per __CAPGO_KEEP_0__?
Quali utenti contano come "MAU" per Capgo?
Sezione intitolata “Cosa si considera un “MAU” per Capgo?”Un MAU è un dispositivo attivo mensile. Un dispositivo distinto che contatta Capgo durante un periodo di 30 giorni rullante conta come un MAU per quel ID di app nativa. Lo stesso dispositivo fisico utilizzato con due ID di app nativa distinti conta una volta per ogni ID; non viene deduplicato tra di loro.
Se i tuoi gusti differiscono solo nella loro layer web o routing di aggiornamento, utilizza un ID di app nativa con canali. Ciò mantiene i gusti sotto un'app Capgo e rende le rilasci più semplici. Utilizza ID di app nativa separati quando un gusto necessita di un ID di pacchetto distintivo, identità di firma, set di autorizzazioni o elenco di negozio.
Su iOS, v7.25.0+ mantiene l'ID di dispositivo casuale, app-scopico attraverso reinstalli normali utilizzando Keychain. Su Android, utilizza v7.50.1+ o v5.50.1+ e v6.50.1+ Per le linee di rilascio indicati); l'ID viene ripristinato solo quando Android Backup/Restore conserva le preferenze dell'app. Disabilitando il backup, escludendo quelle preferenze o cancellando i dati dell'app genera un nuovo ID dispositivo. Aggiornando l'app non si crea un nuovo ID dispositivo.
Per i build di test e sviluppo, disabilitare la consegna dei build di sviluppo e della consegna dell'emulatore sui canali di produzione. Ciò controlla la consegna, non il MAU: un dispositivo può ancora essere contato quando contatta Capgo. Per tenerlo fuori dall'utilizzo di produzione, disabilitare gli aggiornamenti in tempo reale e non chiamare i punti di fine Capgo. Vedere Test Native Builds Senza Aggiornamenti in Tempo Reale per le impostazioni precise.
Cosa non possiamo utilizzare Capgo code push?
Sottosezione intitolata “Cosa non possiamo utilizzare Capgo code push?”Capgo non può modificare le code native come Java, Kotlin, Objective-C, Swift, plugin nativi o configurazione nativa. Queste modifiche richiedono un nuovo rilascio di app nativa. Per lo scopo di revisione della store, vedere Politiche di App Store e Google Play.
Posso aggiornare capacitor.config.ts tramite Capgo?
Se posso aggiornare capacitor.config.ts modifiche tramite Capgo?No. Regola breve: Capgo può inviare la cartella di output del build web generato, inclusi HTML, CSS, JavaScript, risorse e modifiche ai pacchetti JavaScript puri raccolte in quel output. Le modifiche a capacitor.config.ts, configurazione di plugin nativi, installazioni o aggiornamenti di pacchetti nativi, e qualsiasi cosa richieda l'aggiornamento del progetto iOS o Android attraverso npx cap sync o npx cap copy richiedono una rilascio nativa dell'app.
La cartella di configurazione Capacitor viene letta al tempo di build nativo e compilata nel binario dell'app nativa. Se hai bisogno di modificare la configurazione Capacitor, devi:
- Aggiornare
capacitor.config.tslocalmente - Ricompilare l'app nativa (
npx cap syncseguito da un build nativo) - Inviare il nuovo binario ai negozi di app
La Capgo invia automaticamente i binari ai negozi di app?
Sezione intitolata “Cosa Capgo invia alle store per me?”Capgo Build può compilare e firmare un progetto nativo iOS o Android preparato e, quando configurato, inviare il risultato firmato a App Store Connect o Google Play. Puoi mantenere il tuo CI esistente per le dipendenze private, le build web, la sincronizzazione Capacitor e la preparazione nativa personalizzata; Capgo riceve il progetto nativo preparato per lo step di build nativo.
Vedi Capgo Build e la riferimento alla configurazione di build per le opzioni del workflow e della sottoscrizione alle store.
Cosa Capgo salva su disco e dove?
Sezione intitolata “Cosa Capgo salva su disco e dove?”Il Capgo updater (incluso nel tuo'applicazione quando costruisci l'app) memorizza il bundle più recente scaricato nella sola directory che capacitor consente di caricare code. Su Android, si trova in /data/user/0/com.example.app/code_cache/capgo_updater Anche se la base di quel percorso è fornita dal sistema Android e può cambiare dinamicamente durante l'esecuzione. Su dispositivi iOS, i dati sono memorizzati sotto Library/Application Support/capgo.
Il comando di riga Capgo (ad esempio npx @capgo/cli@latest bundle upload) è installato su disco nei cache npm, i tuoi accessi sono memorizzati nella directory home ~/.capgo.
Come si relaziona a Capacitor Hot Reload?
Sottosezione intitolata “Come si relaziona a Capacitor Hot Reload?”La Hot reload di Capacitor è una funzionalità disponibile solo durante lo sviluppo. Code push è per la produzione.
La Hot reload è una funzionalità di Capacitor che ti consente di modificare code sul dispositivo durante lo sviluppo. Richiede la creazione dell'app Capacitor con un proxy per connettersi alla tua macchina locale.
Code push è una funzionalità che ti consente di modificare code sul dispositivo in produzione. Utilizzeremo una varietà di tecniche diverse per rendere possibile ciò a seconda della piattaforma.
Quali tipi di modifiche supporta Capgo code push?
Sottosezione intitolata “Quali tipi di modifiche supporta Capgo code push?”Capgo può modificare qualsiasi JS code del tuo'applicazione. Ciò include le code dell'app e i code generati. Puoi anche aggiornare le dipendenze in package.json Quanto a lungo possono essere i code?
Non abbiamo piani per supportare la modifica di code nativi (ad esempio Java/Kotlin su Android o Objective-C/Swift su iOS), e lo strumento vi avviserà se rileva che avete modificato code nativi, poiché non saranno inclusi nel pacchetto.
Sostiene il Web?
Sottotitolo “Supporta questo il web?”Code push non è necessario per il Web, poiché il Web funziona già in questo modo. Quando un utente apre un'app Web, scarica la versione più recente dal server se necessario.
Se hai un caso d'uso per code push con il Web, ci piacerebbe saperlo!
Sarà compatibile con iOS, Android, Mac, Windows, Linux, ecc.?
Sarà compatibile con iOS, Android, Mac, Windows, Linux, ecc.?Sì.
Fino ad ora ci siamo concentrati su Android, iOS e Electron, e il code è pronto per la produzione su tutti e tre.
Quali versioni di sistema operativo supporta Capgo?
Sottosezione intitolata “Quali versioni di sistema operativo supporta Capgo?”Capgo supporta le stesse versioni di Android che Capacitor supporta.
Capacitor supporta attualmente Android API livello 22+ e iOS 13.0+: https://capacitorjs.com/docs/main/reference/support-policy
Quali versioni di Capacitor supporta Capgo?
Sottosezione intitolata “Quali versioni di Capacitor supporta Capgo?”Capgo supporta attualmente solo rilasci stabili recenti di Capacitor. Potremmo supportare anche versioni più vecchie di Capacitor, ma non abbiamo ancora sviluppato l'infrastruttura necessaria per mantenere tali versioni nel tempo. Intendiamo supportare più versioni di Capacitor in futuro, comprese quelle per i nostri clienti aziendali. https://github.com/Cap-go/capgo/issues/1100
Capgo segue Capacitor stabile e aggiorna generalmente entro poche ore di qualsiasi rilascio stabile. Il nostro sistema per eseguire queste aggiornamenti è automatizzato e richiede pochi minuti per essere eseguito. Eseguiamo poi un ulteriore passaggio di verifica manuale prima di pubblicare sui nostri server.
Come si relaziona questo al processo di valutazione o alle politiche dell'App/Play Store?
Sezione intitolata “Come si relaziona questo al processo di valutazione o alle politiche dell'App/Play Store?”Capgo invia aggiornamenti solo alla layer web Capacitor: l'HTML, il CSS, il JavaScript e gli asset già in esecuzione nella WebView dell'app. Non modifica il binario nativo, i plugin nativi, le autorizzazioni, le entità, la firma o i metadati della store.
Utilizza un rilascio della store nativa per ogni cambiamento nativo e per i cambiamenti materiali che potrebbero influire sulla funzionalità o sullo scopo dell'app. Mantieni gli aggiornamenti live all'interno dell'esperienza dell'app che hai sottoposto e discusso con gli utenti.
Capgo garantisce l'approvazione dell'App Store o di Google Play?
Sezione intitolata “Capgo garantisce l'approvazione dell'App Store o di Google Play?”No. Apple e Google valutano ogni app e rilascio in base ai propri fatti, e Capgo non può garantire un esito di approvazione o di valutazione individuale. Il tuo team rimane responsabile per il contenuto dell'app, le dichiarazioni, lo scope degli aggiornamenti e la conformità alle politiche della store attuali.
Per la pianificazione di valutazione e rilascio, leggi le politiche ufficiali direttamente: Linee guida di revisione dell'App Store di Apple e Politica di abuso di dispositivi e reti di Google Play.
Posso utilizzare Capgo nel mio paese?
Sezione intitolata “Posso utilizzare Capgo nel mio paese?”Non abbiamo tentato di limitare l'accesso a Capgo da nessun paese.
Riconosciamo che alcuni paesi hanno restrizioni sulle URL che possono essere accessibili dal paese. Capgo utilizza attualmente Cloudflare Cloud per l'hosting, compresi R2 Storage e Cloudflare workers.
Le seguenti URL sono utilizzate da Capgo:
- https://api.capgo.app — utilizzato dai
npx @capgo/clistrumenti di linea di comando per interagire con i server di Capgo nonché l'aggiornatore Capgo sulle dispositivi degli utenti per verificare gli aggiornamenti. - https://*.r2.cloudflare.com utilizzato dal
npx @capgo/clistrumento di riga di comando per caricare e scaricare il pacchetto
Se tutti questi URL sono accessibili dal tuo paese, allora Capgo dovrebbe funzionare.
Se la tua regione richiede di bloccare l'accesso a qualsiasi di questi URL, ti preghiamo di informarci e possiamo lavorare con te per trovare una soluzione. I server proxy sono una delle opzioni.
Posso ospitare Capgo da solo?
Scheda intitolata “Posso ospitare Capgo da solo?”Sì. Enterprise supporta le licenze per l'ospitazione autonoma di Capgo quando hai bisogno di eseguire il backend dell'aggiornatore nella tua infrastruttura. Vedi Aggiornatore Auto-ospitato per il modello di distribuzione e gli endpoint.
Richiede code di spingere la connessione internet per funzionare?
Sezione intitolata “Fa il code push bisogno di internet per funzionare?”Sì. Si potrebbe immaginare di eseguire un server per distribuire gli aggiornamenti separatamente dalla rete internet generale, ma è necessaria una forma di connettività di rete per trasportare gli aggiornamenti ai dispositivi.
Come è influenzato il Capgo dalla mancanza di connettività di rete?
Sezione intitolata “Come è influenzato il Capgo dalla mancanza di connettività di rete?”L'aggiornatore Capgo (incluso nella tua applicazione quando costruisci l'app con Capgo) è progettato per essere resiliente ai problemi di connettività di rete.
Nel comportamento di aggiornamento predefinito, quando l'applicazione si avvia avverte l'aggiornatore Capgo, che avvia un thread separato per effettuare una richiesta di rete ai server di Capgo e chiedere un aggiornamento. Intenzionalmente utilizziamo un thread separato per evitare di influenzare qualsiasi altra cosa l'applicazione possa essere facendo. Se la richiesta di rete fallisce o scade, l'aggiornatore semplicemente cercherà di controllare nuovamente la prossima volta che l'applicazione si avvia.
Gli strumenti di riga di comando Capgo (ad es. npx @capgo/cli@latest bundle uploadrichiedono la connettività di rete per funzionare. Se stai utilizzando Capgo per distribuire la tua app, assicurati che il tuo sistema CI abbia la connettività di rete.
Cosa succede se un utente non aggiorna per molto tempo e perde un aggiornamento?
Sezione intitolata “Cosa succede se un utente non aggiorna per molto tempo e perde un aggiornamento?”La nostra implementazione invia sempre un aggiornamento specificamente tailleggiato per il dispositivo che lo richiede, aggiornando sempre il richiedente alla versione più recente disponibile. Quindi se un utente non aggiorna per un po' di tempo perderà gli aggiornamenti intermedi.
Il server di aggiornamento potrebbe essere modificato per supportare la risposta con la versione incrementale successiva o la versione più recente a seconda delle esigenze del tuo'applicazione. Ci faccia sapere se comportamenti di aggiornamento alternativi sono importanti per te.
Come si relaziona Capgo a Capacitor?
Sezione intitolata “Come si relaziona Capgo a Capacitor?”Capgo è un plugin per Capacitor che aggiunge il push code. Capgo non è una sostituzione per Capacitor. Puoi continuare ad utilizzare gli strumenti Capacitor che già conosci e ami.
Seguiamo la versione stabile più recente di Capacitor e aggiorniamo il nostro plugin di push code per farlo funzionare con essa.
Quando avvengono gli aggiornamenti?
Sezione intitolata “Quando avvengono gli aggiornamenti?”Di default, l'aggiornatore Capgo controlla gli aggiornamenti all'avvio dell'app. Esegue il lavoro su un thread di background e non blocca il thread della UI. Gli aggiornamenti saranno installati mentre l'utente utilizza l'app e verranno applicati la prossima volta che l'app viene riavviata.
It è anche possibile eseguire manualmente l'aggiornatore Capgo utilizzando il @capgo/capacitor-updater il pacchetto, attraverso cui è possibile attivare gli aggiornamenti in qualsiasi momento, incluso tramite una notifica push.
L'aggiornatore Capgo è progettato in modo tale che quando la rete non è disponibile, o il server è down o non raggiungibile, l'app continuerà a funzionare normalmente. Se dovessi mai scegliere di eliminare un aggiornamento dai nostri server, tutti i tuoi client continueranno a funzionare normalmente.
Abbiamo aggiunto la possibilità di annullare le patch. La cosa più semplice è semplicemente attaccare un bundle precedente al tuo canale per annullare.
Devo mantenere il mio app_id segreto?
Sottosezione intitolata “Devo mantenere il mio app_id segreto?”No. Il app_id è incluso nella tua app e è sicuro essere pubblico. Puoi verificarlo nel controllo delle versioni (anche pubblicamente) e non preoccuparti che qualcuno lo acceda.
Qualcuno che ha il tuo app_id può estrarre la versione più recente della tua app dai server Capgo, ma non può inviare aggiornamenti alla tua app o accedere ad alcun altro aspetto della tua Capgo account.
Cosa viene inviato ai server Capgo?
Sezione intitolata “Quali informazioni vengono inviate ai server di Capgo?”L'inventario completo dei dati, il comportamento degli endpoint e i controlli sulla privacy sono documentati in Compliance.
Set statsUrl: '' Per disabilitare i rapporti statistici di aggiornamento espliciti. Puoi anche inviare statsUrl ad un proxy o a un endpoint che controlli; vedi gestione delle statistiche nell'infrastruttura auto-hosted. Update checks still need an app-scoped device identifier so Capgo can select the correct update and measure monthly active devices.
La lista dei sottoprocessori E' la nostra fonte pubblica aggiornata per i fornitori, le aree di elaborazione, i meccanismi di trasferimento e la storia delle modifiche.
Can I use Capgo for HIPAA-sensitive apps?
Sezione intitolata “Posso utilizzare Capgo per applicazioni sensibili ai dati HIPAA?”Sì, ma il tuo proprietario della conformità deve scegliere il modello di distribuzione giusto. Capgo Cloud non è attualmente presentato come un elaboratore di statistiche ospitato HIPAA-compliant. Di default, i dati dell'aggiornatore sono scritti su dispositivo e non sono legati a un utente dell'applicazione conosciuto, e molte squadre utilizzano quel modello con successo.
Per revisioni più severe, puoi geo-localizzare il traffico dei plugin, disabilitare le statistiche impostando statsUrl a una stringa vuota, ospita solo l'endpoint delle statistiche o utilizza l'hosting autorizzato. Non chiamare CapacitorUpdater.setCustomId(...) con un indirizzo e-mail, ID utente, ID paziente, ID dipendente o qualsiasi valore che mappi la telemetria dell'aggiornatore a una persona.
Vedi Conformità HIPAA per la configurazione tecnica completa e le trade-off di osservabilità quando le statistiche sono disabilitate.
Posso mantenere Capgo live update dati in Europa?
Se posso mantenere i dati Capgo live update in Europa?Sì. Gli app che richiedono la residency dei dati UE per il traffico del plugin Cloud Capgo possono impostare gli endpoint dell'aggiornatore sui host EU:
updateUrl:https://plugin.eu.capgo.app/updatesstatsUrl:https://plugin.eu.capgo.app/statschannelUrl:https://plugin.eu.capgo.app/channel_self
Usa tutti e tre gli URL EU insieme affinché le verifiche degli aggiornamenti, le statistiche e l'assegnazione del canale utilizzino la stessa percorso dati regionale. capacitor.config.tsLe applicazioni mobili esistenti utilizzano i nuovi endpoint solo dopo una rilascio nativo.
Vedi Ubicazione dei dati per esempi esatti di Capacitor e Electron.
Quali piattaforme supporta Capgo?
Sezione intitolata “Quali piattaforme supporta Capgo?”Attualmente, Capgo supporta Android, iOS e Electron. Tutti sono pronti per la produzione.
L'uso di Capgo per iOS, Android o Electron può essere una decisione indipendente. Puoi impostare la strategia del canale per Android e un ipa costruito per l'App Store, o i canali di Electron, come necessario.
Capgo può (relativamente facilmente) essere reso compatibile con i target desktop o embedded. Se questi sono importanti per te, per favore ci informa.
Come funziona Capgo con le piste di testing di Play o Apple TestFlight?
Sezione intitolata “Come funziona Capgo con le piste di testing di Play o Apple TestFlight?”Ogni negozio di app ha meccanismi separati per distribuire app a gruppi di utenti limitati (ad esempio “testing interno”, “beta chiusa”, ecc.). Questi sono tutti meccanismi per segmentare gli utenti in gruppi e distribuire versioni specifiche delle app a ciascuno.
Purtroppo, questi meccanismi non consentono a tutti i terzi di rilevare quando le app sono installate in una specifica pista di testing o tramite TestFlight. Pertanto, non abbiamo una visibilità affidabile sulla composizione di questi gruppi e non possiamo garantire l'accesso a Capgo patch in base a questi gruppi. https://it.stackexchange.com/domande/53291007/può-un-applicazione-android-identificare-la-traccia-di-test-su-google-play https://stackoverflow.com/questions/26081543/come-determinare-in-temporanea-se-un-applicazione-ios-è-in-esecuzione-tramite-un-beta-testflight-i
Se desideri segmentare la disponibilità del pacchetto Capgo, ci sono 4 opzioni potenziali:
- Usa un canale separato per ogni gruppo. Questo è l'approccio più diretto, ma richiede di gestire più canali. Potresti già avere dei canali di sviluppo e produttivi con disponibilità diverse. Puoi quindi aggiornare i tuoi canali di sviluppo, verificarli e poi aggiornare separatamente i tuoi canali produttivi. Consigliamo l'uso di branch / tag nel tuo controllo delle versioni per aiutare a tenere traccia delle fonti associate a ogni rilascio.
- Segui le tue utenti per consentirne l'accesso, disabilita gli aggiornamenti automatici e attiva gli aggiornamenti solo per determinati utenti tramite il
@capgo/capacitor-updaterpacchetto. Funziona oggi, ma richiede che tu gestisca la tua lista di abbonati in modo autonomo. - Capgo consente di creare il proprio meccanismo di opt-in per dispositivo singolo (simile a Test Tracks o TestFlight, ma piattaforma indipendente). Ciò consente al tuo team di QA di opt-in per il bundle prima di essere promossi al pubblico generale.
- Usa progressive rollouts per consegnare un bundle candidato a un sottogruppo casuale e fissato di un canale. Imposta un rollout da 0 a 100% o utilizza
--rollout-percentage-bpsper incrementi di 0,01%; configura la durata della cache da 60 secondi a 365 giorni e la politica di pausa automatica facoltativa. Ciò non seleziona un gruppo di dispositivi denominato.
Pagamento
Pagina intitolata “Facturazione”Come posso aggiornare o ridurre il mio piano?
Sezione intitolata “Come posso aggiornare o ridurre il mio piano?”Puoi aggiornare o ridurre il tuo piano in qualsiasi momento nel tuo pannello di controllo: https://console.capgo.app/impostazioni/organizzazione/piani
Quando si resetta il mio periodo di fatturazione?
Sezione intitolata “Quando si resetta il mio periodo di fatturazione?”I periodi di fatturazione vengono resettati automaticamente ogni mese nel mese in cui hai sottoscritto per la prima volta Capgo. Ad esempio, se hai sottoscritto il 15 del mese, il tuo periodo di fatturazione si resettà il 15 di ogni mese.
Come posso cancellare la mia sottoscrizione?
Sezione intitolata “Come posso cancellare la mia sottoscrizione?”Puoi cancellare la tua sottoscrizione in qualsiasi momento nel tuo pannello di controllo: https://console.capgo.app/impostazioni/organizzazione/piani
Può pagare un anno in anticipo?
Sottosezione intitolata “Può pagare un anno in anticipo?”Sì. Puoi scegliere la fatturazione annuale nel tuo Piano di organizzazione.
Cosa viene conteggiato per lo storage, e possiamo modificare la conservazione?
Cosa viene conteggiato per lo storage e possiamo modificare la conservazione?Storage includes retained historical bundles and their Delta assets across your channels. You control unused-bundle retention for each app in App Settings. Bundles linked to an active channel or rollout stay protected so they remain available for delivery and rollback.
La riproduzione regionale moltiplica lo spazio di archiviazione o la banda?
Sezione intitolata “Si moltiplica la riproduzione regionale lo storage o la banda?”No. Un bundle viene conteggiato una volta per lo storage, indipendentemente dalle regioni che lo servono. La banda non viene moltiplicata dalle regioni neanche: vedi Come viene conteggiata la banda?.
Come viene conteggiata la banda?
Sezione intitolata “Come viene conteggiata la banda?”La banda conta solo i file che un dispositivo scarica effettivamente da Capgo:
- Aggiornamenti delta: quando si carica con
--delta, un dispositivo scarica solo i file che sono stati modificati dal momento in cui ha già una versione. Solo quei file contano. I file non modificati, come immagini grandi o font, non vengono scaricati nuovamente e non costano nulla. Vedi Aggiornamenti delta. - Cache di edge: Se un file richiesto o un file zip completo è già memorizzato all'edge, quel download non conta nei tuoi limiti di banda. Ciò si applica a file Delta e zip completi.
- Download ripresi: Se un download viene interrotto, il dispositivo riprende da dove si è fermato. La parte già scaricata non viene scaricata o contata nuovamente.
- Zip completo: I pacchetti caricati senza
--deltao dispositivi su una versione di plugin senza supporto Delta, scaricano il file zip completo. Questo conta solo quando non viene servito dalla cache dell'edge.
Per mantenere bassi i limiti di banda, caricare con --delta e mantenere grandi asset che cambiano raramente in percorsi di file stabili.
Cos'è incluso nell'Enterprise SLA?
Sezione intitolata “Cos'è incluso nell'Enterprise SLA?”L'Enterprise include un impegno mensile di disponibilità del 99,9% per la piattaforma di produzione. Se questo impegno non viene rispettato, lo schema di credito del servizio è del 10% al 30% in base alla disponibilità mensile. I target di risposta iniziali sono P1: un'ora, 24/7/365; P2: due ore di lavoro; P3: un giorno lavorativo; e P4: due giorni lavorativi. Leggi il SLA aziendale per i termini completi.
Statistiche e analisi
Sezione intitolata “Statistiche e analisi”I dati statistici nella tua dashboard vengono aggiornati ogni mezzanotte UTC. I dati statistici sono calcolati dai dati distinti MAU attivi durante il periodo di 30 giorni in rotazione.
Come viene generato l'ID del dispositivo
Sezione intitolata “Come viene generato l'ID del dispositivo”L'ID del dispositivo viene generato sul dispositivo alla prima esecuzione, e viene utilizzato per evitare la duplicazione degli installi per dispositivo e consentire di fatturare in base agli utenti installati (ad esempio, utenti attivi mensili), piuttosto che su patch totali o installi di patch totali.
MAU è una soluzione migliore del numero di installazioni per il prezzo di Capgo, poiché è più accurata e riflette il costo reale di Capgo per dispositivo.
Persistenza dell'ID dispositivo:
- IOS: Dal v7.25.0+, l'ID dispositivo è memorizzato nella Keychain e persiste attraverso reinstallazioni normali.
- Android: Utilizza v7.50.1+ (o v5.50.1+/v6.50.1+ su quelle linee di rilascio). L'ID dispositivo viene ripristinato solo quando Backup/Restore di Android mantiene le preferenze dell'applicazione.
- Electron: L'ID dispositivo è memorizzato in un archivio sicuro.
- Caveat Android: Disabilitando il backup, escludendo le preferenze pertinenti o cancellando i dati dell'applicazione genera un nuovo ID dispositivo. Le versioni Android dal v7.25.0 al v7.50.0 possono generare un nuovo ID dispositivo dopo una reinstallazione anche quando il backup è abilitato.
L'ID dispositivo è app-scoperto e supporta la consegna di aggiornamenti in tempo reale e la deduplicazione di MAU; non è un identificatore di pubblicità o di tracciamento tra applicazioni.
Gli ID dispositivi sono elencati dopo che l'app verifica con Capgo attraverso gli endpoint di aggiornamento o statistiche. Un dispositivo non deve installare un patch prima di poter apparire nella lista degli ID dispositivi.
Perché il mio numero di dispositivo è diverso dal mio MAU?
Sottosezione intitolata “Perché il mio numero di dispositivo è diverso dal mio MAU?”Il dispositivo e il MAU sono basati su segnali diversi.
The device list shows the latest known metadata for each device, such as the device ID, platform, plugin version, OS version, native version, channel, installed bundle, and request country when available. The request country is the latest valid two-letter code received from a Cloudflare-handled request for that device, not GPS or app-provided location. Requests without a valid country do not clear the last valid value. Capgo updates this metadata when the app checks in, but repeated check-ins that report the same metadata may not change the row or its last update time.
Il MAU conta dispositivi attivi distinti durante la finestra di fatturazione. Questa attività può aumentare anche quando i dati del dispositivo rimangono gli stessi, quindi il conteggio dei dispositivi e il MAU possono essere diversi.
Come avere un aggiornamento diverso per piattaforma?
Sottosezione intitolata “Come avere un aggiornamento diverso per piattaforma?”Puoi creare un canale per ogni piattaforma e disabilitare gli aggiornamenti specifici per piattaforma in ogni canale.
Sui canali iOS disabilita gli aggiornamenti per Android e sui canali Android disabilita gli aggiornamenti per iOS.
Poi carica un bundle in ogni canale per avere un aggiornamento diverso per ogni piattaforma.
Se hai bisogno di avere lo stesso aggiornamento per entrambe le piattaforme, puoi collegare un bundle a più canali. Non è necessario duplicare il bundle.
Continua da qui
Prosegui dalle domande frequentiSe stai utilizzando FAQ Per pianificare la consegna live update, collega live update con Capgo Aggiornamenti in tempo reale per il workflow del prodotto nei Capgo Live Updates, Panoramica per i dettagli di implementazione in Panoramica Caratteristiche per i dettagli di implementazione in Caratteristiche Comportamento dell'aggiornamento per i dettagli di implementazione in Comportamento dell'aggiornamento, e Tipi di aggiornamento per i dettagli di implementazione in Tipi di aggiornamento.