New file |
| | |
| | | YYCategories |
| | | ============== |
| | | |
| | | [](https://raw.githubusercontent.com/ibireme/YYCategories/master/LICENSE) |
| | | [](https://github.com/Carthage/Carthage) |
| | | [](http://cocoapods.org/?q=YYCategories) |
| | | [](http://cocoapods.org/?q=YYCategories) |
| | | [](https://www.apple.com/nl/ios/) |
| | | [](https://travis-ci.org/ibireme/YYCategories) |
| | | |
| | | A set of useful categories for Foundation and UIKit.<br/> |
| | | (It's a component of [YYKit](https://github.com/ibireme/YYKit)) |
| | | |
| | | Documentation |
| | | ============== |
| | | |
| | | You can build and install docset use `Docset` scheme in Xcode, `appledoc` need to be pre-installed. |
| | | Or your can read the [Documentation](http://github.ibireme.com/doc/YYCategories/index.html) online. |
| | | |
| | | |
| | | Installation |
| | | ============== |
| | | |
| | | ### CocoaPods |
| | | |
| | | 1. Add `pod 'YYCategories'` to your Podfile. |
| | | 2. Run `pod install` or `pod update`. |
| | | 3. Import \<YYCategories/YYCategories.h\>. |
| | | |
| | | |
| | | ### Carthage |
| | | |
| | | 1. Add `github "ibireme/YYCategories"` to your Cartfile. |
| | | 2. Run `carthage update --platform ios` and add the framework to your project. |
| | | 3. Import \<YYCategories/YYCategories.h\>. |
| | | |
| | | |
| | | ### Manually |
| | | |
| | | 1. Download all the files in the YYCategories subdirectory. |
| | | 2. Add the source files to your Xcode project. |
| | | 3. Add `-fno-objc-arc` compiler flag to `NSObject+YYAddForARC.m` and `NSThread+YYAdd.m`. |
| | | 4. Link with required frameworks: |
| | | * UIKit |
| | | * CoreGraphics |
| | | * QuartzCore |
| | | * Accelerate |
| | | * ImageIO |
| | | * CoreText |
| | | * CoreFoundation |
| | | * libz |
| | | 5. Import `YYCategories.h`. |
| | | |
| | | |
| | | Documentation |
| | | ============== |
| | | Full API documentation is available on [CocoaDocs](http://cocoadocs.org/docsets/YYCategories/).<br/> |
| | | You can also install documentation locally using [appledoc](https://github.com/tomaz/appledoc). |
| | | |
| | | |
| | | Requirements |
| | | ============== |
| | | This library requires `iOS 6.0+` and `Xcode 7.0+`. |
| | | |
| | | |
| | | Notice |
| | | ============== |
| | | I want to use the APIs as if it was provided by system, so I don't add prefix in |
| | | these categories. This may cause some potential problems(such as conflict with other libraries), so if you just need some pieces of code |
| | | in this project, pick them out and don't import the whole library. |
| | | |
| | | |
| | | License |
| | | ============== |
| | | YYCategories is provided under the MIT license. See LICENSE file for details. |
| | | |
| | | |
| | | |
| | | |
| | | <br/><br/> |
| | | --- |
| | | 中文介绍 |
| | | ============== |
| | | 功能丰富的 Category 类型工具库。<br/> |
| | | (该项目是 [YYKit](https://github.com/ibireme/YYKit) 组件之一) |
| | | |
| | | 文档 |
| | | ============== |
| | | |
| | | 你可以用 `Docset` scheme 来生成文档 (需要预先安装 appledoc),或者[在线查看](http://github.ibireme.com/doc/YYCategories/index.html)。 |
| | | |
| | | |
| | | 安装 |
| | | ============== |
| | | |
| | | ### CocoaPods |
| | | |
| | | 1. 在 Podfile 中添加 `pod 'YYCategories'`。 |
| | | 2. 执行 `pod install` 或 `pod update`。 |
| | | 3. 导入 \<YYCategories/YYCategories.h\>。 |
| | | |
| | | |
| | | ### Carthage |
| | | |
| | | 1. 在 Cartfile 中添加 `github "ibireme/YYCategories"`。 |
| | | 2. 执行 `carthage update --platform ios` 并将生成的 framework 添加到你的工程。 |
| | | 3. 导入 \<YYCategories/YYCategories.h\>。 |
| | | |
| | | |
| | | ### 手动安装 |
| | | |
| | | 1. 下载 YYCategories 文件夹内的所有内容。 |
| | | 2. 将 YYCategories 内的源文件添加(拖放)到你的工程。 |
| | | 3. 为 `NSObject+YYAddForARC.m` 和 `NSThread+YYAdd.m` 添加编译参数 `-fno-objc-arc`。 |
| | | 4. 链接以下 frameworks: |
| | | * UIKit |
| | | * CoreGraphics |
| | | * QuartzCore |
| | | * Accelerate |
| | | * ImageIO |
| | | * CoreText |
| | | * CoreFoundation |
| | | * libz |
| | | 5. 导入 `YYCategories.h`。 |
| | | |
| | | |
| | | 文档 |
| | | ============== |
| | | 你可以在 [CocoaDocs](http://cocoadocs.org/docsets/YYCategories/) 查看在线 API 文档,也可以用 [appledoc](https://github.com/tomaz/appledoc) 本地生成文档。 |
| | | |
| | | 系统要求 |
| | | ============== |
| | | 该项目最低支持 `iOS 6.0` 和 `Xcode 7.0`。 |
| | | |
| | | |
| | | 注意 |
| | | ============== |
| | | 我希望调用 API 时,有着和调用系统自带 API 一样的体验,所以我并没有为 Category 方法添加前缀。我已经用工具扫描过这个项目中的 API,确保没有对系统 API 产生影响。我知道没有前缀的 Category 可能会带来麻烦(比如可能和其他某些类库产生冲突),所以如果你只需要其中少量代码,那最好将那段代码取出来,而不是导入整个库。 |
| | | |
| | | |
| | | 许可证 |
| | | ============== |
| | | YYCategories 使用 MIT 许可证,详情见 LICENSE 文件。 |
| | | |
| | | |