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:
1 parent
bb794b7d81
commit
81c90ed060
6 files changed
+149
-27
No files matched your search
@@ -147,6 +147,41 @@ npx electron-packager . XiaoyinMarkdown --platform=win32 --arch=x64 --out=dist ^
|
|||||||
|
|
||||||
打包完成后把 `dist\XiaoyinMarkdown-win32-x64` 整个目录拷到 `%USERPROFILE%\Apps\XiaoyinMarkdown` 覆盖即可(exe 依赖同目录的 dll,不能只拷 exe)。
|
打包完成后把 `dist\XiaoyinMarkdown-win32-x64` 整个目录拷到 `%USERPROFILE%\Apps\XiaoyinMarkdown` 覆盖即可(exe 依赖同目录的 dll,不能只拷 exe)。
|
||||||
|
|
||||||
|
## 用 Tauri 打包(推荐的安装包)
|
||||||
|
|
||||||
|
Tauri 版走系统 WebView2,**安装包只有 1.6 MB**(Electron 版 152 MB)。
|
||||||
|
在 Linux 上也能交叉编译出 Windows 安装包:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
# 一次性准备
|
||||||
|
apt-get install -y mingw-w64 nsis
|
||||||
|
curl -sSf https://sh.rustup.rs | sh -s -- -y --profile minimal # 国内可设 RUSTUP_DIST_SERVER 用清华镜像
|
||||||
|
rustup target add x86_64-pc-windows-gnu
|
||||||
|
mkdir -p ~/.cargo && cat >> ~/.cargo/config.toml <<'EOF'
|
||||||
|
[target.x86_64-pc-windows-gnu]
|
||||||
|
linker = "x86_64-w64-mingw32-gcc"
|
||||||
|
ar = "x86_64-w64-mingw32-ar"
|
||||||
|
EOF
|
||||||
|
|
||||||
|
# 打包
|
||||||
|
npm install
|
||||||
|
npx tauri build --target x86_64-pc-windows-gnu --bundles nsis
|
||||||
|
# → src-tauri/target/x86_64-pc-windows-gnu/release/bundle/nsis/XiaoyinMarkdown_<版本>_x64-setup.exe
|
||||||
|
```
|
||||||
|
|
||||||
|
### 装完 .md 默认用小银 Markdown 打开
|
||||||
|
|
||||||
|
两步配合,缺一不可:
|
||||||
|
|
||||||
|
1. `tauri.conf.json` 的 `bundle.fileAssociations` → 写 `HKCU\Software\Classes\.md` = `XiaoyinMarkdown.Document`
|
||||||
|
(含 markdown / mdown / mkd / mdwn / txt)
|
||||||
|
2. `src-tauri/installer-hooks.nsh`(NSIS `NSIS_HOOK_POSTINSTALL`)→ 删掉
|
||||||
|
`HKCU\...\Explorer\FileExts\.md\UserChoice`。这个键带哈希保护、**只能删不能写**,
|
||||||
|
删掉后系统才回落到第 1 步写的关联,否则用户原来的默认程序会一直赢。
|
||||||
|
|
||||||
|
首次双击 .md 时是冷启动,文件路径由 Rust 的 `on_page_load` 读 `argv` 发给前端
|
||||||
|
(`main.rs` 里的 `STARTUP_FILE_SENT`);程序已在运行时再双击,走 single-instance 回调。
|
||||||
|
|
||||||
## 说明
|
## 说明
|
||||||
|
|
||||||
- 未做代码签名,首次运行 Windows SmartScreen 可能提示"未知发布者",选"仍要运行"即可。
|
- 未做代码签名,首次运行 Windows SmartScreen 可能提示"未知发布者",选"仍要运行"即可。
|
||||||
|
|||||||
+12
-10
@@ -59,20 +59,22 @@ docker exec 1Panel-openresty-npAh nginx -s reload # 一般不需要,静态
|
|||||||
|
|
||||||
## 更新安装包
|
## 更新安装包
|
||||||
|
|
||||||
```bash
|
官网主下载项是 **Tauri 安装包**(1.6 MB,装完 .md 默认用它打开):
|
||||||
# 1) 本地打包(Linux 上交叉打包 Windows)
|
|
||||||
npm install
|
|
||||||
npx electron-packager . XiaoyinMarkdown --platform=win32 --arch=x64 --out=dist \
|
|
||||||
--overwrite --asar --icon=build/icon.ico --app-version=2.6.1 \
|
|
||||||
--ignore="^/dist" --ignore="^/tools" --ignore="^/build" --ignore="^/site" \
|
|
||||||
--ignore="^/src-tauri" --ignore="^/\\.git"
|
|
||||||
|
|
||||||
# 2) 压缩并发布
|
```bash
|
||||||
cd dist && zip -qr -9 XiaoyinMarkdown-win32-x64.zip XiaoyinMarkdown-win32-x64 && cd ..
|
# 1) 交叉编译 Windows 安装包(详见仓库 README「用 Tauri 打包」)
|
||||||
cp dist/XiaoyinMarkdown-win32-x64.zip \
|
npx tauri build --target x86_64-pc-windows-gnu --bundles nsis
|
||||||
|
|
||||||
|
# 2) 发布
|
||||||
|
R=src-tauri/target/x86_64-pc-windows-gnu/release
|
||||||
|
cp $R/bundle/nsis/XiaoyinMarkdown_2.6.1_x64-setup.exe \
|
||||||
/opt/1panel/www/sites/md.wangjinding.com/index/download/
|
/opt/1panel/www/sites/md.wangjinding.com/index/download/
|
||||||
|
cp $R/xiaoyin-markdown.exe \
|
||||||
|
/opt/1panel/www/sites/md.wangjinding.com/index/download/XiaoyinMarkdown-portable.exe
|
||||||
```
|
```
|
||||||
|
|
||||||
|
旧版 Electron 构建(`XiaoyinMarkdown-win32-x64.zip`,152 MB)仍保留在 `download/` 里。
|
||||||
|
|
||||||
## 坑
|
## 坑
|
||||||
|
|
||||||
- **WAF 白名单**:不往 `sites.json` 加 `{"key": "<域名>", "host": ["<域名>:8082"]}`,
|
- **WAF 白名单**:不往 `sites.json` 加 `{"key": "<域名>", "host": ["<域名>:8082"]}`,
|
||||||
|
|||||||
+28
-11
@@ -189,7 +189,7 @@
|
|||||||
<a class="btn btn-ghost" href="https://github.com/wangjinding/xiaoyin-markdown" target="_blank" rel="noopener">查看源码</a>
|
<a class="btn btn-ghost" href="https://github.com/wangjinding/xiaoyin-markdown" target="_blank" rel="noopener">查看源码</a>
|
||||||
</div>
|
</div>
|
||||||
<p class="meta">
|
<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>
|
</p>
|
||||||
|
|
||||||
<div class="shot" aria-hidden="true">
|
<div class="shot" aria-hidden="true">
|
||||||
@@ -299,15 +299,30 @@
|
|||||||
<p class="sub">免安装,解压即用。程序只读写你主动打开或保存的文件,不联网。</p>
|
<p class="sub">免安装,解压即用。程序只读写你主动打开或保存的文件,不联网。</p>
|
||||||
<div class="grid">
|
<div class="grid">
|
||||||
<div class="card">
|
<div class="card">
|
||||||
<h3><span class="ico">↓</span>Windows 便携版</h3>
|
<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 · 解压到任意目录,双击 <code>XiaoyinMarkdown.exe</code> 运行。</p>
|
<p style="margin-bottom:14px">
|
||||||
<a class="btn btn-primary" href="/download/XiaoyinMarkdown-win32-x64.zip" download>下载 .zip</a>
|
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>
|
||||||
<div class="card">
|
<div class="card">
|
||||||
<h3><span class="ico">⌥</span>其它方式</h3>
|
<h3><span class="ico">⚏</span>免安装版</h3>
|
||||||
<p style="margin-bottom:14px">源码在 Gitea / GitHub,可自行打包;也可以只把 exe 覆盖到已有目录升级。</p>
|
<p style="margin-bottom:14px">
|
||||||
<a class="btn btn-ghost" href="https://github.com/wangjinding/xiaoyin-markdown" target="_blank" rel="noopener">GitHub 仓库</a>
|
单个 exe,<b>3.5 MB</b>,放哪都能跑,不写注册表、不改文件关联。<br>
|
||||||
<a class="btn btn-ghost" href="https://git.wangjinding.com/Jidekin/xiaoyin-markdown" target="_blank" rel="noopener">Gitea 仓库</a>
|
适合放 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>
|
</div>
|
||||||
<div class="callout">
|
<div class="callout">
|
||||||
@@ -321,9 +336,11 @@
|
|||||||
<div class="wrap">
|
<div class="wrap">
|
||||||
<h2>关于</h2>
|
<h2>关于</h2>
|
||||||
<p class="sub">
|
<p class="sub">
|
||||||
小银 Markdown 是一个纯本地的 Windows 桌面编辑器,界面用 Electron + 自写的零依赖 Markdown 渲染引擎,
|
小银 Markdown 是一个纯本地的 Windows 桌面编辑器,界面是同一套自写的零依赖 Markdown 渲染引擎,桌面壳有两条:
|
||||||
桌面能力(剪贴板文件、快捷方式等)通过 <code>koffi</code> 直接调用 Win32 API。
|
</p><p class="sub">
|
||||||
另有一套 Tauri 2 的桌面壳在 <code>src-tauri/</code>,可按需切换。
|
<b>安装版(默认下载)</b>走 Tauri 2 + 系统 WebView2,安装包只有 1.6 MB,
|
||||||
|
桌面能力(剪贴板文件、文件关联等)由 Rust 直接调 Win32;
|
||||||
|
<b>Electron 版</b>仍保留在仓库里(<code>src/main.js</code>),体积大但自带运行时。
|
||||||
</p>
|
</p>
|
||||||
<div class="grid">
|
<div class="grid">
|
||||||
<div class="card">
|
<div class="card">
|
||||||
|
|||||||
@@ -0,0 +1,34 @@
|
|||||||
|
; ── 小银 Markdown NSIS 安装钩子 ────────────────────────────────────────────
|
||||||
|
; 目标:安装完成后,双击 .md 默认就用小银 Markdown 打开。
|
||||||
|
;
|
||||||
|
; 背景:Tauri 的 fileAssociations 会写 HKCU\Software\Classes 下的关联,但 Windows 10/11
|
||||||
|
; 还有一个带哈希保护的「用户选择」键:
|
||||||
|
; HKCU\Software\Microsoft\Windows\CurrentVersion\Explorer\FileExts\.md\UserChoice
|
||||||
|
; 它优先级**最高**,而且不能直接写(哈希由系统算)。但它可以**删** ——
|
||||||
|
; 删掉之后系统就回落到我们刚写的 HKCU\Software\Classes 关联,等于把默认打开方式交给本程序。
|
||||||
|
;
|
||||||
|
; 只动 HKCU(安装模式是 currentUser),不需要管理员权限。
|
||||||
|
|
||||||
|
!macro NSIS_HOOK_POSTINSTALL
|
||||||
|
DeleteRegKey HKCU "Software\Microsoft\Windows\CurrentVersion\Explorer\FileExts\.md\UserChoice"
|
||||||
|
DeleteRegKey HKCU "Software\Microsoft\Windows\CurrentVersion\Explorer\FileExts\.markdown\UserChoice"
|
||||||
|
DeleteRegKey HKCU "Software\Microsoft\Windows\CurrentVersion\Explorer\FileExts\.mdown\UserChoice"
|
||||||
|
DeleteRegKey HKCU "Software\Microsoft\Windows\CurrentVersion\Explorer\FileExts\.mkd\UserChoice"
|
||||||
|
DeleteRegKey HKCU "Software\Microsoft\Windows\CurrentVersion\Explorer\FileExts\.mdwn\UserChoice"
|
||||||
|
DeleteRegKey HKCU "Software\Microsoft\Windows\CurrentVersion\Explorer\FileExts\.txt\UserChoice"
|
||||||
|
|
||||||
|
; 让资源管理器立刻刷新图标与「打开方式」缓存(SHCNE_ASSOCCHANGED)
|
||||||
|
System::Call 'shell32::SHChangeNotify(l 0x08000000, l 0, l 0, l 0)'
|
||||||
|
!macroend
|
||||||
|
|
||||||
|
!macro NSIS_HOOK_POSTUNINSTALL
|
||||||
|
; 卸载时一并清掉可能残留的关联(不怕清不到)
|
||||||
|
DeleteRegKey HKCU "Software\Classes\.md"
|
||||||
|
DeleteRegKey HKCU "Software\Classes\.markdown"
|
||||||
|
DeleteRegKey HKCU "Software\Classes\.mdown"
|
||||||
|
DeleteRegKey HKCU "Software\Classes\.mkd"
|
||||||
|
DeleteRegKey HKCU "Software\Classes\.mdwn"
|
||||||
|
DeleteRegKey HKCU "Software\Classes\XiaoyinMarkdown.Document"
|
||||||
|
DeleteRegKey HKCU "Software\Classes\XiaoyinMarkdown.Text"
|
||||||
|
System::Call 'shell32::SHChangeNotify(l 0x08000000, l 0, l 0, l 0)'
|
||||||
|
!macroend
|
||||||
@@ -9,6 +9,9 @@ use tauri_plugin_dialog::DialogExt;
|
|||||||
|
|
||||||
const MD_EXTS: [&str; 6] = ["md", "markdown", "mdown", "mkd", "mdwn", "txt"];
|
const MD_EXTS: [&str; 6] = ["md", "markdown", "mdown", "mkd", "mdwn", "txt"];
|
||||||
|
|
||||||
|
/// 首次启动时 argv 里的文件只发一次(页面重载/多窗口不重复发)
|
||||||
|
static STARTUP_FILE_SENT: std::sync::Once = std::sync::Once::new();
|
||||||
|
|
||||||
/* ---------------- 数据结构 ---------------- */
|
/* ---------------- 数据结构 ---------------- */
|
||||||
|
|
||||||
#[derive(Serialize, Clone)]
|
#[derive(Serialize, Clone)]
|
||||||
@@ -461,6 +464,22 @@ fn migrate_apply(app: AppHandle, mode: String, docs: Vec<serde_json::Value>, kee
|
|||||||
fn main() {
|
fn main() {
|
||||||
tauri::Builder::default()
|
tauri::Builder::default()
|
||||||
.plugin(tauri_plugin_dialog::init())
|
.plugin(tauri_plugin_dialog::init())
|
||||||
|
// 双击 .md 用本程序打开时的「首次启动」路径:
|
||||||
|
// · 首次启动(进程还不存在)→ 页面加载完成后把 argv 里的文件发给前端
|
||||||
|
// · 已在运行(再双击另一个文件)→ 走下面的 single_instance 回调
|
||||||
|
// 用 Once 保证只发一次,避免页面重载时反复打开同一个文件。
|
||||||
|
.on_page_load(|webview, payload| {
|
||||||
|
if payload.event() == tauri::webview::PageLoadEvent::Finished {
|
||||||
|
STARTUP_FILE_SENT.call_once(|| {
|
||||||
|
if let Some(path) = std::env::args()
|
||||||
|
.skip(1)
|
||||||
|
.find(|a| PathBuf::from(a).is_file())
|
||||||
|
{
|
||||||
|
let _ = webview.emit("open-external", path);
|
||||||
|
}
|
||||||
|
});
|
||||||
|
}
|
||||||
|
})
|
||||||
.plugin(tauri_plugin_single_instance::init(|app, argv, _cwd| {
|
.plugin(tauri_plugin_single_instance::init(|app, argv, _cwd| {
|
||||||
if let Some(win) = app.get_webview_window("main") {
|
if let Some(win) = app.get_webview_window("main") {
|
||||||
let _ = win.set_focus();
|
let _ = win.set_focus();
|
||||||
|
|||||||
@@ -25,17 +25,29 @@
|
|||||||
},
|
},
|
||||||
"bundle": {
|
"bundle": {
|
||||||
"active": true,
|
"active": true,
|
||||||
"targets": ["nsis"],
|
"targets": [
|
||||||
"icon": ["icons/icon.ico"],
|
"nsis"
|
||||||
|
],
|
||||||
|
"icon": [
|
||||||
|
"icons/icon.ico"
|
||||||
|
],
|
||||||
"fileAssociations": [
|
"fileAssociations": [
|
||||||
{
|
{
|
||||||
"ext": ["md", "markdown", "mdown", "mkd", "mdwn"],
|
"ext": [
|
||||||
|
"md",
|
||||||
|
"markdown",
|
||||||
|
"mdown",
|
||||||
|
"mkd",
|
||||||
|
"mdwn"
|
||||||
|
],
|
||||||
"name": "XiaoyinMarkdown.Document",
|
"name": "XiaoyinMarkdown.Document",
|
||||||
"description": "Markdown 文档 — 小银 Markdown",
|
"description": "Markdown 文档 — 小银 Markdown",
|
||||||
"role": "Editor"
|
"role": "Editor"
|
||||||
},
|
},
|
||||||
{
|
{
|
||||||
"ext": ["txt"],
|
"ext": [
|
||||||
|
"txt"
|
||||||
|
],
|
||||||
"name": "XiaoyinMarkdown.Text",
|
"name": "XiaoyinMarkdown.Text",
|
||||||
"description": "文本文档 — 小银 Markdown",
|
"description": "文本文档 — 小银 Markdown",
|
||||||
"role": "Editor"
|
"role": "Editor"
|
||||||
@@ -47,10 +59,13 @@
|
|||||||
},
|
},
|
||||||
"nsis": {
|
"nsis": {
|
||||||
"installMode": "currentUser",
|
"installMode": "currentUser",
|
||||||
"languages": ["SimpChinese"],
|
"languages": [
|
||||||
|
"SimpChinese"
|
||||||
|
],
|
||||||
"displayLanguageSelector": false,
|
"displayLanguageSelector": false,
|
||||||
"installerIcon": "icons/icon.ico",
|
"installerIcon": "icons/icon.ico",
|
||||||
"uninstallerIcon": "icons/icon.ico"
|
"uninstallerIcon": "icons/icon.ico",
|
||||||
|
"installerHooks": "installer-hooks.nsh"
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|||||||
Reference in new issue
Block a user