- installare node.js versione LTS (>= 16)
- Installare lo strumento di gestione dei pacchetti di filati versione 1.18.0. (Dopo aver installato l'ultima versione di yarn, esegui
yarn policies set-version 1.18.0
nella directory principale) - installare git lfs (necessario per tirare e aggiornare alcuni binari)
- Per avviare il progetto iOS, assicurati che la versione locale di XCode sia maggiore o uguale a 13.3
- Per avviare il progetto Android, assicurati che la versione JDK locale sia maggiore o uguale a 11
Dopo aver prelevato l'ultimo codice tramite lo strumento a riga di comando git, installare le dipendenze del progetto nella directory principale con il comando yarn
Installa tutte le dipendenze JS e i sottomoduli
yarn
Sviluppare codice commerciale diverso eseguendo i seguenti comandi nella directory principale
yarn web
: sviluppa la modalità web, che avvierà localmente un server statico sulla porta 3000yarn ios
: debug dello sviluppo su dispositivi iphone tramite connessione USByarn android
: debug di Androidyarn desktop
: sviluppo in modalità desktopyarn ext
: sviluppa plugin per browser
Configura le chiavi rilevanti in apps/android/lib-keys-secret/src/main/cpp/keys.c
, o usa le opzioni predefinite. Alcune API possono avere delle restrizioni.
- Vai al repository di crittografia e prendi il file
debug.keystore
e mettilo nella directoryapps/android/keystores
, se non lo hai, crealo tu stesso. - Vai al repository di crittografia e prendi il file
keys.secret
e mettilo nella directoryapps/android
.
I repository sono organizzati utilizzando il modello monorepo per mantenere il codice su diverse estremità centralizzato e non influenzato, permettendo allo stesso tempo il maggior riutilizzo possibile del codice durante il processo di impacchettamento e compilazione
packages/components
per i componenti UIpackages/kit
contiene contenuti UI riutilizzabili a livello di paginaapps
codice APPapps/desktop
Codice elettronico del desktoppacchetti/web
codice lato webpacchetti/ext
Codice lato plugin
Ogni sottodirectory sotto la directory packages/
è un progetto separato, il cui nome è il valore del campo name
nella directory package.json in monorepo.
Quando hai bisogno di installare una dipendenza per una sottodirectory, usa semplicemente yarn workspace @onekeyhq/web add axios
. Con un prefisso come yarn workspace @onekeyhq/web
, il modulo axios può eventualmente essere installato nella directory principale del sottoprogetto web.
Alcune delle dipendenze hanno parti native, quindi dovrai andare nella directory apps/ios
ed eseguire pod install
dopo aver installato le dipendenze JS.
- L'app non può essere avviata e vari problemi di avvio dell'ambiente
Per qualsiasi problema relativo all'ambiente, ai moduli e alle dipendenze nella fase di avvio, si consiglia di utilizzare prima il comando yarn clean
nella directory principale. Il comando cancellerà tutte le sotto-dipendenze, così come la cache del modulo di yarn, la cache di strumenti come metro/babel, e quindi riavvierà il progetto per provare.
- Durante l'installazione delle dipendenze o quando si aggiungono nuove dipendenze, il filato visualizzerà errore Si è verificato un errore imprevisto: "prevista l'esistenza del pacchetto dell'area di lavoro per
Fare riferimento a yarnpkg/yarn#7807, impostare la versione corrente del filato dell'ambiente su 1.18.0 tramite il comando yarn policies set-version 1.18.0