A Visual Studio Code extension for building, running, and debugging applications on EdgeOS devices.
Overview
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.
Features
Device Management
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
Swift Integration
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
Debugging
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
Documentation
Quick Access: Access EdgeOS documentation directly from the extension
Integrated Help: Find answers to common questions without leaving your development environment
Requirements
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)
Installation
Install the extension from the VS Code Marketplace
Ensure the Edge CLI is installed (edge --version should work in your terminal)
Configure the Swift SDK path if needed for debugging
Extension Settings
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).
Getting Started
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
Debugging Your Applications
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
Known Issues
Swift SDK path must be configured manually for debugging
Debugging requires port 4242 to be accessible on the target device
Release Notes
0.0.1
Initial release with basic device management, build and debugging support
Feedback and Contributions
Found a bug or have a feature request? Please open an issue on our GitHub repository.
