🛠️ xcodebuild.nvim

A plugin designed to let you migrate your app development from Xcode to Neovim. It provides all essential actions for development including building, debugging, and testing.

 

✨  Features

• Support for iOS, iPadOS, watchOS, tvOS, visionOS, and macOS.
• Support for Swift Packages (building & testing).
• Project-based configuration.
• Project Manager to deal with project files without using Xcode.
• Assets Manager to manage images, colors, and data assets.
• Test Explorer to visually present a tree with all tests and results.
• Built using official command line tools like xcodebuild and xcrun simctl.
• Actions to build, run, debug, and test apps on simulators and physical devices.
• Environment variables and run arguments management.
• Buffer integration with test results (code coverage, success & failure marks, duration, extra diagnostics).
• Code coverage report with customizable levels.
• Advanced log parser to detect all errors, warnings, and failing tests.
• nvim-tree, neo-tree, and oil.nvim integration that automatically reflects all file tree operations and updates Xcode project.
• nvim-dap integration to let you easily build, run, and debug apps.
• nvim-dap-ui integration to show app logs in the console window.
• lualine.nvim integration to show selected device, test plan, and other project settings.
• swift-snapshot-testing integration to present diff views for failing snapshot tests.
• Quick integration to show test results for tests written using Quick framework.
• Swift Testing integration to show test results for tests written using Swift Testing framework.
• Auto-detection of the target membership for new files.
• Picker with all available plugin actions.
• Highly customizable (many config options, auto commands, highlights, and user commands).

📦  Installation

Read Wiki to learn how to install and configure the plugin.

📚  Documentation

Everything about the plugin is described in the Wiki. You can find there all available commands, integrations, settings, and examples.

🎥  Demo

Testing

xcodebuild.nvim supports code coverage, test explorer, diagnostics, snapshot tests, Quick framework, and more!

0tests.mp4

Working With Code

Neovim can be easily integrated with SwiftLint, SwiftFormat, Copilot, and more. In the video, you can see basic navigation, diagnostics, formatting, linting, code completion, and of course, launching the app on a simulator.

1basics.mp4

Debugging

The plugin allows you to debug both on simulators and physical devices. You get access to all basic things like breakpoints, variables inspection, call stack, lldb, etc. You can even see app logs.

2debugging.mp4

 

💛  Sponsors

Big thanks to all the sponsors who support this project 🍻!

Monthly Sponsors

One Time Sponsors