CwlViews
一系列围绕 AppKit/UIKit 视图的包装器,将它们转换为声明性构建、响应性信号驱动的框架。
CwlViews 需要 Swift 5 或更高版本,并针对 macOS 10.13 或 iOS 11 及更高版本。
用法
CwlViews 可以通过多种方式添加到项目中。
对于快速开始新项目,使用“带有嵌入式包含的 Xcode 模板”方法通常是最简单的,它会安装 Xcode 项目模板,这些模板将所需的 CwlViews 文件直接嵌入到新创建的 CwlViews apps 或 CwlViews playgrounds。这种方法的缺点是清洁和重建项目需要重建 CwlViews 文件。
要将 CwlViews 添加到现有项目中或保持 CwlViews 在单独的框架中(为了编译性能和依赖关系管理优势),则应使用“手动框架包含”、“Carthage”或“CocoaPods”方法之一。
带有嵌入式包含的 Xcode 模板
- 将 CwlViews 仓库克隆或下载到您的计算机上。
- 使用终端,
cd
到 CwlViews 仓库中的Scripts
目录。 - 运行
./install_cwlviews_templates.swift
- 打开 Xcode,然后从“文件”菜单中选择“新建”→“项目...
- 从顶部选项卡中选择您想要的 iOS 或 macOS。
- 从“应用程序”部分选择“CwlViews”。
项目模板包含一些示例代码,并在“依赖”文件夹中包含了CwlViews框架的内容。由于这些文件是直接包含在应用程序中的,所以在Swift文件的开头不需要使用导入
语句来使用它们。
手动框架包含
- 在您项目的子目录下运行
git clone https://github.com/mattgallagher/CwlViews.git
- 将“CwlViews.xcodeproj”文件从Finder中拖动到Xcode中您自己的项目的文件树中
- 在文件树中单击您的项目以访问项目设置,然后单击您想要添加CwlViews的目标
- 单击“构建阶段”选项卡
- 为CwlViews_iOS或CwlViews_macOS添加一个“目标依赖”,具体取决于您的目标是构建iOS还是Mac
- 如果您还没有名为“复制文件”的“目标依赖”带有“目的:框架”,请使用选项卡的右上角的"+"添加一个。
- 将“CwlViews.framework”、“CwlSignal.framework”和“CwlUtils.framework”添加到“复制文件,目的地:框架”步骤中。注意:列表中可能会有多个“CwlViews.framework”文件,包括用于macOS和iOS的一个。您应该选择出现在相应的CwlViews macOS或iOS测试目标之上方的“CwlViews.framework”。
- 在您想要使用CwlViews、CwlSignal或CwlUtils代码的Swift文件中,只需在顶部写上
导入 CwlViews
(此单条语句将导入所有三个框架)。
将“CwlViews.xcodeproj”文件添加到您项目的文件树中还将添加其所有方案到Xcode中的方案列表中。您可以通过从“产品”→“方案”→“管理方案”(或按Command-Shift,)选择并取消勾选CwlViews、CwlSignal和CwlUtils方案名称旁边的“显示”列中的复选框来从方案列表隐藏这些方案。
Carthage
将以下行添加到您的Cartfile中
git "https://github.com/mattgallagher/CwlViews.git" "master"
按照Carthage要求的剩下步骤来查找和构建依赖项。您需要将“CwlViews.framework”、“CwlSignal.framework”和“CwlUtils.framework”添加到您的目标中的“复制框架”阶段。
CocoaPods
将以下行添加到您的“Podfile”中的目标
pod 'CwlViews', '~> 0.1.0'
pod 'CwlSignal', '~> 2.2.0'
pod 'CwlUtils', '~> 2.2.0'