AutoRaise 安装和配置指南
1. 项目基础介绍和主要编程语言
项目基础介绍
AutoRaise 是一个开源项目,旨在自动将鼠标悬停的窗口提升到前台并聚焦。该项目适用于 macOS 系统,允许用户自定义延迟时间和其他参数,以实现更高效的工作流程。
主要编程语言
AutoRaise 主要使用 Objective-C++ 编写。
2. 项目使用的关键技术和框架
关键技术
- Objective-C++: 用于实现窗口管理和鼠标事件处理。
- macOS API: 利用 macOS 的系统 API 来管理窗口和鼠标行为。
框架
- macOS Accessibility API: 用于获取和操作窗口焦点。
- macOS AppKit: 用于处理应用程序的用户界面和事件。
3. 项目安装和配置的准备工作和详细安装步骤
准备工作
- macOS 系统: 确保你的系统是 macOS。
- Xcode: 安装 Xcode 以编译和运行项目。
- Git: 安装 Git 以克隆项目仓库。
详细安装步骤
步骤 1: 克隆项目仓库
打开终端并运行以下命令来克隆 AutoRaise 项目:
git clone https://github.com/sbmpost/AutoRaise.git
步骤 2: 进入项目目录
克隆完成后,进入项目目录:
cd AutoRaise
步骤 3: 编译项目
使用以下命令编译项目:
make clean && make && make install
步骤 4: 配置 AutoRaise
你可以通过创建配置文件来定制 AutoRaise 的行为。创建一个名为 ~/.AutoRaise
或 ~/config/AutoRaise/config
的文件,并添加以下内容:
#AutoRaise config file
pollMillis=50
delay=1
focusDelay=0
warpX=0.5
warpY=0.1
scale=2.5
altTaskSwitcher=false
ignoreSpaceChanged=false
invertIgnoreApps=false
ignoreApps="IntelliJ IDEA,WebStorm"
ignoreTitles="\\s\\| Microsoft Teams"
stayFocusedBundleIds="com.apple.SecurityAgent"
disableKey="control"
mouseDelta=0.1
步骤 5: 运行 AutoRaise
编译完成后,你可以通过以下命令运行 AutoRaise:
./AutoRaise
或者,你可以直接运行 AutoRaise.app
:
open /Applications/AutoRaise.app
步骤 6: 授权 AutoRaise
首次运行时,macOS 可能会提示你授权 AutoRaise 访问系统功能。请在“系统偏好设置” > “安全性与隐私” > “隐私” > “辅助功能”中允许 AutoRaise。
注意事项
- 如果你遇到任何问题,可以启用详细日志记录来调试:
./AutoRaise -verbose
- 确保没有其他鼠标工具与 AutoRaise 冲突。
通过以上步骤,你应该能够成功安装和配置 AutoRaise,并开始享受自动提升和聚焦窗口的便利。