A Visual Studio Code extension for building, running, and debugging applications on WendyOS devices.
Overview
The Wendy extension provides comprehensive integration with the Wendy platform, allowing developers to build, run, and debug Swift applications for WendyOS 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 Wendy documentation.
Features
Device Management
Device Explorer: View and manage your WendyOS 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 WendyOS devices on your network
Swift Integration
Project Detection: Automatic detection of Swift package projects
Build and Run: Build and deploy your Swift packages to WendyOS devices with one command
Task Integration: WendyOS 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 WendyOS devices for debugging
LLDB Integration: Full debugging support using LLDB with breakpoints, variable inspection, and more
Documentation
Quick Access: Access WendyOS 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
Wendy CLI installed and accessible
Swift SDK for WendyOS (for debugging)
Installation
Install the extension from the VS Code Marketplace
Ensure the Wendy CLI is installed (wendy --version should work in your terminal)
Configure the Swift SDK path if needed for debugging
Extension Settings
This extension contributes the following settings:
wendyos.cliPath: Path to the Wendy CLI executable. Leave empty for automatic detection.
wendyos.swiftSdkPath: Path to the WendyOS Swift SDK artifact bundle (required for debugging).
wendyos.devices: List of Wendy devices (managed by the extension).
wendyos.currentDevice: ID of the currently selected Wendy device (managed by the extension).
Getting Started
Open a Swift package project
Add a WendyOS device using the "+" button in the Wendy 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 Wendy 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.6
wifi configuration
0.0.5
Added automated release process via GitHub Actions
0.0.1
Initial release with basic device management, build and debugging support
Development
Release Process
This extension uses an automated release process via GitHub Actions. For details on how to release new versions, see Release Process Documentation.
Feedback and Contributions
Found a bug or have a feature request? Please open an issue on our GitHub repository.
