DLL 工程（用 Y++ 编写并导出 `.dll`）

Y++ / YStudio 开发文档 · 一点滴

第一版为纯导出库：无窗口、默认代码视图。打开工程不会进设计画布。

仅 .ysproj 中 "type": "dll" 可用 导出 / .yex（模块工程 "type": "module" 同样可用，见 ys-module.md）。
先写 函数，再在 .yex 用 导出 登记；导出名可与函数同名或用 ASCII 别名。
调用约定在项目设置选 stdcall（默认）或 cdecl；改后须重编 DLL 与宿主。
工程位数须与宿主一致；加载DLL 会做 PE 位数预检。
生成的 .yp 给宿主用别名调用；第三方也可 加载DLL→取导出函数→调用函数Ex。
「一键调用」测试仅覆盖无字节集/回调/数组的简单签名。
YSS：与模块/窗口工程相同，使用 加载YSS / 应用YSS（或有效 .yss）须先开通 YSS 样式。

写法：先写函数，再导出

' —— math.yc ——
函数 相加(整数 a, 整数 b) 整数 {
    返回(a + b)
}

' —— exports.yex ——
导出 "相加"
导出 "Add" = 相加
导出 ["相减"]

项目设置 → DLL 调用约定：stdcall（默认，Windows API 常用）或 cdecl（多数 C 库）。

生成的 .yp 会在别名后写上约定（stdcall / cdecl），宿主 thunk 按该约定生成。

函数	时机
`函数 DLL.加载 { … }`	`LoadLibrary` 成功（PROCESS_ATTACH）
`函数 DLL.卸载 { … }`	`FreeLibrary` / 进程退出（PROCESS_DETACH）

新建 DLL 工程会自带 main.yc + exports.yex。菜单「添加新文件 → 导出清单 (.yex)」可再建。

操作	作用
刷新	按当前 `.yc` / `.yex`（含未保存编辑器）重扫导出表
勾选	多选后生成 `.yp` / 复制片段只含勾选项
双击行	跳转到函数定义源码
Y++片段	复制 `加载DLL` / `取导出函数` / `调用函数Ex`
C#片段	复制 `[DllImport]`（含 CallingConvention）
生成.yp	写入本工程 `源代码/{工程名}.yp`（带约定），并复制全文
调用	填参后跑同级宿主，结果写回面板
一键宿主	创建/更新同级 `{工程名}_host`
读PE	解析发布目录 `.dll` 的导出表
.yex 中 Ctrl+E	插入尚未导出的函数

@"MyLib.dll"
整数 相加(整数 a, 整数 b) 相加 stdcall
整数 Add(整数 a, 整数 b) 相加 stdcall

生成规则：

父目录/
  MyLib/           ← DLL 工程
  MyLib_host/      ← 一键测试创建的窗口工程

F5 编译 DLL 不会自动弹宿主。若尚无 .dll 会先编译本 DLL 再继续测试。

项目设置 → DLL 依赖清单：每行一个同级工程名或 xxx.dll；宿主 F5 / 发布时只拉清单中的项及源码/.yp 里出现的 "xxx.dll"。
VERSIONINFO：勾选「编译时写入」后，.dll 使用 VFT_DLL。

Y++	导出 ABI	说明
文本入参	`LPCWSTR`	空指针按 `L""`
文本返回	`LPCWSTR`	TLS 环形缓冲，调用方须立即拷贝
字节集入参	`const unsigned char *ptr, int len`	两参数
字节集返回	`const unsigned char ` + 末尾 `int out_len`	TLS；`out_len` 写长度
整数/逻辑/小数	`long long` / `int` / `double` 等

长整数 模块 = 加载DLL(".\\你的库.dll")
长整数 p = 取导出函数(模块, "相加")   ' 或 "Add"
整数 和 = 到整数(调用函数Ex(p, 2, 3))
释放DLL(模块)

把 dll 放在宿主工程根。路径须带 \\（如 .\\你的库.dll），否则 Windows 会先找真正的 exe 旁。

或使用生成的 .yp 别名直接调用。

动作	产物
F5 / 编译	`发布/{arch}/{cfg}/项目名.dll`（及 `.lib`）
发布打包	拷贝 `.dll`（及 `.lib`）；不生成安装包