Skip to content

README_zh-CN.md

Latest commit

 

History

History
162 lines (121 loc) · 4.84 KB

README_zh-CN.md

File metadata and controls

162 lines (121 loc) · 4.84 KB
Raw

Launchpad_Back

用 SwiftUI + AppKit 写的 macOS Launchpad 替代启动器（macOS 15.6+）。

下载次数

English | 繁体中文 | 简体中文

如果你在找“macOS Tahoe 的 Launchpad 替代品”，这个项目就是为这个场景做的：全局快捷键呼出、分页网格、文件夹整理、拖拽排序和本地搜索。

界面演示

主界面

搜索关键词

Launchpad 替代, macOS app launcher, SwiftUI 启动器, AppKit launcher, 全局快捷键启动器, macOS Tahoe Launchpad replacement, Homebrew Cask 扫描

当前功能（按现有代码）

  • 浮动窗口启动器，可通过全局 Cmd + L 切换显示
  • 响应式分页网格（动态 5-9 列、3-7 行）
  • 支持拖拽排序、文件夹创建/重命名、从展开文件夹拖出 App
  • 搜索会匹配 App 名称、bundle ID、安装路径（不区分大小写）
  • 扫描系统、用户和 Homebrew 常见安装目录
  • 图标处理包含 workspace icon、metadata fallback 和自动 fallback icon

快捷键与手势

输入 行为
Cmd + L 全局切换启动器显示/隐藏
Cmd + W 隐藏窗口
Cmd + Q 退出程序
Esc 依次：退出编辑模式 -> 关闭文件夹 -> 清空搜索 -> 隐藏窗口
Left / Up 上一页
Right / Down 下一页
触控板滚动手势 按阈值和冷却时间切页
鼠标滚轮 按 notch 累积和防抖切页

应用扫描路径

路径 是否递归
/System/Applications 否
/System/Applications/Utilities 否
/Applications 否
/Applications/Utilities 否
~/Applications 否
/opt/homebrew/Caskroom 是

扫描器还会过滤一批隐藏/后台系统 App，并使用稳定标识去重（优先 bundleID，没有时回退到路径）。

文件夹与版面逻辑

  • 长按图标进入编辑模式
  • 把 App 拖到另一个 App 上可创建文件夹（默认名 New Folder）
  • 把 App 拖到文件夹上可加入文件夹
  • 展开文件夹后可重命名、可重排内部项目
  • 从展开文件夹拖出 App 可移出文件夹
  • 当文件夹只剩 1 个 App 时会自动解散
  • 重设版面会清空自定义排序和文件夹，恢复按名称排序

图标处理流程

  • 先解析 symlink / canonical bundle path
  • 如果 NSWorkspace 返回的不是 generic icon，直接使用
  • 如果是 generic icon，则继续读取 bundle metadata（CFBundleIconFile、CFBundleIconName 等）
  • metadata 仍然不可用时，生成一致的 initials fallback icon
  • 使用异步缓存并预加载相邻页图标，减少翻页和拖拽卡顿

持久化存储

Launchpad_Back 会把版面状态写入 UserDefaults：

  • launchpad_item_order
  • launchpad_folders

项目结构

Launchpad_Back/
├── Launchpad_BackApp.swift
├── ContentView.swift
├── Models/
│   └── AppItem.swift
├── Services/
│   ├── AppIconCache.swift
│   ├── AppIconResolver.swift
│   ├── AppLauncherService.swift
│   ├── AppScannerService.swift
│   ├── GestureManager.swift
│   ├── GridLayoutManager.swift
│   ├── KeyboardEventManager.swift
│   └── Logger.swift
├── ViewModels/
│   ├── EditModeManager.swift
│   ├── LaunchpadViewModel.swift
│   ├── PaginationViewModel.swift
│   └── SearchViewModel.swift
├── Views/
│   ├── AppIconView.swift
│   ├── BackgroundView.swift
│   ├── FolderExpandedView.swift
│   ├── PageIndicatorView.swift
│   └── SearchBarView.swift
└── Assets.xcassets/

系统要求

  • macOS 15.6 或更高版本
  • Xcode 26.0 或更高版本

编译

  1. 克隆仓库：

    git clone https://github.com/EricYang801/Launchpad_Back.git
cd Launchpad_Back

  2. 用 Xcode 打开：

    open Launchpad_Back.xcodeproj

  3. 运行：

  • 选择 My Mac
  • 按 Cmd + R

也可以在 Terminal 编译：

xcodebuild build -scheme Launchpad_Back -destination 'platform=macOS'

测试

运行单元测试：

xcodebuild test -scheme Launchpad_Back -destination 'platform=macOS' -only-testing:Launchpad_BackTests

当前测试覆盖：

  • icon 解析（直接路径、symlink、metadata fallback、自动 fallback）
  • icon cache（canonical path 复用、并发安全、in-flight async 合并）
  • 文件夹创建/加入/移除/删除与排序恢复
  • 重设版面行为
  • 搜索匹配（名称、bundle ID、路径）
  • 分页切片、边界检查和页码修正
  • SearchViewModel 基础行为

许可证

本项目采用 GPL-3.0。详见 LICENSE。