feat: implement desktop app structure with API base URL handling and bindings for Wails integration

This commit is contained in:
wizardchen
2026-04-11 12:35:25 +08:00
committed by lyingbug
parent 5c4229745d
commit 52bdfd388a
11 changed files with 206 additions and 26 deletions
+38
View File
@@ -0,0 +1,38 @@
package main
import (
"context"
"strings"
)
// App holds Wails-bound state for the desktop shell.
type App struct {
ctx context.Context
backendURL string
shutdownCh chan struct{}
}
// NewApp creates a new App application struct.
func NewApp() *App {
return &App{
shutdownCh: make(chan struct{}, 1),
}
}
// startup is called when the application starts.
func (a *App) startup(ctx context.Context) {
a.ctx = ctx
}
func (a *App) shutdown(ctx context.Context) {
a.shutdownCh <- struct{}{}
}
// GetAPIBaseURL returns the local HTTP base URL for REST API calls (e.g. http://127.0.0.1:PORT/api/v1).
// The desktop shell proxies the webview to this address; window.location.origin is not the API host.
func (a *App) GetAPIBaseURL() string {
if a.backendURL == "" {
return ""
}
return strings.TrimRight(a.backendURL, "/") + "/api/v1"
}
+16 -24
View File
@@ -1,3 +1,5 @@
//go:build !bindings
package main
import (
@@ -10,6 +12,7 @@ import (
"os"
"os/signal"
"path/filepath"
"strconv"
"strings"
"syscall"
"time"
@@ -113,6 +116,13 @@ func main() {
if errPath == nil && strings.Contains(execPath, ".app/Contents/MacOS") {
resPath := filepath.Join(filepath.Dir(filepath.Dir(execPath)), "Resources")
_ = os.Chdir(resPath)
} else if _, err := os.Stat(filepath.Join("config", "config.yaml")); os.IsNotExist(err) {
// wails build 生成绑定时 cwd 多为 cmd/desktop,LoadConfig 默认找 ./config/config.yaml;
// 仓库实际配置在 <repo>/config/,向上两级即可。
repoRoot := filepath.Clean(filepath.Join("..", ".."))
if _, err := os.Stat(filepath.Join(repoRoot, "config", "config.yaml")); err == nil {
_ = os.Chdir(repoRoot)
}
}
// Load .env explicitly for the desktop app so DB_DRIVER gets loaded
@@ -246,6 +256,12 @@ func main() {
OnStartup: app.startup,
OnDomReady: func(ctx context.Context) {
wailsruntime.WindowExecJS(ctx, dragHandlerJS)
// 注入真实 API 根路径(与 window.location.origin 不同);无 Go 绑定时仍可显示。
if u := strings.TrimSpace(app.backendURL); u != "" {
apiRoot := strings.TrimRight(u, "/") + "/api/v1"
inject := fmt.Sprintf(`try{window.__WEKNORA_API_BASE__=%s}catch(e){}`, strconv.Quote(apiRoot))
wailsruntime.WindowExecJS(ctx, inject)
}
},
OnShutdown: app.shutdown,
Bind: []interface{}{
@@ -264,30 +280,6 @@ func main() {
}
}
// App struct
type App struct {
ctx context.Context
backendURL string
shutdownCh chan struct{}
}
// NewApp creates a new App application struct
func NewApp() *App {
return &App{
shutdownCh: make(chan struct{}, 1),
}
}
// startup is called when the app starts. The context is saved
// so we can call the runtime methods
func (a *App) startup(ctx context.Context) {
a.ctx = ctx
}
func (a *App) shutdown(ctx context.Context) {
a.shutdownCh <- struct{}{}
}
func configureDesktopStorage(execPath string) {
if execPath == "" || !strings.Contains(execPath, ".app/Contents/MacOS") {
return
+17
View File
@@ -0,0 +1,17 @@
//go:build bindings
package main
import (
"github.com/wailsapp/wails/v2"
"github.com/wailsapp/wails/v2/pkg/options"
)
// Wails「生成绑定」阶段使用 -tags bindings 单独编译本文件,不启动 Gin/数据库,避免依赖本机 Postgres。
func main() {
app := NewApp()
_ = wails.Run(&options.App{
Title: "WeKnora Lite",
Bind: []interface{}{app},
})
}