CwlViews
一系列围绕 AppKit/UIKit 视图的包装器,将它们转换成了声明性构建、响应式信号驱动的框架。
CwlViews 需要 Swift 5 或更高版本,并针对 macOS 10.13 或 iOS 11 或更高版本。
使用方法
CwlViews 可以有多种方式添加到项目中。
对于快速开始新的项目,“带有嵌入式包含的 Xcode 模板”方法通常最简单——它安装 Xcode 项目模板,直接将所需的 CwlViews 文件嵌入到新创建的 CwlViews 应用或 CwlViews 演练场中。这种方法的缺点是在清洁和重建项目时也需要重建 CwlViews 文件。
如果要在现有项目中使用或在单独的框架中使用 CwlViews(为了编译性能和依赖关系管理优势),请使用“手动框架包含”、“Carthage”或“CocoaPods”方法之一。
带有嵌入式包含的 Xcode 模板
- 将 CwlViews 仓库克隆或下载到您的计算机上。
- 使用 Terminal,切换到 CwlViews 仓库中的
Scripts
目录。 - 运行
./install_cwlviews_templates.swift
- 打开 Xcode 并从“文件”菜单中,选择“新建”→“项目...
- 根据需要从顶部的选项卡中选择 iOS 或 macOS。
- 从“应用程序”部分,选择“CwlViews”。
项目模板包含一些示例代码,并将 CwlViews 框架的内容包含在“依赖”文件夹中。因为这些文件直接包含在应用程序中,所以您不需要在 Swift 文件顶部使用 import
语句来使用它们。
手动框架包含
- 在你的项目目录的子目录下运行
git clone https://github.com/mattgallagher/CwlViews.git
- 从Finder中将“CwlViews.xcodeproj”文件拖到Xcode你自己的项目文件树中
- 在文件树中选择你的项目,以访问项目设置,并点击你想要添加CwlViews的目标
- 点击“构建阶段”标签页
- 为CwlViews_iOS或CwlViews_macOS添加一个“目标依赖”(取决于你的目标是否为iOS构建)
- 如果你没有已经存在的“复制文件”的构建阶段带有“目的:框架”,请使用标签页左上角的“+”添加一个
- 将“CwlViews.framework”、“CwlSignal.framework”和“CwlUtils.framework”添加到“复制文件,目标:框架”步骤。注意:列表中可能有多个“CwlViews.framework”文件,包括为macOS和iOS准备的文件。你应该选择位于对应的CwlViews macOS或iOS测试目标之上的“CwlViews.framework”。
- 在希望使用CwlViews、CwlSignal或CwlUtils代码的Swift文件中,只需在顶部写上
import 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'