Leo
fcdb1df71d
leo 真機測出四個問題，每個都查到真兇後才動手： ## ① 托盤 icon 變方塊 真兇：我塞 1024x1024 的**彩色 app icon** 當 template icon。 macOS 選單列規格是 **16-22pt、純黑＋alpha**（由系統依深淺色自動上色） ⇒ 彩色大圖被縮成一坨方塊是必然。 修：用 CIS 的 chevron-double.svg 渲成 44x44 純黑 template icon。 ## ②③ 右鍵沒選單／第一次能開之後就不再跳 真兇（energye/systray 原始碼註解白紙黑字寫著）： 「該方法主動調用後 如果托盤菜單已創建則添加進去, **之後鼠標事件失效**」 ⇒ 只要用 AddMenuItem 建了選單，SetOnClick／SetOnRClick **全部失效**。 修：SetMenuNil() 移除選單讓滑鼠事件生效，右鍵時自己 ShowMenu()。 另外 ShowWindow 只呼叫 WindowShow 對「已開但被蓋住」無效 ⇒ 補 Unminimise ＋ AlwaysOnTop 閃一下搶焦點。 ## ④ 只能用強制結束 真兇：Wails 的 loop 不理 SIGTERM，且 collector 是我們自己 Start 的子行程 ⇒ 主程式被殺後**子行程變孤兒繼續跑**。 實測（機械驗證，非目視）： 修前 kill -TERM → App 沒退、collector 孤兒還在 修後 kill -TERM → App 正常退出 ✅、collector 一起收掉 ✅、殘留 0 修：installSignalHandler 收 TERM/INT → stopSupervisor() → waitCollectorGone(3s) 確認子行程真的不見（逾時補一刀）→ 才 os.Exit。 「關了卻還在同步」比沒關更糟。 實跑驗證：App 活著 pid 88466、自己拉起 collector、crash 0、兩支機械閘全過。
116 lines
4.8 KiB
Go
116 lines
4.8 KiB
Go
package main
|
||
|
||
import (
|
||
"context"
|
||
"embed"
|
||
|
||
"github.com/energye/systray"
|
||
"github.com/wailsapp/wails/v2"
|
||
"github.com/wailsapp/wails/v2/pkg/options"
|
||
"github.com/wailsapp/wails/v2/pkg/options/assetserver"
|
||
wruntime "github.com/wailsapp/wails/v2/pkg/runtime"
|
||
)
|
||
|
||
//go:embed all:frontend/dist
|
||
var assets embed.FS
|
||
|
||
//go:embed build/trayicon.png
|
||
var trayIcon []byte
|
||
|
||
type wailsCtx = context.Context
|
||
|
||
// 版本號由 build 時 -ldflags 注入（同 arcrun-tray 的規矩）。
|
||
var version = "dev"
|
||
|
||
func main() {
|
||
app := NewApp()
|
||
|
||
// 🔴 托盤必須在**主執行緒**建立（NSStatusItem 內部會 new NSWindow，
|
||
// AppKit 規定 NSWindow 只能在主執行緒 new）。
|
||
// 踩過的兩個錯（都真機實測炸掉）：
|
||
// ① systray.Run() 自己開 loop ⇒ 與 Wails 搶主 loop ⇒ SIGTRAP
|
||
// ② 在 OnStartup 或 goroutine 裡呼叫 ⇒ 「NSWindow should only be
|
||
// instantiated on the main thread!」⇒ SIGABRT
|
||
// 正解：main() 一開始（還在主執行緒）就 RunWithExternalLoop 註冊並 start，
|
||
// 它不阻塞，接著再把主執行緒交給 wails.Run()。
|
||
setupTray(app)
|
||
trayStart()
|
||
installSignalHandler() // 收到 TERM/INT 要能正常退出（不必強制結束）
|
||
defer trayEnd()
|
||
|
||
err := wails.Run(&options.App{
|
||
Title: "Arcrun",
|
||
Width: 1000, Height: 700,
|
||
MinWidth: 820, MinHeight: 560,
|
||
AssetServer: &assetserver.Options{Assets: assets},
|
||
OnStartup: func(ctx wailsCtx) {
|
||
app.startup(ctx)
|
||
startSupervisor() // 🔴 daemon 本體：不啟動就不會同步
|
||
// 🔴 托盤必須在**主執行緒**建立（NSStatusItem 會 new NSWindow）。
|
||
// OnStartup 不是主執行緒 ⇒ 直接呼叫會炸
|
||
// 「NSWindow should only be instantiated on the main thread!」（實測）。
|
||
// 用 Wails 的 dispatch 把它丟回主執行緒。
|
||
|
||
},
|
||
// 🔴 daemon 是常駐程式：關窗只是收起來，**不能真的結束**
|
||
// （結束＝停止看守資料夾，使用者不會預期按 × 就不再同步）。
|
||
OnBeforeClose: func(ctx wailsCtx) bool {
|
||
wruntime.WindowHide(ctx)
|
||
return true // true＝攔下關閉
|
||
},
|
||
HideWindowOnClose: true,
|
||
// Dock 不出現 icon：Wails v2.13 的 mac.ActivationPolicy 還沒開放（原始碼裡是註解掉的），
|
||
// 改走 Info.plist 的 LSUIElement（與 fyne 版同一個做法，見 build/darwin/Info.plist）。
|
||
Bind: []interface{}{app},
|
||
})
|
||
if err != nil {
|
||
println("Error:", err.Error())
|
||
}
|
||
}
|
||
|
||
// setupTray 建立選單列 icon。
|
||
//
|
||
// 🔴 leo 2026-08-05：「依照 google drive，托盤裡**只剩下按右鍵會結束**，
|
||
//
|
||
// 其他設定都在這個頁面，**點擊托盤的 icon 就立刻展開界面**」
|
||
//
|
||
// ⇒ 左鍵＝直接開視窗（不彈選單）；右鍵＝只有一項「結束 Arcrun」。
|
||
//
|
||
// 所有設定都在視窗裡，托盤不再是第二套 UI（fyne 版把設定塞在下拉選單，
|
||
// leo：「daemon 設定項越來越多，不可能統統塞在下拉選單」）。
|
||
//
|
||
// 🔴 **不可以用 systray.Run() 開自己的迴圈**（我第一版這樣寫，真機一跑就 SIGTRAP）：
|
||
//
|
||
// macOS 的選單列必須在**主執行緒**跑，Wails 已經佔著那條 loop，
|
||
// 兩個 toolkit 搶主 loop ⇒ `signal arrived during cgo execution` 直接崩。
|
||
// 正解是 `RunWithExternalLoop`——它只註冊、把 start/end 交給既有的 loop 呼叫。
|
||
var trayStart, trayEnd = func() {}, func() {}
|
||
|
||
func setupTray(app *App) {
|
||
trayStart, trayEnd = systray.RunWithExternalLoop(func() {
|
||
// ① icon：**必須是 template icon**——選單列規格是 16-22pt、純黑＋alpha，
|
||
// 由系統依深淺色自動上色。先前塞 1024x1024 的彩色 app icon
|
||
// ⇒ 縮成一坨方塊（leo 實測）。改用 CIS 的 double chevron 渲成 44x44 純黑。
|
||
systray.SetTemplateIcon(trayIcon, trayIcon)
|
||
systray.SetTooltip("Arcrun — 你的知識庫同步小幫手")
|
||
|
||
// 🔴 ②③ 的真兇（energye/systray 原始碼註解寫得很清楚）：
|
||
// 「該方法主動調用後 如果托盤菜單已創建則添加進去, **之後鼠標事件失效**」
|
||
// ⇒ 只要用 AddMenuItem 建了選單，左右鍵 handler **全部失效**
|
||
// ⇒ leo 實測「右鍵沒跳出 quit」「第一次能開之後就不再跳」。
|
||
// 正解：SetMenuNil() 移除選單讓滑鼠事件生效，右鍵時**自己叫出選單**。
|
||
quit := systray.AddMenuItem("結束 Arcrun", "停止同步並關閉")
|
||
quit.Click(func() { app.Quit() })
|
||
systray.SetMenuNil() // ← 沒有這行，下面兩個 handler 都不會被呼叫
|
||
|
||
// 左鍵：立刻展開主視窗（leo：「點擊托盤的 icon 就立刻展開界面」）
|
||
systray.SetOnClick(func(menu systray.IMenu) { app.ShowWindow() })
|
||
// 右鍵：把選單叫出來（只有「結束 Arcrun」一項）
|
||
systray.SetOnRClick(func(menu systray.IMenu) {
|
||
if menu != nil {
|
||
_ = menu.ShowMenu()
|
||
}
|
||
})
|
||
}, nil)
|
||
}
|