AutoRaise 项目常见问题解决方案

项目基础介绍

AutoRaise 是一个开源项目，旨在当用户将鼠标悬停在窗口上时，自动将该窗口提升到最前并获得焦点。该项目主要使用 Objective-C++ 编程语言开发。

新手使用注意事项及解决方案

1. 权限问题：无法启用 Accessibility 权限

问题描述：在 macOS 系统中，AutoRaise 需要 Accessibility 权限才能正常工作。新手用户在首次运行时可能会遇到权限设置问题，导致应用无法正常提升窗口。

解决步骤：

1. 打开 系统偏好设置 > 安全性与隐私 > 隐私 > 辅助功能。
2. 在列表中找到 AutoRaise，并勾选允许。
3. 如果列表中没有 AutoRaise，请先运行 AutoRaise 应用，然后返回此界面，点击左下角的锁图标进行解锁，再添加 AutoRaise。
4. 重新启动 AutoRaise 应用。

2. 配置文件问题：无法找到或正确配置 config 文件

问题描述：新手用户可能会遇到无法找到或正确配置 AutoRaise 的配置文件，导致应用无法按预期工作。

解决步骤：

1. 打开终端，输入以下命令创建配置文件目录：

   mkdir -p ~/Library/Preferences/AutoRaise
   

2. 在该目录下创建一个名为 config 的文件，并添加以下默认配置：

   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
   

3. 保存文件后，重新启动 AutoRaise 应用。

3. 编译问题：无法自行编译 AutoRaise

问题描述：有些用户可能希望自行编译 AutoRaise，但在编译过程中遇到问题。

解决步骤：

1. 确保已安装 Xcode 和 Command Line Tools。
2. 克隆项目到本地：

   git clone https://github.com/sbmpost/AutoRaise.git
   

3. 进入项目目录并编译：

   cd AutoRaise
   make clean && make && make install
   

4. 如果编译过程中遇到错误，请检查 Xcode 和 Command Line Tools 是否正确安装，并确保所有依赖项已安装。

通过以上步骤，新手用户可以更好地理解和使用 AutoRaise 项目，解决常见问题。