QMUI iOS 有 3 种使用方式:
在你的项目的 Podfile 里添加如下内容:
pod 'QMUIKit'
然后运行 pod install
即可。
如果只需要引入某几个特定的子模块,则可参照以下写法,具体的子模块列表请直接查看项目源码里的 QMUIKit.podspec 文件:
pod 'QMUIKit/QMUIComponents/QMUIModalPresentationViewController'
请在项目的 Cartfile
里添加:
github "QMUI/QMUI_iOS"
再按照 Carthage 的标准方式将 QMUIKit.framework
添加到项目里即可。
在 GitHub 上下载 QMUI iOS,或者以 git subtree 的方式将 QMUI iOS 的代码拉取到项目目录内,然后将 qmui.xcodeproj
拖到你的项目内(也即把 QMUI 作为你的项目的子项目)。
打开你的项目的 project,在 General -> Embedded Binaries 中点击加号添加 QMUIKit.framework
,此时 Embedded Binaries 和 Linked Frameworks and Libraries 里应该都会出现 QMUIKit.framework
。
*注意:如果使用 command-line 编译错误,提示 #import <QMUIKit/QMUIKit.h>
找不到文件,请在项目的 Build Settings -> Header Search Paths 中添加 QMUI iOS 所在的目录。
至此 QMUI iOS 已完全接入到项目中,需要使用的地方请直接 #import <QMUIKit/QMUIKit.h>
,不建议只 import 用到的控件的 .h
文件,否则内部一些逻辑可能无法正确依赖。
QMUI iOS 主要由 5 大部分组成:
UIViewController
的基类,建议将这几个基类作为你项目里的对应 class 的父类,QMUI iOS 有大量功能也是基于这几个基类实现。UIKit
的拓展,所有 Category 的方法、属性均会带 qmui_
前缀,以避免冲突。若想快速了解完整的功能,请查看功能列表;若想了解某个 class 的具体使用方式,建议下载 QMUI Demo 的源码。
QMUI 提供一份配置表 QMUIConfigurationTemplate
用于快速配置整个项目的样式,但这份配置表默认不参与编译,需要的时候请自行复制到项目 project 里并修改里面的值。下面根据 3 种不同的安装方式分别列出详细步骤。
请在项目左侧的 Project navigator 里找到 QMUIKit,右键点击选择 Show in Finder
,然后在打开的窗口里找到目录 QMUIConfigurationTemplate
,将其中的两个文件拖到你项目 Xcode 的 Project navigator 里,注意选择 Copy items if needed
。
请在 Finder 里打开 Carthage/Checkouts/QMUI_iOS/
,将其中的 QMUIConfigurationTemplate
文件夹拖到项目的 Xcode Project navigator 中,注意选择 Copy items if needed
。
展开 Project navigator 里的 qmui.xcodeproj,找到 QMUIConfigurationTemplate
文件夹,右键点击 Show in Finder
,在文件管理器里把 QMUIConfigurationTemplate
文件夹拖到你的项目里,注意选择 Copy items if needed
。