C-SKY CDK Assistant
English | 简体中文
Build C-SKY Development Kit (CDK) workspaces directly from Visual Studio Code through the official cdk-make.exe command-line tool.
The extension discovers CDK metadata itself and does not require a companion CLI. Optional read-only mode can prevent cdk-make.exe from modifying .cdkws or .cdkproj files.
Features
- Discover
.cdkws workspaces and their .cdkproj projects.
- Select a Workspace, Project, and BuildSet with Quick Pick.
- Build, rebuild, clean, or build every project through VS Code Tasks.
- Show the selected project and BuildSet with build shortcuts in the status bar.
- Store the selection in
.vscode/csky-cdk.json with workspace-relative paths.
- Diagnose the
cdk-make.exe path and discovered project count.
- Optionally enable read-only mode to prevent
cdk-make.exe from updating project metadata.
- Avoid the legacy MSYS startup delay when building on a Windows host through VS Code Remote - SSH.
- Provide English and Simplified Chinese command titles.
Requirements and Scope
- Windows desktop VS Code
1.125.0 or newer, either locally or connected to a Windows host through Remote - SSH.
- A C-SKY CDK installation on the machine where the extension runs that provides
cdk-make.exe.
- A folder containing a
.cdkws file.
Quick Start
- Open the folder containing the CDK workspace in VS Code.
- Run C-SKY CDK: Select Workspace and select the Workspace, Project, and BuildSet.
- Run C-SKY CDK: Configure cdk-make Path if CDK is not installed at the default location.
- Use the status bar buttons, Command Palette commands, or keyboard shortcuts to build.
The default executable path is:
C:/Program Files/C-Sky/CDK/cdk-make.exe
VS Code Tasks
The extension contributes the csky-cdk task type and provides build, rebuild, and clean tasks for each configured VS Code workspace folder. Tasks declared in tasks.json are resolved against the saved project selection. Build commands execute cdk-make.exe in the selected workspace folder with its native short options such as -w, -p, -c, -d, and -a.
csky-cdk-assistant.readOnlyMode defaults to false, which uses the native cdk-make.exe behavior and may rewrite project metadata. Enable it to protect the selected .cdkws plus every referenced .cdkproj for the duration of a build.
The csky-cdk-assistant.sshLoginFix setting is enabled by default. On a Windows Remote - SSH host, it supplies LOGONSERVER=\\<COMPUTERNAME> to the build task only when the SSH session left LOGONSERVER empty. This prevents the legacy MSYS 1.0 shell bundled with CDK from waiting for an account lookup timeout. An existing LOGONSERVER is never overwritten, and the setting is not persisted. Disable the setting to run with the original SSH environment.
Development instructions and known issues are documented in doc/development.md.
See CHANGELOG.md for release history and doc/help.md for bilingual usage help.
C-SKY CDK Assistant（简体中文）
English | 简体中文
通过官方 cdk-make.exe 命令行工具，直接在 Visual Studio Code 中构建 C-SKY Development Kit（CDK）工作区。
本扩展会自行发现并解析 CDK 元数据，也不依赖额外的配套 CLI。可选的只读模式用于阻止 cdk-make.exe 修改 .cdkws 或 .cdkproj 文件。
功能
- 发现
.cdkws 工作区及其包含的 .cdkproj 项目。
- 通过快速选择框选择 Workspace、项目和 BuildSet。
- 通过 VS Code 任务执行生成、重新生成、清理或生成全部项目。
- 在状态栏显示当前项目和 BuildSet，并提供生成快捷按钮。
- 使用相对路径将选择结果保存到
.vscode/csky-cdk.json。
- 检查
cdk-make.exe 路径、文件信息和项目发现结果。
- 可开启只读模式，阻止
cdk-make.exe 更新工程元数据。
- 通过 VS Code Remote - SSH 在 Windows 主机上构建时，避免旧版 MSYS Shell 启动延迟。
- 提供英文和简体中文命令标题。
要求与支持范围
- Windows 桌面版 VS Code
1.125.0 或更高版本，可在本机使用，也可通过 Remote - SSH 连接 Windows 主机。
- 运行扩展的计算机上已安装 C-SKY CDK，并包含
cdk-make.exe。
- 打开的目录中包含
.cdkws 文件。
快速开始
- 在 VS Code 中打开包含 CDK 工作区的目录。
- 运行 C-SKY CDK: 选择 Workspace，选择 Workspace、项目和 BuildSet。
- 如果 CDK 未安装在默认位置，运行 C-SKY CDK: 配置 cdk-make.exe 路径，将路径保存到当前
.cdkws 对应的配置文件。
- 使用状态栏按钮、命令面板命令或快捷键执行构建。
默认可执行文件路径为：
C:/Program Files/C-Sky/CDK/cdk-make.exe
VS Code 任务
扩展提供 csky-cdk 任务类型，并为每个已配置的 VS Code 工作区目录生成 build、rebuild 和 clean 任务。构建命令使用 cdk-make.exe 原生短参数，例如 -w、-p、-c、-d 和 -a。
csky-cdk-assistant.readOnlyMode 默认为 false，此时使用 cdk-make.exe 的原生行为，工程元数据可能被改写。开启后会在构建期间保护所选 .cdkws 及其引用的全部 .cdkproj。
csky-cdk-assistant.sshLoginFix（SSH 登录修复）默认开启。在 Windows Remote - SSH 主机上，如果 SSH 会话中的 LOGONSERVER 为空，扩展仅为构建任务补充 LOGONSERVER=\\<COMPUTERNAME>，避免 CDK 自带的旧版 MSYS 1.0 Shell 等待账户查询超时。已有的 LOGONSERVER 不会被覆盖，此设置也不会持久化。关闭该设置后使用原始 SSH 环境构建。
开发说明和已知问题见 doc/development.md。
发布历史见 CHANGELOG.md，双语使用帮助见 doc/help.md。
