Chameleon 技术文档

1. 安装指南

系统要求

Chameleon 需要macOS 10.6 或更高版本。使用 Chameleon 构建的应用程序已证明可以被苹果公司的Mac App Store 接受。

安装步骤

1. 从GitHub下载 Chameleon 的源代码。
2. 使用Xcode 打开 Chameleon 的项目文件。
3. 构建并运行 Chameleon 的框架项目，生成.framework 文件。
4. 将生成的.framework 文件拖拽到您的应用项目中。

2. 项目的使用说明

Chameleon 是苹果公司 UIKit 的一个端口，用于macOS 系统。它的目标是尽可能成为 UIKit 的即插即用替代品，并适应一些iOS 用户界面约定，以便使用 Chameleon 构建的应用程序可以在最少的工作量下，在桌面上有宾至如归的感觉。

Chameleon 实际上是由几个框架组成的集合，其中最大的是 UIKit。其他的框架主要是桩，使得从iOS 端口演示和测试应用程序变得简单，有时甚至不需要更改代码。

Chameleon 的 Xcode 项目构建可嵌入的框架，然后可以捆绑在您自己的应用包中，并以自包含的方式分发。

3. 项目API使用文档

Chameleon 的 UIKit 端口从非常底层开始，甚至尝试沿着与 UIEvent 对象相似的路径路由，从单个 UIApplication 实例开始，然后路由到正确的 UIWindows 和 UIViews。

AppKit 的 NSViews 和 NSWindows 与 Chameleon 的 UIWindow 和 UIViews 之间的接口发生在“屏幕”级别。UIKitView 是一个 NSView，您可以按需将其添加到 NSView 层次结构中。UIKitView 托管一个 UIScreen 实例，它是 UIKit 界面元素的家。

每个 UIWindow 属于一个 UIScreen，并且 UIViews 必须存在于 UIWindows 上。这应该与您在iOS 上习惯的做法大致相同。需要注意的是，Mac 应用程序通常有多个窗口。如果您在应用中使用多个 UIKitView，请注意这意味着您的应用程序现在有多个 UIScreen，因此某些方法（如 [UIScreen mainScreen]）可能会突然做出意外的事情。在将 Twitterrific 从iOS 端口到Mac时，这就是一个意外的错误来源，因为有些东西假设只有一个主要屏幕是正常的，因为这是当前iOS设备上的常态。

一旦存在一个 UIKitView 并且有一个可用的 UIScreen，您的代码就可以继续在上面的 UIWindow 和 UIViews 上构建，并且很大程度上不知道它实际上是在 OS X 上运行。

为了在需要自定义某些 UI 的情况下使用，UIUserInterfaceIdiomDesktop 已经被添加，以便您的代码可以区分是在 Pad、Phone 还是 Desktop 上运行。

4. 项目安装方式

您可以通过以下方式安装 Chameleon：

1. 下载 Chameleon 的源代码。
2. 使用 Xcode 打开下载的 .xcodeproj 文件。
3. 构建框架，生成的 .framework 文件可以直接拖拽到您的 Xcode 项目中。

请注意，Chameleon 需要在 macOS 10.6 或更高版本的系统上运行，并确保您的开发环境满足这些要求。

以上是 Chameleon 项目的简要技术文档，希望对您有所帮助。如果您在使用过程中遇到任何问题或需要进一步的帮助，请随时查阅项目文档或联系技术支持。