把极致带到开发中去
0%

发表于 更新于 分类于

〈extreme.framework/EFBaseWebViewController.h〉

这个控制器集成了 WebView及一般使用方法。

一般 General[这是什么?]

1.5~[这是什么?]

-loadURL:[这是什么?]

请求 URL，并在 web view中显示，在子类中可直接调用。[这是什么?]

参数：

URL_string 请求网址，必须是一个合法的URL字符串 NSString 必填

返回值：

无

1
2
3
4
5
6
7
8
9
10
11
12
13
@property (strong, nonatomic, nonnull) WKWebView *webView;

/**
 Web页是否已重新加载过
 */
@property (assign, nonatomic, getter=isReloaded) BOOL reloaded;

/**
 请求 URL，并在 web view中显示，通过项目中的基类设置。(Setup in EFBaseWebViewController based view controller.)

 @param URL_string 请求网址
 */
- (void)loadURL:(NSString *_Nonnull)URL_string;

[这是什么?]

1.5

UIWebView 已被弃用。

1
@property (strong, nonatomic, nonnull) UIWebView *webView;
阅读全文 »

发表于 更新于 分类于

〈extreme.framework/EFConfig.h〉

极致框架提供设置透明样式导航栏的能力，此处枚举陈列了导航栏的所有样式。

1.5～[这是什么?]

1
2
3
4
5
6
// Type for EFBarStyle
typedef NS_ENUM(NSInteger, EFBarStyle) {
    EFBarStyleDefault = 0,  // 等同于 UIBarStyleDefault(Same as UIBarStyleDefault)
    EFBarStyleBlack,        // 等同于 UIBarStyleBlack(Same as UIBarStyleBlack)
    EFBarStyleTranslucent   // 透明风格(New translucent style)
};

[这是什么?]

更新内容

更新了描述内容。

发表于 更新于 分类于

〈extreme.framework/EFMacros.h〉

OS 获取系统基本信息[这是什么?]

1.5～[这是什么?]

1
2
//MARK: OS
#define OS_VERSION    [UIDevice currentDevice].systemVersion.floatValue

[这是什么?]

App 获取 App基本信息

1.5～

1
2
3
4
//MARK: App
#define APP_VERSION   [[[NSBundle mainBundle] infoDictionary] objectForKey:@"CFBundleShortVersionString"]
#define APP_BUILD     [[[NSBundle mainBundle] infoDictionary] objectForKey:@"CFBundleVersion"]
#define APP_NAME      [[[NSBundle mainBundle] infoDictionary] objectForKey:@"CFBundleDisplayName"]

Application 获取全局基本信息

2.0～

1
#define APP_DELEGATE           APPLICATION.delegate

1.5～

1
2
3
4
5
6
7
//MARK: Application
#define APPLICATION            [UIApplication sharedApplication]
#define WINDOW                 APPLICATION.keyWindow
#define STATUSBAR_HEIGHT       [APPLICATION statusBarFrame].size.height
#define SAFEAREA_INSETS        WINDOW.safeAreaInsets
#define USER_DEFAULTS          [NSUserDefaults standardUserDefaults]
#define NOTIFICATION_CENTER    [NSNotificationCenter defaultCenter]
阅读全文 »

发表于 分类于

〈extreme.framework/NSTimer+EFBlockSupport.h〉

1.5~[这是什么?]

+ef_scheduledTimerWithTimeInterval:block:repeats:[这是什么?]

使用 ef_scheduledTimerWithTimeInterval:block:repeats: 来避免循环引用。[这是什么?]

参数：

interval 循环周期 NSTimeInterval
block 执行块 void(^)(void)
repeats BOOL 是否循环执行，YES 循环执行 NO 执行一次

返回值：

NSTimer NSTimer实例。

1
2
3
4
5
6
7
8
9
/**
 使用 ef_scheduledTimerWithTimeInterval: block: repeats: 来避免循环引用

 @param interval 循环周期
 @param block 执行块
 @param repeats 是否循环执行
 @return 返回 NSTimer实例
 */
+ (NSTimer *)ef_scheduledTimerWithTimeInterval:(NSTimeInterval)interval block:(void(^)(void))block repeats:(BOOL)repeats;

[这是什么?]

发表于 更新于 分类于

开发文档撰写约定

1. 小节的名称

每页文档都由若干个按功能区分的小节组成。（小节的描述，可以为空）

1.1 子小节的名称（小节通常也可以直接由若干个子小节构成，小节的名称与子小节的名称都可以是适用版本、子功能名称或者方法名等之一，主要看那种划分后续维护更方便。）

每个层级都可以有描述，可以为空。

1.1.1 如果你还想划分更小的小节…

最后可以加更详细的描述、示例代码等。

适用版本介绍：
1.5~ 指代适用于1.5以及之后的框架版本。
1.5~2.0 指代适用于1.5至2.0的框架版本，不适用于更早或者更新版本。需要注意这部分的定义代码已在更新版本弃用。
2.0 指代仅适用于2.0的框架版本，不适用于其它的框架版本。

更新内容

添加了适用版本说明。

发表于 更新于 分类于

〈extreme.framework/EFUtils.h〉

常用工具归于一处。

2.0～[这是什么?]

+objectIsNilOrNull:[这是什么?]

对象判空。(Validate the object is nil or null.)[这是什么?]

参数：

object 对象实例 id 必填

返回值：

BOOL 检查结果，YES 不存在或为空 NO 不为空。

1
+ (BOOL)objectIsNilOrNull:(id _Nonnull)object;

[这是什么?]

+stringIsNilOrNullOrEmpty:

字符串判空。(Validate the string is nil or null or empty.)

参数：

string NSString实例 NSString 必填

返回值：

BOOL 检查结果，YES 不存在或为空 NO 不为空。

1
+ (BOOL)stringIsNilOrNullOrEmpty:(NSString *_Nonnull)string;

+validateString:byRegExp:

使用正则表达式验证字符串值。(Validate the string by a regular expression.)

参数：

stringValue NSString实例 NSString 必填
regExp 用于验证的正则表达式 NSString 必填

返回值：

BOOL 检查结果，YES 合法 NO 不合法。

1
+ (BOOL)validateString:(NSString *_Nonnull)string byRegExp:(NSString *_Nonnull)regExp;

+objectValueIsNilOrNull:withKey:

字典中指定键值判空。(Validate the key value in a dictionary is nil or null.)

参数：

dictionary NSDictionary实例 NSDictionary 必填
key 键 NSString 必填

返回值：

BOOL 检查结果，YES 不存在或为空 NO 不为空。

1
+ (BOOL)objectValueIsNilOrNull:(NSDictionary *_Nonnull)dictionary withKey:(NSString *_Nonnull)key;

+objectValueIsEqualTo:dictionary:withKey:

字典中指定键值是否等于指定数值。(Validate the key value in a dictionary is equal to another integer value in a NSNumber or NSString object or not.)

参数：

value NSNumber或者 NSString实例，其中包含一个整数值 id 必填
dictionary NSDictionary实例 NSDictionary 必填
key 键 NSString 必填

返回值：

BOOL 检查结果，YES 等于 NO 不等于。

1
+ (BOOL)objectValueIsEqualTo:(id _Nonnull)value dictionary:(NSDictionary *_Nonnull)dictionary withKey:(NSString *_Nonnull)key;

+validateDictionary:

字典中所有的值都不为空，注意之前 +validDictionary: 返回的值已发生反转。(Validate all values in a dictionary is all not empty, note that the returned value from +validDictionary: has been reversed.)

参数：

dictionary NSDictionary实例 NSDictionary 必填

返回值：

BOOL 检查结果，YES 均不为空 NO 不是字典或者字典中至少一个键值不存在或为空。

1
+ (BOOL)validateDictionary:(NSDictionary *_Nonnull)dictionary;
阅读全文 »

发表于 更新于 分类于

〈extreme.framework/EFBaseTableViewController.h〉

基于 EFBaseTableViewController的控制器赋予了众多基于 UITableViewController的控制器所不具备的能力。

1. 状态栏与导航栏[这是什么?]

2.0~[这是什么?]

1
2
3
4
5
6
7
8
9
/**
 自定义返回事件回调。(Custom back callback handler use block.)
 */
@property (strong, nonatomic, nullable) void(^customBackHandler)(id _Nonnull sender);

/**
 自定义取消事件回调。(Custom cancel callback handler use block.)
 */
@property (strong, nonatomic, nullable) void(^customCancelHandler)(id _Nonnull sender);

[这是什么?]

1.5~

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
#pragma mark - 状态栏与导航栏 StatusBar and NavigationBar
/**
 状态栏是否隐藏，默认不启用。 (NO as default.)
 */
@property (assign, nonatomic) BOOL statusBarHidden;

/**
 导航栏样式，EFBarStyle于 EFConfig中定义，默认使用 EFBarStyleDefault——等同于 UIBarStyleDefault。 (Set the navigationBarStyle as EFBarStyle defined in EFConfig, EFBarStyleDefault as default, same as UIBarStyleDefault.)
 */
@property (assign, nonatomic) EFBarStyle navigationBarStyle;
/**
 直接访问导航栏(Access the navigation bar directly.)
 */
@property (strong, nonatomic, readonly, nullable) EFNavigationBar *navigationBar;

/**
 使用自定义返回，默认使用 extreme.bundle中名为“back”的图像，默认不启用。(Use custom back on the navigation bar, NO as default, default image as image named "back" in extreme.bundle.)
 */
@property (assign, nonatomic, getter=isUseCustomBack) BOOL useCustomBack;
/**
 可在使用自定义返回时自定义返回按钮。(For custom appearance of the back button when use custom back.)
 */
@property (strong, nonatomic, nullable) UIBarButtonItem *customBack_barButtonItem;

/**
 可在外部调用时用于自定义取消按钮。(For custom appearance of the cancel button when present modally.)
 */
@property (strong, nonatomic, nullable) UIBarButtonItem *customCancel_barButtonItem;

1.5

1
2
3
4
5
6
7
8
9
/**
 自定义返回事件回调。(Custom back callback use block.)
 */
@property (strong, nonatomic, nullable) void(^tapCustomBack)(id _Nonnull sender);

/**
 自定义取消事件回调。(Custom cancel callback use block.)
 */
@property (strong, nonatomic, nullable) void(^tapCustomCancel)(id _Nonnull sender);
阅读全文 »

发表于 更新于 分类于

〈extreme.framework/EFBaseViewController.h〉

基于 EFBaseViewController的控制器赋予了众多基于 UIViewController的控制器所不具备的能力。

1. 状态栏与导航栏[这是什么?]

2.0~[这是什么?]

1
2
3
4
5
6
7
8
9
/**
 自定义返回事件回调。(Custom back callback handler use block.)
 */
@property (strong, nonatomic, nullable) void(^customBackHandler)(id _Nonnull sender);

/**
 自定义取消事件回调。(Custom cancel callback handler use block.)
 */
@property (strong, nonatomic, nullable) void(^customCancelHandler)(id _Nonnull sender);

[这是什么?]

1.5~

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
#pragma mark - 状态栏与导航栏 StatusBar and NavigationBar
/**
 状态栏是否隐藏，默认不启用。 (NO as default.)
 */
@property (assign, nonatomic) BOOL statusBarHidden;

/**
 导航栏样式，EFBarStyle于 EFConfig中定义，默认使用 EFBarStyleDefault——等同于 UIBarStyleDefault。 (Set the navigationBarStyle as EFBarStyle defined in EFConfig, EFBarStyleDefault as default, same as UIBarStyleDefault.)
 */
@property (assign, nonatomic) EFBarStyle navigationBarStyle;
/**
 直接访问导航栏(Access the navigation bar directly.)
 */
@property (strong, nonatomic, readonly, nullable) EFNavigationBar *navigationBar;

/**
 使用自定义返回，默认使用 extreme.bundle中名为“back”的图像，默认不启用。(Use custom back on the navigation bar, NO as default, default image as image named "back" in extreme.bundle.)
 */
@property (assign, nonatomic, getter=isUseCustomBack) BOOL useCustomBack;
/**
 可在使用自定义返回时自定义返回按钮。(For custom appearance of the back button when use custom back.)
 */
@property (strong, nonatomic, nullable) UIBarButtonItem *customBack_barButtonItem;

/**
 可在外部调用时用于自定义取消按钮。(For custom appearance of the cancel button when present modally.)
 */
@property (strong, nonatomic, nullable) UIBarButtonItem *customCancel_barButtonItem;

1.5

1
2
3
4
5
6
7
8
9
/**
 自定义返回事件回调。(Custom back callback use block.)
 */
@property (strong, nonatomic, nullable) void(^tapCustomBack)(id _Nonnull sender);

/**
 自定义取消事件回调。(Custom cancel callback use block.)
 */
@property (strong, nonatomic, nullable) void(^tapCustomCancel)(id _Nonnull sender);
阅读全文 »

发表于 更新于 分类于

中文 | English

新的正式版可用: V1.5 最终版(更新于2019-9-30)

更新内容

1.5 2019-9-30

1 EFMacros: ROOT_VC调整，适用范围更广。
2 EFUtils:
2.1 新增了boolValueFromNumber:，可快速从NSNumber获取boolValue。
2.2 新增了2个NSDictionary的实用工具方法：将指定键值转换为字符串、判断指定键值是否与指定数值相等。
2.3 修复了2个NSDictionary的实用工具方法结果有时不正确的问题：判断指定键值是否为空、判断所有键值是否存在空。
3 EFBase:
3.1 EFNavigationBar深色模式除了按钮颜色，现在也作用于标题颜色。
3.2 EFBaseViewController/EFBaseTableViewController:
3.2.1 新增使用位置授权的独立方法，并解决了使用位置授权弹框很久才显示的问题。
3.2.2 改进了控制器自定义返回和自定义取消的处理逻辑，支持随时开关，可先自定义返回按钮/自定义取消按钮。
3.2.3 优化了照片选择器，现支持拍照时默认前置摄像头。
3.3 EFBaseWebViewController: 初始加载时标题显示页面加载中。现在关闭按钮能及时显示了。
3.4 BaseDataModel: dataID和dataName不再要求必须提供。
4 ImageUploadTool: 支持自定义图片上传接口路径和用于自定义图片上传接口的image Key，并可自定义上传时的提示信息。
5 AppConfig: 归类并增加说明，更有条理。
6 AppMacros: Theme Colors配置项移至AppConfig。
7 AppDelegate: 新增App首次运行的NSUserDefaults的配置项: init once。
8 请求位置信息另外添加了总是使用位置的隐私权限描述。
9 同步改进的演示App，集成 AFHTTPTool的演示。
10 彩蛋：登录界面图标连续点击切换服务器环境，仅开发测试有效。

阅读全文 »