开始使用

如何安装

QMUI iOS 有 3 种使用方式,一种是直接下载项目代码并将其作为子项目添加到主项目内使用;另外两种是通过 CocoaPods 或 Carthage 的方式来管理。

CocoaPods 或 Carthage 的方式

请查看我们的 README

直接下载项目的方式

GitHub上下载 QMUI iOS 项目,把QMUI项目拷贝到你的项目文件夹里面,然后将qmui.xcodeproj 拖到Xcode项目的某个目录中(也就是把 QMUI 作为你的项目的子项目)。

直接下载项目的安装方式

如何使用

点击项目 project 进入 Xcode 配置界面,在 General -> Linked Frameworks and Libraried 点击加号搜索并添加 QMUIKit.framework 到列表里面,并且在 General -> Embedded Binaries 中点击加号搜索并添加 QMUIKit.framework 到列表里面(否则真机运行会报错:dyld: Library not loaded:...),然后在使用的地方 #import <QMUIKit/QMUIKit.h> 即可(如果有 pch 文件,只要在 pch 文件中 import 一次就够了)。

添加 framework 文件

在QMUI项目里面找到一个配置文件:QMUIConfigurationTemplate这个类,复制一份到项目目录中(位置根据项目自己决定),按需修改里面的配置值即可统一修改全局的UI样式。

复制配置文件

在 appDelegate 的 application:didFinishLaunchingWithOptions: 里面启动QMUI配置文件和初始化全局的样式,具体代码如下:

启动 QMUI 配置文件

注意事项

QMUI 默认提供的 framework 是动态库,所以仅在 iOS 8 及以上版本才可使用,如果需要兼容 iOS7,需要在 QMUIKit.framework target 的 Build Setting 中搜索 Mach-O 修改为静态库即可;或者可以使用QMUI项目里面提供的静态库libQMUI.a。

如果使用静态的framework或者.a文件,那么需要在你的项目中的 Build Setting 里面搜索 Header Search Paths 并添加对应的QMUI路径,以便你的项目可以找到QMUI的头文件,否则会报错找不到QMUI的头文件。另外,如果项目跑起来之后会crash,请检查一下 Build Setting 里面 Other Linker Flags 是否有加入 -ObjC。

静态的 framework 设置

最后,在QMUI项目中找到两个bundle图片资源文件 QMUIResources.boundle 和 QMUI_QQEmotion.bundle 拖到你的项目目录中(不需要copy,只需引用到项目中)。

bundle 的使用

使用效果

效果图