Capacitor CLI ti aiuta a trasformare le app web in app native iOS e Android con un unico codice. Ecco come impostarlo velocemente:
- Requisiti Preliminari: Install Node.js (v16+), npm, e un framework web (React, Vue, Angular, ecc.).
- Installare Capacitor CLI: Run
npm install @capacitor/cli @capacitor/coree inizializzare il tuo progetto connpx cap init. - Preparare piattaforme: Aggiungere supporto per iOS (
npx cap add ios) e Android (npx cap add android) piattaforme. - Costruire e sincronizzare: Utilizzare
npm run buildEcco i vantaggi di utilizzare Capgo.npx cap syncOpzionale Aggiornamento in Tempo Reale - : Utilizza strumenti come__CAPGO_KEEP_0__ Capgo __CAPGO_KEEP_0__ __CAPGO_KEEP_1__ semplifica lo sviluppo e la manutenzione delle app. Segui la guida per un setup e una risoluzione dei problemi fluidi.
Capacitor CLI simplifies app development and maintenance. Follow the guide for smooth setup and troubleshooting.
__CAPGO_KEEP_0__ Capacitor + DaisyUI + __CAPGO_KEEP_0__ Framework Documentazione Sito Web

Prima di iniziare
Prepara il tuo ambiente eseguendo i seguenti passaggi:
Configura Node.js e npm

Avrai bisogno di Node.js versione 16 o superiore. La versione LTS più recente è raccomandata. Per verificare la tua configurazione, esegui:
node --version
npm --version
Se hai bisogno di aggiornare, scarica Node.js (che include npm) dal sito ufficiale.
Dopo aver confermato che Node.js è pronto, assicurati che il tuo progetto web soddisfi le necessarie Capacitor richieste.
Verifica il tuo progetto web
Il tuo progetto web dovrebbe avere i seguenti:
- A un pacchetto.json valido: Assicurati che sia configurato correttamente.
- Un directory di costruzione: Questo è dove vivono i tuoi asset web (comunemente
distowww). - Un punto di ingresso: Il tuo directory di costruzione deve includere un
index.htmlfile.
Ecco un rapido sguardo ai campi chiave: package.json Campo obbligatorio
| Esempio di valore | __CAPGO_KEEP_0__ | Scopo |
|---|---|---|
| nome | ”my-app” | Identifica il progetto |
| versione | ”1.0.0” | Specifica la versione dell'app |
| directory di costruzione | ”dist” o “www” | Punti a risorse web |
Una volta che il tuo progetto Node.js e web è pronto, passa all'installazione delle tool specifiche per piattaforma.
Installare Software Richiesto
Per lo Sviluppo Android:
- Scarica e installa la versione più recente di Android Studio.
- Configura l'SDK Android con almeno un livello API 22.
- Configura la
ANDROID_HOMEvariabile di ambiente.
Per lo sviluppo di iOS (solo Mac):
-
Installa Xcode 14 o una versione più recente.
-
Installa gli strumenti di linea di comando.
-
Utilizza Homebrew per installare CocoaPods:
brew install cocoapods -
Accetta il licenza Xcode:
sudo xcodebuild -license accept
Quando integrerai Capgo in seguito, assicurati di avere una connessione internet stabile e certificati SSL validi.
Con questi passaggi completati, sei pronto per un processo di sviluppo Capacitor liscio. Successivamente, installerai il Capacitor CLI.
Installa Capacitor CLI
Con il tuo ambiente pronto, è ora di installare e configurare Capacitor CLI.
Aggiungi Pacchetti Capacitor
Inizia installando il Capacitor CLI e i pacchetti Core utilizzando npm:
npm install @capacitor/cli @capacitor/core
Una volta installati, conferma la configurazione controllando il Capacitor CLI versione:
npx cap --version
Configura il tuo progetto
Inizializza Capacitor nel tuo progetto con il seguente comando:
npx cap init
Durante l'inizializzazione, verrai sollecitato a fornire questi dettagli:
| Impostazioni | Descrizione | Esempio |
|---|---|---|
| Nome App | Il nome visualizzato nelle store di app | ”My Awesome App” |
| Nome App | Un identificatore univoco per l'app | ”com.mycompany.myapp” |
| Directory Web | Percorso dei tuoi asset web | "dist" o "www" |
Successivamente, aggiorna il tuo file di configurazione (capacitor.config.ts o capacitor.config.json) con le impostazioni pertinenti:
import { CapacitorConfig } from '@capacitor/cli';
const config: CapacitorConfig = {
appId: 'com.mycompany.myapp',
appName: 'My Awesome App',
webDir: 'dist',
bundledWebRuntime: false
};
export default config;
Configura iOS e Android
Aggiungi supporto per le piattaforme iOS e Android con questi comandi:
npx cap add ios
npx cap add android
Questo genererà progetti nativi:
- iOS: Crea un
ioscartella contenente il progetto Xcode. - Android: Crea un
androidcartella per il progetto Android Studio.
Dopo aver effettuato qualsiasi modifica ai tuoi asset web, esegui i seguenti comandi per costruire e sincronizzare:
npm run build
npx cap sync
Questo processo compila i tuoi asset web e li trasferisce ai progetti nativi, inclusi eventuali plugin installati Capacitor plugins.
Ora sei pronto per testare la tua configurazione e risolvere eventuali problemi che potrebbero sorgere.
npx cap open ios # Opens Xcode
npx cap open android # Opens Android Studio
Risolvi Problemi Comuni
Quando si configura __CAPGO_KEEP_0__ __CAPGO_KEEP_1__, potresti incontrare alcuni comuni problemi. Ecco come affrontarli:
When setting up Capacitor CLI, you might run into a few common hiccups. Here’s how to tackle them:
Se stai affrontando problemi correlati a Gradle, prova questi passaggi:
Naviga nella directory Android e cancella il cache di costruzione:
-
]}
cd android ./gradlew cleanBuildCache -
Aggiorna la versione di Gradle in
android/build.gradle:buildscript { ext { gradleVersion = '8.1.0' } } -
Aggiungi le seguenti righe a
android/gradle.propertiesper una maggiore prestazione:org.gradle.jvmargs=-Xmx4608m org.gradle.parallel=true
Se i problemi persistono, ripristina la configurazione o consulta ulteriori risorse di risoluzione dei problemi.
L'app mostra uno schermo bianco
Uno schermo bianco indica spesso un problema di configurazione. Ecco come risolverlo:
-
Controlla la cartella del Web Directory: Assicurati che
webDircorrisponda all'output di compilazione.const config: CapacitorConfig = { webDir: 'dist', // Adjust if necessary }; -
Verifica la configurazione del server: Conferma che le impostazioni del server sono corrette.
server: { url: 'http://localhost:3000', cleartext: true } -
Aggiorna la politica di sicurezza del contenuto: Aggiungi questo tag meta al tuo HTML per il caricamento dei risorse corretto.
<meta http-equiv="Content-Security-Policy" content="default-src 'self' 'unsafe-inline' 'unsafe-eval' data: *">
Plugin Non Funziona
Se un plugin non funziona come previsto, segui questi passaggi:
-
Esegui un'installazione pulita delle dipendenze:
rm -rf node_modules npm cache clean --force npm install -
Controlla le impostazioni del plugin in
capacitor.config.tsper assicurarti che siano configurate correttamente:plugins: { PluginName: { option: 'value' } }
Per coloro che utilizzano Capgo's plugin nativo, sincronizza automaticamente i plugin e mantiene la compatibilità durante gli aggiornamenti.
Dopo aver applicato questi rimedi, ricostruisci il tuo progetto per verificare i cambiamenti:
npm run build && npx cap copy && npx cap sync
Una volta che tutto funziona correttamente, puoi procedere con l'esplorazione delle opzioni di aggiornamento in tempo reale con Capgo.
Aggiornamenti in Tempo Reale con Capgo

Semplifica aggiornamenti dell'app utilizzando Capgo. Consente di inviare aggiornamenti direttamente agli utenti, evitando la necessità di recensioni delle app store.
Iniziare è facile. Prima, installa i pacchetti necessari:
npm install @capgo/cli @capgo/capacitor-updater
npx cap sync
Poi, inizializza Capgo nel tuo progetto:
npx @capgo/cli init
Piani di abbonamento
Capgo offre diversi piani di abbonamento per soddisfare esigenze diverse:
| Piano | Utenti attivi mensili | Banda larga | Archiviazione | Prezzo (annuale) |
|---|---|---|---|---|
| SOLO | 1,000 | 50 GB | 2 GB | $12/mese |
| MAKER | 10,000 | 500 GB | 5 GB | $33/mese |
| TEAM | 100,000 | 2.000 GB | 10 GB | $83/mese |
Per gli utenti aziendali, il piano PAYG inizia a $249/mese e include vantaggi come l'accesso a API, domini personalizzati e supporto dedicato.
Configurazione per Aggiornamenti in Tempo Reale
Per abilitare gli aggiornamenti in tempo reale, aggiungi il seguente al tuo capacitor.config.ts file:
{
plugins: {
CapacitorUpdater: {
autoUpdate: true,
updateUrl: 'https://api.capgo.app/updates'
}
}
}
Caratteristiche Chiave
Capgo fornisce diverse caratteristiche di spicco:
- Aggiornamenti sicuri con crittografia end-to-end
- Distribuzioni automatizzate attraverso CI/CD integrato
- Aggiornamenti mirati attraverso l'assegnazione dell'utente
- Ritorno istantaneo con controllo delle versioni
- Analisi in tempo reale per tracciare gli aggiornamenti
Comandi di distribuzione
Testa gli aggiornamenti in fase di sviluppo prima di distribuirli in produzione. Utilizza i seguenti comandi:
-
Distribuisci su staging:
npx @capgo/cli deploy --channel staging -
Distribuisci su produzione:
npx @capgo/cli deploy --channel production
Capgo garantisce la conformità con le linee guida di Apple e Android, quindi gli aggiornamenti live non rischiano violazioni dei negozi di app. È un modo efficiente per gestire Capacitor app dopo l'installazione.
Conclusione
Configurare Capacitor CLI è semplice quando si hanno le giuste precondizioni in atto. Questa configurazione garantisce aggiornamenti di app più fluidi e flussi di lavoro di sviluppo più efficienti.
Le moderne strumentazioni rendono la manutenzione delle app più facile che mai. Ad esempio, Capgo fornisce aggiornamenti in tempo reale, sostituendo metodi più vecchi. La sua integrazione con l'installazione di CLI ne rende un'ottima scelta per gli sviluppatori che lavorano con app Capacitor.
La L'ecosistema di Capacitor è in continua evoluzione con nuove strumentazioni e funzionalità. L'installazione di CLI è solo l'inizio per costruire app mobili, e si beneficerà di una documentazione dettagliata e di una comunità di sviluppatori attiva.
Assicurarsi di mantenere Capacitor CLI e i suoi pacchetti aggiornati per evitare problemi di compatibilità.
Continua da Installazione di Capacitor CLI: Guida Passo dopo Passo
Se si utilizza Installazione di Capacitor CLI: Guida Passo dopo Passo per pianificare il dashboard e le API operazioni, connettilo con API Overview per i dettagli di implementazione in API Overview, Introduzione per i dettagli di implementazione in Introduzione, API Chiavi per i dettagli di implementazione in API Chiavi, Dispositivi per i dettagli di implementazione in Dispositivi, e Bundle per i dettagli di implementazione in Bundle.