Nexus: Android Debugger
Debug Android C/C++ native code right inside VS Code — light, fast, and stable.
Supports CMake-based native projects.
📷 Hero 截图占位 — 主界面 + 一次正在进行的调试会话
Why Nexus
If you debug Android native code in Android Studio, this probably sounds familiar:
- The IDE gets slow and laggy on larger projects, and just keeping it open is heavy.
- Breakpoints are slow to hit, and stepping through code drags.
- Debug sessions drop and disconnect, so you have to start over.
Nexus brings native debugging into VS Code instead — which stays light and responsive, has excellent C/C++ support, and lets you keep working in your existing CMake / incremental-build workflow rather than waiting on full IDE rebuilds. You get VS Code's debugging experience (breakpoints, variables, call stack, watch, debug console) on your Android native code.
What it does
- Attach in a couple of clicks — fill in a little configuration once, pick the process, and you're debugging on the device.
- Stays out of your way — a lightweight, responsive, and stable connection to your device.
- Localized UI — use the extension in your own language (see Languages).
Demo
This animation shows the VS Code extension flow: choose a process, attach, and hit breakpoints on device.
Requirements
- A connected Android device or emulator with USB debugging enabled, running a debuggable build
- Android NDK installed
- A CMake-based native project
Using it
Open the Nexus view from the Activity Bar, pick your device and the process you want, then attach. That's it.
The Nexus view has three actions:
- Attach — start debugging the selected process.
- Refresh — re-scan for connected devices and processes.
- Settings (gear icon) — open the configuration panel below.
Settings
Open the settings panel from the gear icon in the Nexus view. You only need to provide:
- NDK path — the folder where your Android NDK is installed.
- Debug options — the target app/process and the debug type for the session.
📷 Settings panel image placeholder — to be replaced with resources/screenshots/settings-panel.png
Languages
The extension UI is available in:
- English
- 简体中文 (Simplified Chinese)
- 繁體中文 (Traditional Chinese)
- 日本語 (Japanese)
- 한국어 (Korean)
- Deutsch (German)
- Français (French)
- Español (Spanish)
- Русский (Russian)
- Português (Portuguese)
The UI follows your VS Code display language automatically, and falls back to English when a string isn't translated.
License
See LICENSE.txt.
