A Visual Studio Code extension for building, running, and debugging applications on EdgeOS devices.
The Edge extension provides comprehensive integration with the Edge platform, allowing developers to build, run, and debug Swift applications for EdgeOS devices directly from Visual Studio Code. This extension streamlines the development workflow by managing device connections, providing convenient debugging configurations, and offering direct access to Edge documentation.
- Device Explorer: View and manage your EdgeOS devices in the sidebar
- One-Click Device Selection: Easily switch between multiple devices for deployment and debugging (Note: currently only 1 device is supported)
- Auto Discovery: Automatically detect EdgeOS devices on your network
- Project Detection: Automatic detection of Swift package projects
- Build and Run: Build and deploy your Swift packages to EdgeOS devices with one command
- Task Integration: EdgeOS tasks are fully integrated with VS Code's task system
- Debug Configuration Provider: Automatically creates appropriate debug configurations for your Swift targets
- Remote Debugging: Connect to remote EdgeOS devices for debugging
- LLDB Integration: Full debugging support using LLDB with breakpoints, variable inspection, and more
- Quick Access: Access EdgeOS documentation directly from the extension
- Integrated Help: Find answers to common questions without leaving your development environment
- Visual Studio Code 1.96.0 or newer
- Swift for Visual Studio Code extension
- Edge CLI installed and accessible
- Swift SDK for EdgeOS (for debugging)
- Install the extension from the VS Code Marketplace
- Ensure the Edge CLI is installed (
edge --versionshould work in your terminal) - Configure the Swift SDK path if needed for debugging
This extension contributes the following settings:
edgeos.cliPath: Path to the Edge CLI executable. Leave empty for automatic detection.edgeos.swiftSdkPath: Path to the EdgeOS Swift SDK artifact bundle (required for debugging).edgeos.devices: List of Edge devices (managed by the extension).edgeos.currentDevice: ID of the currently selected Edge device (managed by the extension).
- Open a Swift package project
- Add an EdgeOS device using the "+" button in the Edge Devices panel
- Select the device as your current device
- Use the Run or Debug buttons to deploy and run your application on the device
- Make sure you've configured your Swift SDK path via the settings
- Select your target device in the Devices panel
- Open the Debug panel and select "Debug Edge Application"
- Start debugging to deploy and connect to your application
- Swift SDK path must be configured manually for debugging
- Debugging requires port 4242 to be accessible on the target device
- wifi configuration
- Added automated release process via GitHub Actions
- Initial release with basic device management, build and debugging support
This extension uses an automated release process via GitHub Actions. For details on how to release new versions, see Release Process Documentation.
Found a bug or have a feature request? Please open an issue on our GitHub repository.
Enjoy building with EdgeOS!