This is a preview version of the Android for VS Code Extension. The extension allows developers to install, launch and debug Android Apps from within the VS Code environment.

• Line by line code stepping
• Breakpoints
• Variable inspection and modification
• Logcat viewing [ Command Palette -> Android: View Logcat ]
• Break on exceptions
• Step through Android sources

You must have Android SDK Platform Tools installed. This extension communicates with your device via the ADB (Android Debug Bridge) interface.

You are not required to have Android Studio installed - if you have Android Studio installed, make sure there are no active instances of it when using this extension or you may run into problems with ADB.

• This is a preview version so expect the unexpected. Please log any issues you find on GitHub.
• This extension will not build your app.
  If you use gradle (or Android Studio), you can build your app from the command-line using ./gradlew assembleDebug.

You must use gradle or some other build procedure to create your APK. Once built, the extension can deploy and launch your app, allowing you to debug it in the normal way.

• Some debugger options are yet to be implemented. You cannot set conditional breakpoints and watch expressions must be simple variables.
• If you require a must-have feature that isn't there yet, let us know on GitHub.
• This extension does not provide any additional code completion or other editing enhancements.

This extension allows you to debug your App by creating a new Android configuration in launch.json.
The following settings are used to configure the debugger:

{
    "version": "0.2.0",
    "configurations": [
        {
            // configuration type, request  and name. "launch" is used to deploy the app to your device and start a debugging session
            "type": "android",
            "request": "launch",
            "name": "Launch App",

            // Location of the App source files. This value must point to the root of your App source tree (containing AndroidManifest.xml)
            "appSrcRoot": "${workspaceRoot}/app/src/main",

            // Fully qualified path to the built APK (Android Application Package)
            "apkFile": "${workspaceRoot}/app/build/outputs/apk/app-debug.apk",

            // Port number to connect to the local ADB (Android Debug Bridge) instance. Default: 5037
            "adbPort": 5037,

            // Launch behaviour if source files have been saved after the APK was built. One of: [ ignore warn stop ]. Default: warn
            "staleBuild": "warn",
        }
    ]
}

If you run into any problems, tell us on GitHub or contact me on Twitter.