Scrup 技术文档

1. 安装指南

下载与安装

• 下载 Scrup：下载地址
• 将 Scrup 移动到应用程序文件夹中，并双击打开。
• Scrup 将出现在屏幕右上角，形状为一个带箭头的旋转手图标。点击它并选择“偏好设置...”。

配置

• 在“接收 URL”文本字段中，输入接收文件的 URL。例如，您可以上传一个自己的服务器上的 [recv.php](http://github.com/rsms/scrup/blob/master/recv.php) 文件副本。
• 请注意，recv.php 需要 PHP5 才能运行，因为它使用了 PHP5 特有的 stream_copy_to_stream() 函数来获取图像数据流。
• 拍摄屏幕截图，您应该会看到 Scrup 图标变成一个勾选标记，表示成功。（如果您看到一个红色徽章，则表示失败了。打开 Console.app 查看详细信息。）

2. 使用说明

Scrup 居于菜单栏，当您拍摄屏幕截图时，它会执行一个 HTTP POST 请求，发送图像。发送成功后，服务器会返回新上传文件的 URL。该 URL 会被置于剪贴板中，您可以随时使用 ⌘V 粘贴。

3. 项目 API 使用文档

Scrup 的核心功能是基于一个简单的 API，主要用于上传截图并接收截图的 URL。以下是基本的使用流程：

• 用户拍摄屏幕截图。
• Scrup 将截图作为 HTTP POST 请求发送到配置的接收 URL。
• 服务器处理截图并返回一个包含截图 URL 的响应。
• Scrup 接收响应并将 URL 放入剪贴板。

服务器端需要一个处理上传的脚本，如提供的 recv.php 示例。服务器响应应包含一个 JSON 对象，其中包含上传文件的 URL。

4. 项目安装方式

Scrup 的安装主要涉及以下步骤：

• 确保您有 libpngcrush。
• 克隆 Scrup 源代码到本地。
• 初始化并更新子模块 pngcrush 和 SCEvents：

  cd scrup-source
  git submodule update --init pngcrush SCEvents
  

• 使用 Xcode 构建 "Scrup" 目标。

Scrup 遵循 MIT 开源许可证。请在 _LICENSE_ 文件中查看详细信息。