Files
ele-HeiXiu/electron/main/utils/logo.ts
YoungestSongMo 767bb8b297 feat: 初始化船长·HeiXiu 桌面应用项目(错误是svg的问题)
Electron + React 19 + TypeScript + Ant Design 6 + Tailwind CSS 4

  【核心架构】
  - Electron 主进程(窗口管理、平台检测、图标适配)
  - Vite 构建链(双产物 dist/ + dist-electron/)
  - 共享层 shared/(类型、常量、工具函数)
  - IPC 通信框架 + 安全守卫

  【主题系统】
  - 蓝紫渐变主题(亮色/暗色双模式)
  - Ant Design ConfigProvider 适配(lightAlgorithm / darkAlgorithm)
  - Tailwind CSS 4 @theme 指令 + CSS 变量
  - 设计令牌三处同步(tokens.ts / globals.css / antd-theme.ts)

  【导航栏】
  - 自定义 H5 导航栏替代系统菜单
  - 个人版/企业版双布局
  - 未登录拦截 + 事件总线驱动登录弹窗

  【登录注册】
  - Modal 弹层(Portal)+ Tabs 切换
  - 登录/注册表单动态字段渲染
  - 记住密码 / 自动登录 / 用户协议

  【更新系统】
  - 自定义 API 版本检查(替代 electron-updater generic provider)
  - 手动下载 + SHA512 校验 + spawn NSIS 安装
  - 渲染进程更新状态机 Hook(useUpdater)
  - 检查更新按钮 + 下载进度展示

  【构建工具链】
  - build.mjs 构建总管(--win/--mac/--linux --personal/--enterprise --build/--clean/--sign/--upload/--publish)
  - scripts/ 自动化脚本(clean / generate-update-info / upload-oss / publish-release)
  - electron-builder NSIS 安装器(可选路径、多版本打包)
  - update-info.json 自动生成(fileSize/sha512/changelog/releaseDate)

  【代码质量】
  - ESLint + TypeScript strict + Prettier
  - husky + lint-staged(提交前自动检查)
  - commitlint(规范提交信息)
  - Playwright E2E + Vitest 单元测试框架
  - rollup-plugin-visualizer 打包体积分析

  【文档】
  - README.md(快速开始 + 目录结构 + 命令速查)
  - UpdateA.md(发布手册:API/签名/发版流程/数据库)
  - CHANGELOG.md(更新日志)
  - .env.example(构建环境变量模板)
2026-06-03 15:00:51 +08:00

101 lines
2.7 KiB
TypeScript
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
// ============================================================
// 主进程 Logo 自适应工具
// 根据平台返回正确的图标路径,处理 .ico / .png / .icns 格式差异
// ============================================================
import path from 'node:path';
import { isMacOS, isWindows } from './platform';
// Logo 资源目录(相对于构建后的 dist-electron 目录或开发时的 electron/ 目录)
// 开发时 app.getAppPath() 指向项目根目录
// 生产时指向 app.asar 所在目录
/** Logo 目录在项目中的相对路径 */
const LOGO_DIR = 'src/assets/logo';
/**
* 获取 Logo 资源目录的绝对路径
* @param appPath - Electron app.getAppPath() 的返回值
*/
export function getLogoDir(appPath: string): string {
return path.join(appPath, LOGO_DIR);
}
/**
* 按平台获取窗口图标路径
*
* 平台格式要求:
* Windows → .ico支持多尺寸
* macOS → .icns首选或 .png回退
* Linux → .png
*
* @param appPath - Electron app.getAppPath()
* @returns 图标文件的绝对路径
*/
export function getWindowIconPath(appPath: string): string {
const logoDir = path.join(appPath, LOGO_DIR);
if (isWindows()) {
// Windows 首选 .ico
return path.join(logoDir, 'heixiu.ico');
}
if (isMacOS()) {
return path.join(logoDir, 'heixiu.icns');
}
// Linux 使用 .png
return path.join(logoDir, 'HX.png');
}
/**
* 按平台获取系统托盘图标路径
* 托盘图标通常用 .png跨平台通用且尺寸较小
*
* @param appPath - Electron app.getAppPath()
* @returns 托盘图标绝对路径
*/
export function getTrayIconPath(appPath: string): string {
const logoDir = path.join(appPath, LOGO_DIR);
if (isWindows()) {
// Windows 托盘可用 .ico 或小尺寸 .png
return path.join(logoDir, 'heixiu.ico');
}
// macOS / Linux 托盘用 .png
return path.join(logoDir, 'HX.png');
}
/**
* 按平台获取应用安装包图标路径
* electron-builder 打包时使用,各平台格式不同:
* Windows → .ico
* macOS → .icns
* Linux → .png通常 256x256 或 512x512
*
* @param appPath - 应用根目录路径
* @returns 安装包图标的绝对路径
*/
export function getInstallerIconPath(appPath: string): string {
const logoDir = path.join(appPath, LOGO_DIR);
if (isWindows()) {
return path.join(logoDir, 'heixiu.ico');
}
if (isMacOS()) {
return path.join(logoDir, 'heixiu.icns');
}
// Linux
return path.join(logoDir, 'HX.png');
}
/**
* 获取通用 PNG Logo不区分平台用于 About 对话框等)
*/
export function getPngLogoPath(appPath: string): string {
return path.join(appPath, LOGO_DIR, 'HX.png');
}