Um Entwickler-Modus auf Android zu aktivieren, öffnen Sie Einstellungen > Über das Gerät und tippen Sie Buildnummer sieben Mal, dann geben Sie Ihr PIN ein. A Entwickleroptionen Menü erscheint, wo Sie es aktivieren können USB-Debugging oder Wireless Debugging Wireless-Debugging adb oder bunx cap run android Sie können Ihre App installieren und debuggen. Die genaue Pfad zur Build-Nummer hängt vom Hersteller ab, daher sind die Schritte für jede Marke unten aufgeführt.
Was sind die Entwickleroptionen (und was nicht)
Entwickleroptionen ist ein versteckter Einstellmenü, das für App-Entwickler gedacht ist. Die Aktivierung selbst hat keinen Effekt. Es enthält nur Schalter wie:
- USB-Debugging: lässt ein vertrauenswürdiges Computer-System
adbBefehle, installieren Sie Builds und lesen Sie Protokolle. - Wireless-Debugging: dasselbe über Wi-Fi (ab Android 11+).
- Schlaflos bleibenBildschirm bleibt eingeschaltet, während geladen, nützlich bei der Testung.
- Animationsskala: beschleunigt oder schaltet Systemanimationen aus, nützlich für UI-Tests.
- Keine Aktivitäten speichern: Aktivitäten werden zerstört, wenn man sie verlässt, eine gute Möglichkeit, den Zustand in einer Capacitor-App zu testen.
- Tasten anzeigen / Pointer-Lokalisierungnützlich für die Aufzeichnung von Demos und die Überprüfung von Touch-Zielen.
Sie müssen keinen Entwickler-Modus aktivieren, um eine APK aus einem Browser oder Dateimanager zu installieren, um die meisten Apps zu verwenden oder um ein Update über das Internet zu erhalten.
Entwickler-Optionen aktivieren nach Marke
| Marke | Wo Sie 7 Mal tippen müssen | Wo sich das Menü danach zeigt |
|---|---|---|
| Google Pixel / Standard-Android | Einstellungen > Über das Gerät > Build-Nr. | Einstellungen > System > Entwickler-Optionen |
| Samsung (One UI) | Einstellungen > Über das Gerät > Geräteinformationen > Buildnummer | Einstellungen > Entwickleroptionen (am Ende der Liste) |
| Xiaomi, Redmi, POCO (HyperOS) | Einstellungen > Über das Gerät > OS version | Einstellungen > Zusätzliche Einstellungen > Entwickleroptionen |
| Xiaomi (ältere MIUI) | Einstellungen > Über das Gerät > MIUI-Version | Einstellungen > Zusätzliche Einstellungen > Entwickleroptionen |
| OnePlus (OxygenOS) | Einstellungen > Über Gerät > Version > Buildnummer | Einstellungen > Systemeinstellungen > Entwickleroptionen |
| OPPO / realme (ColorOS / realme UI) | Einstellungen > Über Gerät > Version > Buildnummer | Einstellungen > Zusätzliche Einstellungen > Entwickleroptionen |
| Motorola | Einstellungen > Über Telefon > Buildnummer | Einstellungen > System > Entwickleroptionen |
| Huawei / Honor (EMUI / MagicOS) | Einstellungen > Über das Gerät > Buildnummer | Einstellungen > System und Updates > Entwickleroptionen |
Menüs ändern sich zwischen Betriebssystemversionen. Wenn Sie die Buildnummer nicht finden können, öffnen Sie die Einstellungen und verwenden Sie das Suchfeld: Tippen Sie "Buildnummer" ein. Auf fast jedem Android-Gerät findet die Suche es direkt.
Google Pixel (Android 14, 15, 16)
- Öffnen Einstellungen und scrollen Sie nach Über das Gerät.
- Scrollen Sie nach unten und tippen Sie Buildnummer Sieben Mal. Nach einigen Taps sehen Sie eine Zählertoast.
- Eingeben Sie Ihren PIN, Muster oder Passwort.
- Zurück zu Einstellungen > System > Entwickleroptionen.
Samsung Galaxy
- Öffnen Einstellungen > Über das Gerät > Softwareinformationen.
- Tippen Buildnummer Sieben Mal und bestätigen Sie mit Ihrem PIN.
- Entwickleroptionen erscheinen nun am unteren Ende der Haupt-Einstellungenliste, unter Über das Gerät.
Xiaomi, Redmi und POCO
- Öffnen Einstellungen > Über das Gerät.
- Tippen OS version (HyperOS) oder MIUI-Version (ältere Geräte) sieben Mal. (older devices) seven times.
- Gehe zu Einstellungen > Weitere Einstellungen > Entwickleroptionen.
Xiaomi adds two extra switches you usually need for development: Entwickleroptionen und USB-Debugging (Sicherheitseinstellungen). Ohne "Install via USB", adb install mit dem Fehler INSTALL_FAILED_USER_RESTRICTED. Die Aktivierung dieser Funktionen kann eine Anmeldung bei einem Xiaomi-Konto und die Eingabe eines SIM-Karten erforderlich machen.
OnePlus, OPPO und realme
- Öffnen Einstellungen > Über das Gerät > Version.
- Drücken Buildnummer sieben Mal.
- Öffnen Einstellungen > Systemeinstellungen > Entwickleroptionen (OnePlus) oder Einstellungen > Zusätzliche Einstellungen > Entwickleroptionen (OPPO, realme).
Huawei und Honor
- Öffnen Einstellungen > Über das Gerät.
- Tippen Build-Nummer sieben Mal.
- Gehe zu Einstellungen > System & Updates > Entwickleroptionen.
On Huawei-Geräten stellen Sie auch den USB-Verbindungstyp auf Dateitransfer wenn Sie das Gerät anstecken, andernfalls adb könnten Sie das Gerät nicht sehen. Wenn Sie diese Geräte liefern möchten, lesen Sie wie Sie ein Capacitor-App auf Huawei AppGallery veröffentlichen, da viele von ihnen keine Google Play-Dienste haben.
Arbeitsprofile und verwaltete Geräte
Wenn Ihr Unternehmen das Telefon verwaltet, kann der Administrator die Entwickleroptionen blockieren. Sie sehen 'Entwickleroptionen sind für diesen Benutzer nicht verfügbar'. Fordern Sie bei IT einen Testgerät an, anstatt sich um die Richtlinie herumzureden.
USB-Debugging aktivieren
- Öffnen Entwickleroptionen und schalten Sie sie ein USB-Debugging.
- Verbinden Sie das Telefon mit einem USB-Kabel, das Daten unterstützt (viele günstige Kabel sind nur zum Laden geeignet).
- Am Telefon akzeptieren Sie das Erlauben Sie USB-Debugging? Diaologfeld. Klicken Sie auf Immer erlauben von diesem Computer auf Ihrem eigenen Computer.
- Am Computer überprüfen Sie die Verbindung:
adb devices
Sie sollten sehen:
List of devices attached
R5CT1234ABC device
unauthorized Sie haben die Aufforderung nicht akzeptiert. offline usually means a bad cable or port, or an adb Server von einem alten SDK.
adb kommt mit dem Android SDK-Plattform-Tools. Wenn Android Studio installiert ist, befindet es sich in ~/Library/Android/sdk/platform-tools auf macOS oder %LOCALAPPDATA%\Android\Sdk\platform-tools auf Windows. Fügen Sie das Verzeichnis Ihrer PATHNeu im Android-Toolchain? Unsere Android-Einrichtung für Capacitor-Apps bedeckt es.
Schalten Sie die drahtlose Debugging (Android 11 und später)
Drahtloses Debugging entfernt den Kabel. Ihr Computer und Ihr Telefon müssen sich im selben WLAN-Netzwerk befinden, und einige Unternehmens- oder Hotelnetzwerke blockieren Geräte-zu-Geräten-Verkehr.
- In EntwickleroptionenSchalten Sie zu Entwicklertools und akzeptieren Sie das Netzwerk-Fenster.
- Tippen Sie drahtloses Debuggen um es zu öffnen, dann Paarung mit der Paarung codeBleiben Sie diese Seite geöffnet.
- Paaren Sie sich auf dem Computer mit der IP-Adresse und dem Port, der im Paarungsdialog angezeigt wird:
adb pair 192.168.1.42:37145
# Enter pairing code: 482913
- Verbinden Sie mit der IP-Adresse und dem Port, die auf der Haupt-Seite für drahtloses Debugging angezeigt werden (ein anderer Port als der Pairing-Port):
adb connect 192.168.1.42:41827
adb devices
Android Studio hat auch Geräte über Wi-Fi paired in der Gerätemanager-Ansicht, die eine QR-Code code anzeigt, den Sie von der drahtlosen Debug-Seite scannen können.
Der Port ändert sich bei jedem Neustart des drahtlosen Debuggens, daher wiederholen Sie dies. adb connect nach Neustarten. Die Paarung wird gespeichert.
Bei Android 10 und früher, verwenden Sie die ältere Methode: Verbinden Sie einmal über USB, starten Sie adb tcpip 5555, entfern Sie sich, und adb connect <phone-ip>:5555.
Führen Sie Ihr Capacitor-App auf dem Gerät aus
Mit dem Gerät in der Liste adb devices, kann das Capacitor-CLI direkt installieren und bauen:
bun run build
bunx cap sync android
bunx cap run android --list # show connected devices and emulators
bunx cap run android --target R5CT1234ABC
Für einen schnelleren Loop verwenden Sie Live-Reload, damit die App Ihre Entwicklungs-Server über das Netzwerk lädt:
bunx cap run android -l --external
Das Telefon muss die IP-Adresse Ihres Rechners erreichen, damit dies funktioniert. Wenn Sie möchten, dass Tester außerhalb Ihres Netzwerks Änderungen sehen, ohne das Gerät neu zu installieren, schauen Sie sich Capgo-Live-Updates anstatt eines Entwicklungs-Servers.
Um native Logs während der App-Laufzeit zu lesen:
adb logcat | grep -i -E "capacitor|chromium"
Und um den WebView zu debuggen, öffnen Sie chrome://inspect Während die Debug-Build läuft, aktivieren Sie die Optionen für Entwickler in Chrome. Debug-Builds von Capacitor Apps aktivieren die WebView-Debugging standardmäßig.
Fehlersuche
Keine Aktion beim Anklicken der Buildnummer. Sie klicken möglicherweise die falsche Feld (z.B. Android-Version anstatt Buildnummer), oder das Gerät wird von einer Organisation verwaltet. Einige Xiaomi-Geräte benötigen, dass Sie die OS-Version anstatt die Buildnummer anklicken.
Gerät fehlt in adb devices.
adb kill-server
adb start-server
adb devices
Versuchen Sie es dann mit einem anderen Kabel und einem direkt am Computer angeschlossenen Port anstatt einem Hubs. Schalten Sie die USB-Modus-Anzeige auf Dateiübertragung.
Windows erkennt das Telefon nicht. Installieren Sie den OEM-USB-Treiber (Samsung, Xiaomi und andere veröffentlichen ihren eigenen) oder den Google-USB-Treiber vom SDK-Manager für Pixel-Geräte.
INSTALL_FAILED_UPDATE_INCOMPATIBLE. Die installierte App wurde mit einem anderen Schlüssel signiert (z.B. eine Play Store-Build gegenüber Ihrer Debug-Build). Entfernen Sie sie zuerst: adb uninstall com.example.app.
INSTALL_FAILED_USER_RESTRICTED auf Xiaomi. Aktivieren Install über USB im Developer-Optionen.
Wireless-Debugging wird ständig ausgeschaltet. Android schaltet es aus, wenn Sie das WLAN-Netzwerk ändern. Einige Akkuspar-Einstellungen stoppen es auch. Halten Sie das Telefon auf demselben Netzwerk und laden Sie es während langen Sitzungen auf.
Unberechtigt nach dem Update von Android Studio. Der adb-Schlüssel in ~/.android/adbkey geändert. In den Entwickleroptionen tippen Sie USB-Debugging-Berechtigungen aufheben, reconnectieren und die Aufforderung erneut akzeptieren.
Wie man die Developer-Optionen ausschaltet
- Öffnen Entwickleroptionen.
- Schalten Entwickleroptionen verwenden (or Entwickleroptionen auf Samsung oben rechts
The menu stays visible on some devices but every switch inside resets to default. To hide the menu completely, go to Einstellungen > Apps > Einstellungen > Speicher und löschen Sie den Speicher für die Einstellungen-App. Das zurücksetzt auch andere Einstellungenpräferenzen, daher ist es selten wertvoll.
Bevor Sie einem Testgerät jemand anderen übergeben, tippen Sie auch auf USB-Debugging-Berechtigungen widerrufen damit alte Computer nicht mehr verbinden können.
Sicherheitshinweise
- USB-Debugging ermöglicht es einer autorisierten Computer-App, Apps zu installieren und Daten von debugbaren Builds zu lesen. Akzeptieren Sie auf öffentlichen Ladestationen oder Computern, die Sie nicht vertrauen, nicht die RSA-Anfrage.
- Einige Bank- und Zahlungsanwendungen lehnen es ab, während die Entwickleroptionen oder USB-Debugging aktiv sind, zu laufen. Schalten Sie sie auf Ihrem persönlichen Telefon aus, wenn Sie fertig sind.
- Schicken Sie nie ein Release-Build mit
android:debuggable="true". Capacitor-Release-Builds sind standardmäßig nicht debugbar.
Der iOS-Äquivalent
iPhone haben ihre eigene Entwicklermodus Schalters, die Sie benötigen, bevor Sie Entwicklung- oder Ad-hoc-Builds ausführen. Siehe wie Entwicklermodus auf iOS zu aktivierenUm Builds auf Testern-Handys ohne Kabel zu übertragen, lesen Sie wie iOS- und Android-Apps an Tester verteilen.