使用 FFSafeKit 安全地使用 NSArray、NSMutableArray、NSDictionary、NSMutableDictionary、NSMutableString。
特性
- 安全访问
NSArray
- 安全访问
NSDictionary
- 安全访问和修改
NSMutableArray
- 安全访问和修改
NSMutableDictionary
- 安全访问和修改
NSMutableString
系统要求
- iOS 8.0+ / macOS 10.13.6+
- Xcode 10.1 (10B61)+
示例
要运行 FFSafeKit
项目,克隆仓库,然后在 Xcode 中启动 FFSafeKit
。
$ git clone https://github.com/JonyFang/FFSafeKit.git
$ cd FFSafeKit
$ cd Shell && sh install-bundle.sh && sh install-pods.sh && cd ..
$ open FFSafeKit.xcworkspace
安装
有三种方法可以在项目中使用 FFSafeKit:
- 使用 CocoaPods 安装
- 使用 Carthage 安装
手动
安装
苹果Pods
苹果Pods 是一个依赖管理器,它可以自动化并简化在你的项目中使用第三方库(如 FFSafeKit)的过程。首先,将以下行添加到你的 Podfile
pod 'FFSafeKit'
如果你想使用 FFSafeKit 的最新功能,请使用常规外部源依赖项。
pod 'FFSafeKit', :git => 'https://github.com/JonyFang/FFSafeKit.git'
这将从主分支直接拉取。
其次,将 FFSafeKit 安装到你的项目中
$ pod install
卡丁车
卡丁车 是一个去中心化的依赖管理器,它构建你的依赖并提供你去程框架。
你可以使用以下命令通过 Homebrew 来安装卡丁车:
$ brew update
$ brew install carthage
要使用卡丁车将 FFSafeKit 集成到你的 Xcode 项目中,请在你的 Cartfile
中指定它
github "JonyFang/FFSafeKit"
运行以下命令来构建框架
$ carthage update
将构建的 FFSafeKit.framework
二进制文件从 Carthage/Build/iOS
拖到你的 Xcode 项目的应用程序中。
在你的应用程序目标的 构建阶段
设置选项卡上,单击 + 图标
并选择 新建执行脚本阶段
。创建一个 执行脚本
在其中指定你的 shell(例如:/bin/sh
),并在下面的 shell 下方添加以下内容到脚本区域
/usr/local/bin/carthage copy-frameworks
将以下路径添加到 Input Files
下你想使用的框架中。
$(SRCROOT)/Carthage/Build/iOS/FFSafeKit.framework
关于深入指南,请从 将框架添加到应用程序 中继续阅读。
手动
或者你可以直接将 FFSafeKit 框架
的源文件添加到你的项目中。
- 下载最新的代码版本 [此处链接] 或将存储库作为 Git 子模块添加到你的 git 跟踪项目中。
- 在 Xcode 中打开你的项目,然后拖动
FFSafeKit 框架
到你的项目(使用产品导航视图
)。如果你在项目外解压缩了代码归档,确保选择复制项目
。 - 使用
#import "FFSafeKit.h"
在需要的地方包含 FFSafeKit。
使用方法
将库导入到你希望使用它的地方。
#import <FFSafeKit.h>
//Set `YES` to enable error logs for debug.
[FFSafeHelper ff_setupStatusToDebug:NO exceptionBlock:^(NSException * _Nonnull exception) {
NSLog(@"== exception ==\n%@", exception);
}];
许可证
FFSafeKit
遵循 MIT 许可协议。有关更多信息,请参阅 LICENSE 文件。