Vimac 项目下载及安装教程

1、项目介绍

Vimac 是一个 macOS 生产力应用程序，提供键盘驱动的导航和控制 macOS 图形用户界面（GUI）。Vimac 深受 Vimium 的启发，旨在通过键盘操作提高用户在 macOS 上的工作效率。

2、项目下载位置

你可以通过以下链接下载 Vimac 项目：

Vimac GitHub 仓库

3、项目安装环境配置

系统要求

• macOS 操作系统
• Xcode 开发工具
• CocoaPods 依赖管理工具
• Carthage 依赖管理工具

环境配置步骤

1. 安装 Xcode

   确保你已经安装了 Xcode 开发工具。你可以从 Mac App Store 下载并安装 Xcode。

   

2. 安装 CocoaPods

   打开终端并运行以下命令来安装 CocoaPods：

   sudo gem install cocoapods
   

   

3. 安装 Carthage

   打开终端并运行以下命令来安装 Carthage：

   brew install carthage
   

   

4、项目安装方式

下载项目

1. 打开终端并克隆 Vimac 项目：

   git clone https://github.com/dexterleng/vimac.git
   

2. 进入项目目录：

   cd vimac
   

安装依赖

1. 安装 CocoaPods 依赖：

   pod install
   

2. 使用 Carthage 构建依赖：

   carthage build
   

打开项目

1. 打开 Vimac 项目工作区：

   open Vimac.xcworkspace
   

2. 在 Xcode 中，修改“Signing & Capabilities”设置，确保“Disable Library Validation”选项已启用。

   

3. 在“System Preferences > Security & Privacy > Accessibility”中，添加 Vimac 和 Xcode 到可访问性应用列表中。

   

构建项目

1. 在 Xcode 中，选择合适的设备或模拟器，然后点击“Build”按钮。

2. 如果 AppleScript 脚本未成功运行，可能需要多次构建项目。

5、项目处理脚本

Vimac 项目包含一个 AppleScript 脚本 grant-accessibility-permission-dev.scpt，用于在每次构建后重新授予可访问性权限。该脚本会检查并重新勾选 Vimac 的可访问性权限，以确保权限不会在清理构建后丢失。

# 运行 AppleScript 脚本
osascript grant-accessibility-permission-dev.scpt

通过以上步骤，你就可以成功下载并安装 Vimac 项目，并开始使用键盘驱动的 macOS 导航功能。