Platypus 项目技术文档

1. 安装指南

1.1 下载与安装 Platypus

首先，您需要下载并安装 Platypus 工具。Platypus 是一个开发者工具，用于将命令行脚本（如 Shell 脚本、Python、Perl、Ruby 等）转换为 macOS 原生应用程序。

1.2 安装命令行工具

安装完成后，打开 Platypus 并进入 Preferences 菜单，安装命令行工具。该工具将用于后续的构建过程。

1.3 设置版本号

在项目根目录下，执行以下命令设置版本号：

echo "4.5-beta" > VERSION

1.4 构建项目

最后，执行以下命令进行项目构建：

make

2. 项目的使用说明

Platypus 的主要功能是将命令行脚本转换为 macOS 应用程序。使用 Platypus 可以轻松创建用户友好的应用程序，而无需用户熟悉命令行界面。

2.1 创建应用程序

1. 打开 Platypus 应用程序。
2. 选择您要转换的脚本文件。
3. 配置应用程序的界面类型（如进度条、文本窗口、WebView 等）。
4. 设置应用程序的图标、文件类型、版本等信息。
5. 点击“创建”按钮，生成 macOS 应用程序。

2.2 运行应用程序

生成的应用程序可以直接在 macOS 上运行，用户可以通过拖放文件或输入文本与应用程序交互。

3. 项目 API 使用文档

Platypus 本身没有提供传统的 API，但其生成的应用程序可以通过命令行参数或拖放文件与脚本进行交互。

3.1 命令行参数

生成的应用程序可以接收命令行参数，这些参数将传递给底层的脚本。例如：

./MyApp --option1 --option2

3.2 拖放文件

用户可以将文件拖放到应用程序图标上，这些文件的路径将作为参数传递给脚本。

4. 项目安装方式

4.1 通过 Platypus 安装

1. 下载并安装 Platypus。
2. 使用 Platypus 创建应用程序。
3. 将生成的应用程序分发给用户。

4.2 通过命令行工具安装

1. 安装 Platypus 命令行工具。
2. 使用命令行工具生成应用程序。
3. 分发生成的应用程序。

通过以上步骤，您可以轻松使用 Platypus 创建并分发 macOS 应用程序。