Problemi noti
Copia un prompt di configurazione con i passaggi di installazione e la guida markdown completa per questo plugin.
Live reload di Ionic
Sottosezione intitolata “Live reload di Ionic”- Quando sviluppi, se utilizzi la funzione di live reload di Ionic dal CLI, sovrascriverà il plugin, quindi non vedrai mai l'aggiornamento.
Quasar live reload
Sezione intitolata “Quasar live reload”- Utilizza lo stesso sistema di Ionic sotto il cofano, quindi non vedrai le tue aggiornamenti.
Aggiornamenti falliti
Sezione intitolata “Aggiornamenti falliti”- Questo solitamente accade quando vengono inviati aggiornamenti di grandi dimensioni (> 20mb), una grande percentuale di utenti non riceverà la versione più recente.
In passato, gli utenti dovevano tenere l'app aperta fino a quando il download non era completo, ora utilizziamo il download in background, ma è ancora limitato a pochi secondi.
Android
Sezione intitolata “Android”Impossibile scaricare
Sezione intitolata “Impossibile scaricare”Abbiamo notato alcuni problemi con i dispositivi in India, e abbiamo fatto chiamare gli utenti, li abbiamo invitati a provare diversi server DNS, e funzionava.
Se hai questo problema, prova a utilizzare un server DNS diverso come Cloudflare o Google DNS.
Cloudflare: 1.1.1.1 e 1.0.0.1
Google DNS: 8.8.8.8 e 8.8.4.4 o dns.google
Self Hosted
Sezione intitolata “Self Hosted”Quando stai spingendo un aggiornamento self-hosted, assicurati di non utilizzare l'endpoint 'HTTP' poiché è contro le politiche di sicurezza degli app Android. Se lo desideri, segui questa guida:
Scompatta
Sezione intitolata “Scompatta”Problema di scompattazione: gli elementi DEFLATI possono avere descriptor EXT
Se hai scompresso il tuo bundle con qualcosa diverso dal CLI, il formato o il tuo file zip potrebbe essere errato, per favore utilizza il comando CLI npx @capgo/cli zip BUNDLE_FOLDER.
Questo è un problema noto di Java:
Problema di Clearfix
Sottosezione intitolata “Problema di Clearfix”- Se hai problemi con usesCleartextTraffic, è perché il plugin segue la buona pratica raccomandata da sonar cloud, in 90% dei casi funziona a meraviglia, ma con alcuni plugin causa problemi.
Per risolverlo, aggiungi in android/app/src/main/AndroidManifest.xml in il <application> chiave :
tools:replace="android:usesCleartextTraffic"xmlns:tools="http://schemas.android.com/tools"Manifesto di privacy
Sezione intitolata “Manifesto sulla privacy”Aggiungi la NSPrivacyAccessedAPICategoryUserDefaults chiave del dizionario al tuo Manifesto sulla privacy (di solito ios/App/PrivacyInfo.xcprivacy):
<?xml version="1.0" encoding="UTF-8"?><!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd"><plist version="1.0"> <dict> <key>NSPrivacyAccessedAPITypes</key> <array> <!-- Add this dict entry to the array if the file already exists. --> <dict> <key>NSPrivacyAccessedAPIType</key> <string>NSPrivacyAccessedAPICategoryUserDefaults</string> <key>NSPrivacyAccessedAPITypeReasons</key> <array> <string>CA92.1</string> </array> </dict> </array> </dict></plist>Consigliamo di dichiarare CA92.1 come motivo per l'accesso al UserDefaults API.
Autorizzazioni di rete
Sezione intitolata “Autorizzazioni di rete”Quando si utilizza un server locale per testare l'aggiornamento, l'app chiederà l'autorizzazione di rete, è un comportamento normale, non è il caso quando si utilizza un server remoto.
Quando si effettuano aggiornamenti in modalità manuale, alcuni eventi non sono facili da catturare, ad esempio il trigger di aggiornamento fallito si attiva proprio prima che il tuo JS code si ricarichi, quindi non riuscirai a catturarlo.
Un'altra alternativa è elencare i pacchetti e controllare gli errori per sapere se l'aggiornamento fallisce.
Dobbiamo trovare un modo migliore per gestire questo in futuro, ma non è una priorità, poiché la modalità automatica è la via consigliata per l'aggiornamento.
Sono accetti i PR per aiutarci a migliorare questo.
se il tuo CLI ha problemi a fare qualsiasi cosa
Controlla se appId e nomeApp sono presenti nel tuo capacitor.config.ts
Segui la guida del documento ufficiale:
Continua da Problemi noti
Prosegui dalle problematiche noteProblemi noti Problemi noti per pianificare il lavoro del plugin nativo, connettilo Usando @capgo/capacitor-aggiornatore per la capacità nativa in Utilizzo @capgo/capacitor-aggiornatore, Capgo Directory dei Plugin per il workflow del prodotto in Capgo Directory dei Plugin Capacitor Plugin da Capgo per il dettaglio di implementazione in Capacitor Plugin da Capgo Aggiunta o Aggiornamento dei Plugin per il dettaglio di implementazione in Aggiunta o Aggiornamento dei Plugin, e Sostituti dei Plugin Enterprise di Ionic per il workflow del prodotto in Sostituti dei Plugin Enterprise di Ionic.