macOS Swift-Keylogger技术文档
项目地址: https://gitcode.com/gh_mirrors/sw/Swift-Keylogger 安装指南
macOS Swift-Keylogger是一款专为macOS设计的简洁易用的键盘记录工具，采用Swift 4.0编程语言编写。为了开始使用此项目，您需要具备Xcode环境。
-
获取源码: 访问该项目的GitHub仓库（链接），点击“Code”按钮下载ZIP文件或通过Git命令行工具克隆仓库。
git clone https://github.com/SkrewEverything/Swift-Keylogger.git -
准备环境: 确保您的机器已经安装了最新版本的Xcode，它包含了必要的Swift编译工具。
项目的使用说明
运行应用
-
打开项目: 使用Xcode打开下载或克隆的项目目录中的
.xcodeproj文件。 -
构建与运行: 在Xcode中，选择合适的Schema后，点击运行按钮或者使用快捷键
Cmd+R来构建并运行项目。这将在模拟器或连接的设备上启动Keylogger。对于后台运行：
终端中使用以下命令可以让Keylogger在后台运行：
cd 到可执行文件所在的路径 nohup ./Keylogger &要停止Keylogger，先找到其进程ID:
ps -e | grep "Keylogger"然后使用PID终止进程：
kill -9 进程ID
数据结构
Keylogger运行时会在当前可执行文件目录下创建一个名为“Data”的文件夹，结构如下：
Key: 存储按应用分类的所有按键记录。App: 记录每个应用活跃的时间戳。Devices: 保存关于连接的键盘信息。
数据按天分组，便于管理和查阅。
项目API使用文档
Swift-Keylogger的设计允许两种集成方式：直接调用可执行文件和将源代码整合到Cocoa应用中。
直接调用可执行文件
- 方法：适合非Swift应用，通过
Process类调用可执行文件，注意避免阻塞主线程。
整合至Cocoa应用
- 将
Keylogger.swift和CallBackFunctions.swift文件导入您的项目。 - 在需要的地方初始化
Keylogger单例，并调用它的start()和stop()方法来控制记录过程。 - 关闭应用沙盒或正确配置沙盒权限以允许USB访问。
示例代码片段展示在ViewController中如何集成：
import Cocoa
class ViewController: NSViewController {
static var k = Keylogger()
override func viewDidLoad() {
super.viewDidLoad()
// 初始化视图后操作...
}
@IBAction func start(_ sender: Any) {
ViewController.k.start()
}
@IBAction func stop(_ sender: Any) {
ViewController.k.stop()
}
}
记得在沙盒环境下，添加适当的权利到entitlements.plist文件，例如：
<key>com.apple.security.device.usb</key>
<true/>
项目安装方式
无需传统意义上的“安装”，只需按照上述步骤配置Xcode项目，即可运行或集成Swift-Keylogger。
注意事项
- 此工具仅供合法和教育目的使用。
- 由于Apple的安全限制，它不记录密码等安全输入内容。
- 确保遵守所有相关隐私法律和地区法规。
通过这份文档，您应该能够顺利地设置和使用macOS Swift-Keylogger。记住，在开发过程中始终尊重用户隐私权。