OC-tool 技术文档

OC-tool 技术文档

OC-tool POSIX shell script that builds an OpenCore EFI folder from an OpenCore config.plist 项目地址: https://gitcode.com/gh_mirrors/oc/OC-tool

1. 安装指南

1.1 克隆项目

首先，你需要从GitHub上克隆OC-tool项目到本地。使用以下命令：

git clone https://github.com/rusty-bits/OC-tool

1.2 进入项目目录

克隆完成后，进入项目目录：

cd OC-tool

1.3 配置config.plist

将你的config.plist文件复制到INPUT文件夹中，或者复制并编辑一个示例文件：

cp Docs/Sample.plist INPUT/config.plist

1.4 注意事项

如果你使用GitHub的“Clone or download”按钮下载项目文件，OC-tool将无法更新自身，因为下载的文件不是Git仓库。

2. 项目使用说明

2.1 基本使用

OC-tool是一个POSIX shell脚本，用于从OpenCore的config.plist文件构建EFI文件夹。你可以在macOS Finder中双击运行，默认情况下会执行./OC-tool -o。

2.2 运行环境

OC-tool可以在多种POSIX shell环境中运行，如sh、bash、ksh、ash、dash等。作者本人使用zsh也没有问题。此外，OC-tool也可以在Windows的WSL或Git for Windows中运行。

2.3 依赖工具

OC-tool依赖于一些基本的命令行工具，如git、grep、curl、cp、cut、tr等。这些工具通常已经预装在大多数POSIX shell环境中。

2.4 从源码构建

如果你想从源码构建OC-tool，你需要在macOS上安装Xcode、xcodebuild、nasm和mtoc。你可以手动安装这些依赖，或者使用项目中的get-deps.sh脚本自动获取预构建的依赖。

3. 项目API使用文档

3.1 命令行选项

OC-tool支持多种命令行选项，用于不同的操作。以下是一些常用的选项：

• -o: 默认选项，用于构建EFI文件夹。
• -d: 使用Dortania的每日构建版本。
• -h: 显示帮助信息。

3.2 示例

以下是一个使用OC-tool构建EFI文件夹的示例：

./OC-tool -o

4. 项目安装方式

4.1 通过Git克隆

最推荐的方式是通过Git克隆项目：

git clone https://github.com/rusty-bits/OC-tool

4.2 手动下载

如果你不想使用Git，也可以手动下载项目文件。但请注意，手动下载的文件无法自动更新。

4.3 依赖安装

如果你需要从源码构建OC-tool，请确保安装了所有必要的依赖工具。你可以使用项目中的get-deps.sh脚本自动获取这些依赖。

5. 致谢

OC-tool的开发得到了许多开源社区成员的帮助和支持，特别感谢以下人员和项目：

• vit9696、PMheart、cattyhouse
• DhinakG
• elliptic-shiho
• r/hackintosh社区成员
• acidanthera团队

感谢所有为OC-tool做出贡献的人！

OC-tool POSIX shell script that builds an OpenCore EFI folder from an OpenCore config.plist 项目地址: https://gitcode.com/gh_mirrors/oc/OC-tool