README.zh.md

vscode-DOSBox

提供一个在 VSCode 中运行 DOSBox 及其变体的接口

支持的 DOSBox 和 VSCode 平台

• JSDos: 支持包括 web 端的所有平台
• DOSBox: windows 系统下打包了可执行文件，linux 和 macOS 系统需要手动安装
• DOSBox-x: windows 系统下打包了可执行文件，linux 和 macOS 系统需要手动安装
• MSDos-player: windows 系统下打包了可执行文件，其他平台无相应程序

功能

• 提供打开相关 DOS 模拟器的简单接口，参看 api.ts
• 提供打开相关 DOS 模拟器的简单命令，可以在命令面板测试与调用

安装依赖

Windows 系统用户

所有的可执行文件都已经打包在安装包中。可以通过修改设置来使用不同的模拟器

在 mac 平台使用 homebrew 安装 DOSBox 和 DOSBox-x (推荐)

brew install dosbox
brew install dosbox-x

homebrew官网有安装 homebrew 的详细教程，tuna也提供了镜像安装和换源方法。

在 mac 平台从 dmg 文件安装 DOSBox

1. 从 DOSBox 的官网下载 DMG 文件
2. 点击 dmg 文件
3. 将程序拖拽到/Applications文件夹
4. 在 VSCode 中添加如下设置，配置用于打开 DOSBox 的命令

"vscode-dosbox.command.dosbox":"open -a dosbox --args",

可能需要修改 sdl 输出方式，来使显示效果满意，例如：

"vscode-dosbox.dosbox.config": {
   "SDL.output":"overlay",
}

在 mac 平台从 zip 文件安装 DOSBox-x

1. 从 dosbox-x 的 官网 下载 zip 压缩包文件
2. 解压并将需要的话.app文件拖拽到 /Applications文件夹
3. 按照macOS 的文档设置安全选项
   1. 在“系统偏好设置”中，前往“安全性与隐私”。
   2. 点按“通用”面板中的“仍要打开”按钮，以确认您打算打开或安装这个 App。
4. 在 VSCode 中添加如下设置，配置用于打开 DOSBox 的命令

"vscode-dosbox.command.dosboxX":"open -a dosbox-x --args",

在 Linux 平台安装 dosbox

Ubuntu 等可以使用 apt 的发行版可以使用如下命令安装

sudo apt install dosbox

参看DOSBox's website

在 Linux 平台安装 dosbox-x

根据dosbox-x's instructions, 我们可以使用flatpak来安装 DOSBox-X.

# install flatpak
sudo apt install flatpak
# use flatpak to install DOSBox-X
flatpak install flathub com.dosbox_x.DOSBox-X

最后在 VSCode 的设置中添加如下内容

"vscode-dosbox.command.dosboxX":"flatpak run com.dosbox_x.DOSBox-X",

插件设置

该插件主要包括如下设置:

• vscode-dosbox.command.dosbox: 自定义打开 dosbox 的命令
• vscode-dosbox.command.dosboxX: 自定义打开 dosbox-x 的命令

jsdos 兼容情况

environment	platform	dosboxWorker	dosboxDirect
extensionhost	nodejs	❌	✅
webview	browser	✅	✅
web extensionhost	Worker	✅	❌
web webview	browser	✅	✅

报告问题

在github issues中，提交遇到的问题。

Release Notes