Clone this repo:

Branches

  1. 6dea312 [analytics] Bring back analytics to the extension by Rundong Du · 2 days ago main
  2. 6a6c018 [Bug] Fix component tree by Amy Hu · 11 days ago
  3. f5c2116 [logger] Migrate to LogOutputChannel by Rundong Du · 12 days ago
  4. 97b2e54 [docs] Update ChangeLog.md for December 2024 release. by Nick Van der Auwermeulen · 5 weeks ago
  5. 5089730 [docs] Reorganizing build instructions by Nick Van der Auwermeulen · 5 weeks ago

Fuchsia extension for VS Code

Implements the commonly needed functionality for Fuchsia development.

Features

  • View device logs
  • Run and debug tests
  • Explore and debug components
  • FIDL and CML syntax highlighting

View device logs

  1. Select a Fuchsia device using the Device Selector in the bottom toolbar:

    Device selector

  2. Select “Show log for device name” from quick picker:

    Show log

  3. View the logs:

    Log viewer

Run and debug tests

  1. Select the “Testing” tab from the left navigation bar and view the list of tests in your current build configuration:

    Test explorer

  2. Click the “Run Test” or “Debug Test” button to run or debug the test. Double-click the test to jump to the BUILD.gn that defines the test.

Explore and debug components

  1. Select the “Run and Debug” tab from the left navigtaion bar and expand the “Fuchsia Components” panel to view the components running on the device:

    Component explorer

  2. Click the “Attach Debugger” button to attach the debugger to the component. Set a breakpoint by clicking to the left of a line of source code to stop the component on that line of code.

  3. Click a component to show more information about that component.

Settings

FFX path

The FFX tool path can be set under Settings > Extensions > Fuchsia SDK. If this path is not set, the extension will automatically search for it at:

  • ./tools/ffx
  • ./.jiri_root/bin/ffx

Tips

Set fx build as default build task

The default build task can be set under Terminal > Configure Default Build Task.... When set to fx build, the command can be run with Cmd+Shift+b on Mac and Ctrl+Shift+b on Windows and Linux.

Recommended extensions

Contributing

Issues/feedback

  • Please report issues/feedback here.

Legal Notice

Use of the Fuchsia core developer tools is subject to the Google Terms of Service. The Google Privacy Policy describes how data is handled in your use of this service.