Per abilitare il modulo dello sviluppatore su Android, apri Impostazioni > Informazioni sul telefono e premi Numero di costruzione sette volte, quindi inserisci il tuo PIN. Un Opzioni dello sviluppatore menu compare, dove puoi attivare Debugging via USB o Debugging wireless Debugging wireless adb o bunx cap run android Puoi installare e debuggare la tua app. Il percorso esatto per il numero di build dipende dal produttore, quindi i passaggi per ogni marchio sono riportati di seguito.
Cosa fanno le opzioni di sviluppatore (e cosa non fanno)
Opzioni di sviluppatore è un menu di impostazioni nascosto destinato agli sviluppatori di app. Attivarlo da solo non fa nulla. Mostra solo le voci di commutazione come:
- Debugging via USB: consente a un computer affidabile di eseguire
adbcomandi, installa edizioni e leggi i log. - Debugging wireless: la stessa cosa via Wi-Fi (Android 11+).
- Resta sveglio: lo schermo rimane acceso mentre si carica, utile durante le prove.
- : scala dell'animazione: accelera o disabilita le animazioni del sistema, utili per i test di UI.
- : non conserva le attività: distrugge le attività quando ne lasci, un buon modo per testare la ripristinazione dello stato in un'app Capacitor.
- Mostra punti / Posizione del puntatore: utile per registrare demo e verificare i bersagli di tocco.
: non not Per installare un APK da un browser o gestore file, per utilizzare la maggior parte delle app o per ricevere un aggiornamento via aria.
Abilita le opzioni dello sviluppatore per marchio
| Marchio | Dove premere 7 volte | Dove compare il menu dopo |
|---|---|---|
| Google Pixel / Android di base | Impostazioni > Informazioni sul telefono > Numero di costruzione | Impostazioni > Sviluppatore > Opzioni dello sviluppatore |
| Samsung (One UI) | Impostazioni > Informazioni sul telefono > Informazioni sul software > Numero di costruzione | Opzioni dello sviluppatore (in fondo alla lista) |
| Xiaomi, Redmi, POCO (HyperOS) | Impostazioni > Informazioni sul telefono > OS version | Impostazioni > Impostazioni aggiuntive > Opzioni dello sviluppatore |
| Xiaomi (MIUI più vecchio) | Impostazioni > Informazioni sul telefono > Versione di MIUI | Impostazioni > Impostazioni aggiuntive > Opzioni dello sviluppatore |
| OnePlus (OxygenOS) | Impostazioni > Informazioni sul dispositivo > Versione > Numero di build | Impostazioni > Impostazioni del sistema > Opzioni dello sviluppatore |
| OPPO / realme (ColorOS / realme UI) | Impostazioni > Informazioni sul dispositivo > Versione > Numero di build | Impostazioni > Impostazioni aggiuntive > Optioni sviluppatori |
| Motorola | Impostazioni > Informazioni sul telefono > Numero di build | Impostazioni > Sistema > Optioni sviluppatori |
| Huawei / Honor (EMUI / MagicOS) | Impostazioni > Informazioni sul telefono > Numero di build | Impostazioni > Sistema e aggiornamenti > Optioni sviluppatori |
Menu si sposta tra le versioni del sistema operativo. Se non riesci a trovare il numero di costruzione, apri le Impostazioni e utilizza il campo di ricerca: digita “numero di costruzione”. Su quasi ogni dispositivo Android, la ricerca lo trova direttamente.
Google Pixel (Android 14, 15, 16)
- Apre Impostazioni e scorri verso About phone.
- Scorrere verso il basso e tocca Numero di costruzione sette volte. Dopo alcuni tocchi vedi un messaggio di conto alla rovescia.
- Inserisci il tuo PIN, schema o password.
- Torna indietro a Impostazioni > Sistema > Opzioni dello sviluppatore.
Dispositivi Samsung Galaxy
- Apri Impostazioni > Informazioni sul telefono > Informazioni sul software.
- Tocca Numero di costruzione sette volte e conferma con il tuo PIN.
- Opzioni dello sviluppatore ora appare in fondo alla lista principale delle impostazioni, sotto Informazioni sul telefono.
Impostazioni > Informazioni sul telefono
- Apri Impostazioni > Informazioni sul telefono.
- Tocca OS version (HyperOS) o Versione MIUI (dispositivi più vecchi) sette volte.
- Vai a Impostazioni > Impostazioni aggiuntive > Opzioni dello sviluppatore.
Xiaomi aggiunge due interruttori extra che si utilizzano di solito per lo sviluppo: Installa via USB e USB debugging (Impostazioni di sicurezza). Senza “Installa via USB” adb install fallisce con INSTALL_FAILED_USER_RESTRICTEDAbilitare queste funzionalità potrebbe richiedere l'accesso a un account Xiaomi e la presenza di una carta SIM inserita.
OnePlus, OPPO e realme
- Apre Impostazioni > Informazioni sul dispositivo > Versione.
- Tocca Numero di costruzione sette volte.
- Apre Impostazioni > Impostazioni del sistema > Opzioni dello sviluppatore (OnePlus) o Impostazioni > Impostazioni aggiuntive > Opzioni dello sviluppatore (OPPO, realme)
Huawei e Honor
- Apri Impostazioni > Informazioni sul dispositivo .
- Tocca Numero di costruzione sette volte.
- Vai a Impostazioni > Sistema e aggiornamenti > Opzioni dello sviluppatore .
Su dispositivi Huawei, impostare anche il modalità di connessione USB su Trasferimento di file quando si collega, altrimenti adb potrebbe non vedere il dispositivo. Se pianifici di inviare questi dispositivi, leggi How to pubblicare un Capacitor app su Huawei AppGalleryperché molti di loro non hanno servizi Google Play.
Lavori di profilo e dispositivi gestiti
Se la tua azienda gestisce il telefono, l'amministratore può bloccare le opzioni dello sviluppatore. Vedrai 'Le opzioni dello sviluppatore non sono disponibili per questo utente'. Chiedi all'IT un dispositivo di prova piuttosto che cercare di lavorare intorno alla politica.
Attiva il debug USB
- Apre Opzioni dello sviluppatore e attiva il Debugging USB.
- Collega il telefono con un cavo USB che supporta i dati (molti cavi economici sono solo per la ricarica).
- Sul telefono, accetta il Permetti il debug USB? dialogo. Tick Consenti sempre da questo computer Sul tuo computer, controlla la connessione:
- Controlla la connessione sul computer:
adb devices
Vorresti vedere:
List of devices attached
R5CT1234ABC device
unauthorized di solito significa un cavo o porta difettoso, o un offline solitamente significa un cavo o porta difettoso, o un adb server da un vecchio SDK.
adb viene fornito con le strumentazioni del piattaforma Android SDK. Se è installato Android Studio, si trova in ~/Library/Android/sdk/platform-tools su macOS %LOCALAPPDATA%\Android\Sdk\platform-tools . Nuovo nel toolchain Android? I nostri PATHstrumenti e risorse sono disponibili qui Configurazione Android per le Capacitor app copre tutto.
Attiva il debug wireless (Android 11 e successive)
La debug wireless elimina il cavo. Il tuo computer e il telefono devono essere connessi alla stessa rete Wi-Fi, e alcune reti aziendali o di hotel bloccano il traffico dispositivo-a-dispositivo.
- In Opzioni dello sviluppatore, attiva il Debug wireless e accetta la richiesta di rete.
- Tocca Debug wireless per aprirlo, poi Collega il dispositivo con il pairing codeTenere questa schermata aperta.
- Sul computer, collega utilizzando l'indirizzo IP e il numero di porta mostrato nel dialogo di pairing:
adb pair 192.168.1.42:37145
# Enter pairing code: 482913
- Connetti utilizzando l'indirizzo IP e il numero di porta mostrati sulla schermata di debug wireless principale (un diverso porto da quello di pairing):
adb connect 192.168.1.42:41827
adb devices
Android Studio dispone anche di Collega dispositivi utilizzando Wi-Fi nella gestione dei dispositivi, che mostra un codice QR code da scansionare dalla schermata di debug wireless.
Il porto cambia ogni volta che si riavvia la debuggazione wireless, quindi dovrai ripetere adb connect dopo i riavvii. Il pairing stesso viene ricordato.
Su Android 10 e precedenti, utilizza il metodo più vecchio: collega una volta per USB, esegui adb tcpip 5555disconnetti, e adb connect <phone-ip>:5555.
Esegui il tuo Capacitor app sul dispositivo
With il dispositivo elencato in adb devices, il Capacitor CLI può costruire e installare direttamente:
bun run build
bunx cap sync android
bunx cap run android --list # show connected devices and emulators
bunx cap run android --target R5CT1234ABC
Per un ciclo più veloce, utilizza il reload in tempo reale affinché l'app carichi il tuo server di sviluppo sulla rete.
bunx cap run android -l --external
Perché il telefono debba raggiungere l'indirizzo IP del tuo computer per funzionare. Quando desideri che i tester fuori dalla tua rete possano vedere le modifiche senza reinstallare, guarda: Capgo live updates al posto di un server di sviluppo.
To leggere i log nativi mentre l'app è in esecuzione:
adb logcat | grep -i -E "capacitor|chromium"
E per debuggare il WebView, apri chrome://inspect in Chrome desktop mentre è in esecuzione la build di debug. Le build di debug degli app Capacitor abilitano il debug del WebView di default.
Troubleshooting
Il numero di build non fa nulla. Pagina/Area: Supporto / supporto premium o sezione di supporto del footer. Ruolo: Intestazione di sezione o pagina. Visualizzato in: pagina support-policy.astro. Chiave di messaggio `support_policy_troubleshooting_title` (Titolo di supporto per la risoluzione dei problemi).
Dispositivo mancante da adb devices.
adb kill-server
adb start-server
adb devices
Poi prova con un cavo diverso e un portale diretto sul computer anziché un hub. Sposta la notifica del modalità USB a Trasferimento di file.
Windows non vede il telefono. Installa il driver USB OEM (Samsung, Xiaomi e altri pubblicano i propri) o il driver USB di Google dal SDK Manager per i dispositivi Pixel.
INSTALL_FAILED_UPDATE_INCOMPATIBLE. L'applicazione installata era firmata con una chiave diversa (ad esempio una build di Play Store rispetto alla tua build di debug). Disinstallala prima: adb uninstall com.example.app.
INSTALL_FAILED_USER_RESTRICTED su Xiaomi. Abilita Installa via USB in le opzioni del sviluppatore.
La debuggistica wireless si spegne continuamente. Android lo spegne quando cambi rete Wi-Fi. Alcuni risparmiatori di batteria lo bloccano anche. Tieni il telefono sulla stessa rete e carica durante le sessioni lunghe.
Non autorizzato dopo l'aggiornamento di Android Studio. La chiave adb in ~/.android/adbkey è cambiata. Nel menu Developer options premi su Revoca delle autorizzazioni di debug USB, riattacca e accetta nuovamente la richiesta.
Come disabilitare le opzioni del developer
- Apre Opzioni del developer.
- Toggle Usa opzioni del developer o (o Opzioni del developer su Samsung) in alto per disattivare.
Il menu rimane visibile su alcuni dispositivi, ma ogni interruttore all'interno si riavvia a impostazioni predefinite. Per nascondere completamente il menu, vai a Impostazioni > Applicazioni > Impostazioni > Archiviazione e cancella l'archiviazione per l'app Impostazioni. Ciò resettare anche altre impostazioni delle preferenze, quindi è raramente utile.
Prima di consegnare un telefono di prova a qualcun altro, tocca anche Revoca delle autorizzazioni di debug USB così che i computer vecchi non possono più connettersi.
Nota sulla sicurezza
- Il debug USB consente a un computer autorizzato di installare app e leggere i dati delle app dai costrutti di debug. Non accetta la richiesta RSA sulle stazioni di ricarica pubbliche o sui computer che non si fidano.
- Alcune app bancarie e di pagamento rifiutano di eseguirsi mentre le opzioni dello sviluppatore o il debug USB sono attivi. Spegni queste opzioni sul tuo telefono personale quando sei finito.
- Non spedire mai un costrutto di rilascio con
android:debuggable="true". I costrutti di rilascio Capacitor non sono debuggabili di default.
L'equivalente di iOS
Gli iPhone hanno il loro proprio Modalità sviluppatore interruttore che devi attivare prima di eseguire costruzioni di sviluppo o ad hoc. Vedi come abilitare la Modalità sviluppatore su iOSPer ottenere i build sui telefoni dei tester senza cavi, leggi come distribuire app iOS e Android ai tester.