Both sides previous revisionPrevious revisionNext revision | Previous revision |
wswan:tutorial:development_environment [2024/02/17 13:46] – asie | wswan:tutorial:development_environment [2025/07/12 06:15] (current) – asie |
---|
===== Configuring an IDE ===== | ===== Configuring an IDE ===== |
| |
The Wonderful toolchain currently recommends using [[https://vscodium.com/|VSCodium]] (or another fork of VSCode) with the [[https://clangd.llvm.org/installation.html|clangd plugin]] installed. | Typically, Wonderful code is written using [[https://vscodium.com/|VSCodium]] (or another fork of VSCode) with the [[https://clangd.llvm.org/installation.html|clangd plugin]] installed. |
| |
<WRAP round info> | |
Other IDEs and editors with clangd support, such as Sublime Text and vim, should also have full compatibility. In addition, the proprietary Visual Studio Code with Microsoft's own C/C++ extensions is partially supported. | |
</WRAP> | |
| |
To install the clangd plugin in VSCodium: | To install the clangd plugin in VSCodium: |
- Select the project extension named "clangd" provided by "llvm-vs-code-extensions". | - Select the project extension named "clangd" provided by "llvm-vs-code-extensions". |
- Press the "Install" button and follow any further instructions displayed by the IDE. | - Press the "Install" button and follow any further instructions displayed by the IDE. |
| |
| Other IDEs and editors with clangd support, such as Sublime Text and vim, should also have full compatibility. In addition, the following IDEs have been tested and should at least partially work: |
| |
| * Visual Studio Code, using Microsoft's own C extension with IntelliSense, |
| * CLion, using JetBrains's own C engine. |
| |
===== Installing an emulator ===== | ===== Installing an emulator ===== |
| |
Unfortunately, the WonderSwan does not currently have a fully hardware-accurate emulator, and so verification of finished homebrew on hardware is still essential. Regardless, they are sufficient for development - there are two options available: | The best emulator for doing WonderSwan development is [[https://github.com/SourMesen/Mesen2/|Mesen 2]]. It provides a fully-featured low-level debugger and high (if not perfect) emulation accuracy. |
| |
| {{ :wswan:tutorial:mesen2.png?direct&600 |}} |
| |
| Other options include: |
| |
* [[https://ares-emu.net/|Ares]] - medium-high accuracy, but does not provide a debugger ((As of recently, Ares supports debugging via a GDB stub, but gdb itself doesn't play well with 16-bit 8086 concepts.)). | * [[https://ares-emu.net/|Ares]] - high accuracy, but does not provide a debugger ((As of recently, Ares supports debugging via a GDB stub, but gdb itself doesn't play well with 16-bit 8086 concepts.)). |
* [[https://github.com/WonderfulToolchain/wf-mednafen/releases|wf-mednafen]] - medium accuracy, but *does* provide [a debugger](https://mednafen.github.io/documentation/debugger.html); a fork of [Mednafen](https://mednafen.github.io/). | * [[https://github.com/WonderfulToolchain/wf-mednafen/releases|wf-mednafen]] - medium accuracy, but *does* provide [[https://mednafen.github.io/documentation/debugger.html|a debugger]]; a fork of [[https://mednafen.github.io/|Mednafen]]. |
| |
===== Testing on physical hardware ===== | ===== Testing on physical hardware ===== |