Vimari项目在Safari 12/13上的安装指南

背景介绍

Vimari是一款为Safari浏览器设计的Vim风格导航扩展，它允许用户通过键盘快捷键快速浏览网页，提升操作效率。随着macOS Mojave的发布，Safari 12引入了一种全新的浏览器扩展机制——Safari App Extension，这导致原有的Vimari扩展需要进行重大调整才能兼容新版本。

环境准备

在开始安装前，请确保您的系统满足以下条件：

• macOS High Sierra或更高版本
• Xcode开发工具已安装
• Safari 12或13版本

详细安装步骤

1. 获取项目代码

首先需要获取Vimari的源代码。由于项目采用Swift语言开发，我们需要通过Xcode进行编译。

2. 配置Xcode项目

打开项目中的Vimari.xcodeproj文件后，需要进行以下关键配置：

1. 签名设置：在Xcode中，需要为vimari和extension两个target配置开发者签名
2. 团队选择：使用您自己的开发者账号而非原项目团队

3. 自定义设置（可选）

在settings.js文件中，您可以修改以下配置：

• 键盘快捷键映射
• 滚动行为参数
• 其他个性化选项

4. 编译运行

使用⌘ + r快捷键编译并运行项目。首次运行时会出现一个空白GUI窗口，这是Safari App Extension的正常现象，可以暂时忽略。

5. 启用Safari扩展

在Safari浏览器中：

1. 打开偏好设置(⌘ + ,)
2. 进入"扩展"选项卡
3. 找到并启用Vimari扩展

6. 完成安装

此时可以关闭Xcode，扩展将保持激活状态，即使重启Safari也不会失效。

注意事项

1. 由于技术架构变更，某些功能可能无法完全正常工作
2. 项目团队正在持续改进安装流程和功能完整性
3. 如果遇到问题，建议检查Xcode控制台输出获取调试信息

常见问题解答

Q：为什么需要Xcode编译？ A：Safari 12+的扩展机制要求扩展必须打包在macOS应用中，因此需要通过Xcode编译生成应用包。

Q：安装后如何更新设置？ A：修改settings.js后需要重新编译运行项目才能使更改生效。

Q：扩展不工作怎么办？ A：首先检查Safari扩展是否已启用，然后查看macOS系统偏好设置中的"隐私与安全性"是否允许该扩展运行。

通过以上步骤，您就可以在Safari 12及以上版本中享受Vim风格的浏览体验了。随着项目的持续开发，安装流程和功能稳定性将会进一步改善。