feat(build): Tauri 交叉编译出 Windows 安装包(1.6MB),装完 .md 默认用它打开

老板要求:用 Tauri 打包成 exe,安装后 .md 默认由小银 Markdown 打开。

一、交叉编译(Linux → Windows,无需 Windows 机器)
本机从零装了 rustc 1.100 / mingw-w64(GCC 14)/ NSIS 3.11,
target `x86_64-pc-windows-gnu`,crates 走清华镜像:
  npx tauri build --target x86_64-pc-windows-gnu --bundles nsis
产物:
  · XiaoyinMarkdown_2.6.1_x64-setup.exe  1.52 MiB(NSIS 安装包)
  · xiaoyin-markdown.exe                  3.5 MiB(免安装版)
electron-packager 那版是 152 MiB —— 因为 Tauri 用系统 WebView2,不捆绑运行时。
已核对导入表:只依赖系统 DLL + 安装包内自带的 WebView2Loader.dll,
没有 libgcc_s_seh-1 / libwinpthread 之类的 mingw 运行时依赖,干净 Windows 可跑。

二、默认打开方式(两步,缺一不可)
1. tauri.conf.json 的 fileAssociations 早就配了 md/markdown/mdown/mkd/mdwn/txt;
   已核对生成的 installer.nsi:6 条 APP_ASSOCIATE,写
   HKCU\Software\Classes\.md = XiaoyinMarkdown.Document(默认 ProgId,不只是「打开方式」列表)
2. 新增 src-tauri/installer-hooks.nsh(NSIS_HOOK_POSTINSTALL):
   删掉 HKCU\...\Explorer\FileExts\.md\UserChoice —— 这个键带哈希保护、只能删不能写,
   不删的话用户原来的默认程序永远赢;删完再 SHChangeNotify 刷新图标缓存。
   已用「故意 !error 探针」证明该钩子确实被 makensis 编译进去(installer.nsi:758),
   不是写了没生效。

三、首次双击 .md 能打开文件
原来只有 single_instance 回调处理 argv(= 程序已在运行时才生效)。
新增 on_page_load(Finished) + std::sync::Once:冷启动时把 argv 里的文件路径
emit 给前端(前端 tauri-bridge 监听 open-external → doOpenPath)。

四、官网
下载区改成三档:安装版(1.6MB,推荐)/ 免安装 exe(3.5MB)/ 源码 + 旧 Electron 版。
两个新文件已部署到 /download/,公网 200。

README 补了「用 Tauri 打包」整节(含 UserChoice 这个坑),site/README 更新发布步骤。
This commit is contained in:
Jidekin committed 2026-11-19 20:00:55 +08:00
1 parent 29fc7ef3ff
commit 793eb56710
6 files changed
+150 -28

No files matched your search

+28 -11
View File
@@ -189,7 +189,7 @@
<a class="btn btn-ghost" href="https://github.com/wangjinding/xiaoyin-markdown" target="_blank" rel="noopener">查看源码</a>
</div>
<p class="meta">
<span>Windows 10 / 11 · x64</span><span>免安装便携版</span><span>MIT 开源</span>
<span>Windows 10 / 11 · x64</span><span>安装包仅 1.6 MB</span><span>MIT 开源</span>
</p>
<div class="shot" aria-hidden="true">
@@ -299,15 +299,30 @@
<p class="sub">免安装,解压即用。程序只读写你主动打开或保存的文件,不联网。</p>
<div class="grid">
<div class="card">
<h3><span class="ico">↓</span>Windows 便携版</h3>
<p style="margin-bottom:14px">x64 · Windows 10 / 11 · 解压到任意目录,双击 <code>XiaoyinMarkdown.exe</code> 运行。</p>
<a class="btn btn-primary" href="/download/XiaoyinMarkdown-win32-x64.zip" download>下载 .zip</a>
<h3><span class="ico">↓</span>安装版 <span style="font-size:12px;color:var(--ok);font-weight:600">推荐</span></h3>
<p style="margin-bottom:14px">
x64 · Windows 10 / 11 · <b>1.6 MB</b>。<br>
装完 <b>双击 .md 就直接用小银 Markdown 打开</b>(.markdown / .mdown / .mkd / .mdwn 同理),
开始菜单有快捷方式,可在「设置 → 应用」里正常卸载。
</p>
<a class="btn btn-primary" href="/download/XiaoyinMarkdown_2.6.1_x64-setup.exe" download>下载安装包 .exe</a>
</div>
<div class="card">
<h3><span class="ico">⌥</span>其它方式</h3>
<p style="margin-bottom:14px">源码在 Gitea / GitHub,可自行打包;也可以只把 exe 覆盖到已有目录升级。</p>
<a class="btn btn-ghost" href="https://github.com/wangjinding/xiaoyin-markdown" target="_blank" rel="noopener">GitHub 仓库</a>
<a class="btn btn-ghost" href="https://git.wangjinding.com/Jidekin/xiaoyin-markdown" target="_blank" rel="noopener">Gitea 仓库</a>
<h3><span class="ico">⚏</span>免安装版</h3>
<p style="margin-bottom:14px">
单个 exe,<b>3.5 MB</b>,放哪都能跑,不写注册表、不改文件关联。<br>
适合放 U 盘或不想装东西的时候。
</p>
<a class="btn btn-ghost" href="/download/XiaoyinMarkdown-portable.exe" download>下载便携版 .exe</a>
</div>
<div class="card">
<h3><span class="ico">⌥</span>源码 / 旧版</h3>
<p style="margin-bottom:14px">
源码在 Gitea / GitHub,可自行打包。<br>
旧版 Electron 构建(152 MB,自带运行时)仍在:<a href="/download/XiaoyinMarkdown-win32-x64.zip">zip 下载</a>。
</p>
<a class="btn btn-ghost" href="https://github.com/wangjinding/xiaoyin-markdown" target="_blank" rel="noopener">GitHub</a>
<a class="btn btn-ghost" href="https://git.wangjinding.com/Jidekin/xiaoyin-markdown" target="_blank" rel="noopener">Gitea</a>
</div>
</div>
<div class="callout">
@@ -321,9 +336,11 @@
<div class="wrap">
<h2>关于</h2>
<p class="sub">
小银 Markdown 是一个纯本地的 Windows 桌面编辑器,界面用 Electron + 自写的零依赖 Markdown 渲染引擎,
桌面能力(剪贴板文件、快捷方式等)通过 <code>koffi</code> 直接调用 Win32 API。
另有一套 Tauri 2 的桌面壳在 <code>src-tauri/</code>,可按需切换。
小银 Markdown 是一个纯本地的 Windows 桌面编辑器,界面是同一套自写的零依赖 Markdown 渲染引擎,桌面壳有两条:
</p><p class="sub">
<b>安装版(默认下载)</b>走 Tauri 2 + 系统 WebView2,安装包只有 1.6 MB,
桌面能力(剪贴板文件、文件关联等)由 Rust 直接调 Win32;
<b>Electron 版</b>仍保留在仓库里(<code>src/main.js</code>),体积大但自带运行时。
</p>
<div class="grid">
<div class="card">