Cocui 技术文档

1. 安装指南

Cocui 是一款用于快速构建功能性的 Cocoa 应用程序的框架，它使用 WebKit（HTML、CSS 和 JavaScript）进行开发。以下是安装 Cocui 的步骤：

• 下载最新版本的 Cocui，可以从 Cocui 发布页面 获取。
• Cocui 会使用 Sparkle 进行自动更新，它需要 Mac OS X 10.5 或更高版本。

2. 项目使用说明

Cocui 允许开发者以类似于编写普通 HTML 页面的方式来创建应用，同时提供了与 Cocoa 丰富的交互。以下是一些你可以使用 Cocui 完成的事情：

• 像编写普通 HTML 页面一样编写应用，并使用 JavaScript。
• 通过关联一个或多个文件类型，实现文件的打开。
• 保留 WebKit 的调试器、性能分析器、控制台和检查器开发工具。
• 无限制的 XHR（可以加载和交互网络或本地的任何资源）。
• 将 NSApplication 事件传播为原生 JavaScript 事件，例如 "applicationWillBecomeActive" 等。
• 通过 "App.window" 实现对窗口的完全控制（调整大小、最小化、隐藏、关闭等）。
• 通过 "App.app" 实现对 NSApp 的完全控制（终止等）。
• 通过 "App.defaults" 访问 NSUserDefaults（系统原生的应用设置）。
• 使用单个命名空间 "App" 暴露 Cocoa 和 JavaScript 之间的桥接。
• 大多数功能都在示例应用的 index.html 中展示。

你可以通过如下代码实现一些功能：

<a href="javascript:Win.miniaturize()">最小化应用</a>

var window = App.loadWindow({
  uri: 'index.html',
  rect: { size: { width: 500, height: 400 } }
})
window.makeKeyAndOrderFront();

原生拖放已经被 WebKit 支持。

3. 项目 API 使用文档

Cocui 提供了一系列 API，以便于开发者实现与 Cocoa 的交互。以下是一些主要 API 的使用方法：

• App.loadWindow(options): 加载一个新窗口，其中 options 包含了窗口的配置信息，如 uri（页面路径）和 rect（窗口大小和位置）。
• App.window: 用于控制当前窗口的方法，如 makeKeyAndOrderFront（使窗口前置并显示）。
• App.app: 用于控制应用级别的方法，如 terminate（终止应用）。
• App.defaults: 用于访问和设置应用级别的偏好设置。

4. 项目安装方式

创建新的 Cocui 项目非常简单：

• 运行 Cocui 应用程序。
• 输入项目名称和 UTI（统一类型标识符），并可以选择设置图标和文档类型。
• Cocui 将为你创建一个新项目，并准备好开发环境。如果你有 TextMate 或 SubEthaEdit，它们将随新应用一起启动。

若要启用开发模式，可以通过以下命令设置 "DevelopmentMode" 为 true：

$ defaults write my.cocui.app DevelopmentMode -bool yes

更改后需要重启应用。之后，将出现一个名为 "Develop" 的新菜单项。使用 Cocui 应用创建新项目时，开发模式默认已经启用。