Latest | 1.0.2 |
---|---|
Homepage | https://github.com/qddnovo/AutoPropertyCocoa |
License | MIT |
Platforms | osx 10.10, ios 7.0, tvos 9.0, watchos 2.0, requires ARC |
Authors |

AutoPropertyCocoa
Introduction
- Provides
lazy loading
of property and object-orientedproperty hook
by objc runtime.Perfect closed loop, can be added or unloaded.More powerful than lazy loading of macro definitions. - Key words :
iOS lazy loading
macOS lazy loading
property hook
iOS懒加载
属性钩子
class_removeMethods
runtimelock
- 中文文档
Import
-
Drag directory
AutoPropertyCocoa
into project or use cocoapods#import "AutoPropertyCocoa.h"
Main target
-
(id)lazyloadProperty{
if(_lazyloadProperty == nil){
_lazyloadProperty = [XClass ...];
}
return _lazyloadProperty;
}
=>
[instance apc_lazyLoadForProperty:@lazyloadProperty usingBlock:^id(id_apc_t instance){
return [XClass ...];
}];
## Examples
#### Lazy loading of instance.Low coupling, no type pollution, recommended!
```objc
APCLazyload(instance, @propertyA, @propertyB, ...);
[instance apc_lazyLoadForProperty:@property usingBlock:^id(id_apc_t instance){
return ...;
}];
[instance apc_lazyLoadForProperty:@arrayProperty selector:@selector(array)];
Unbind lazy loading of instance is supported.
APCUnbindLazyload(instance, @propertyA, @propertyB, ...);
[instance apc_unbindLazyLoadForProperty:@property];
Lazy loading of class.
APCClassLazyload(Class, propertyA, propertyB, ...);
APCClassUnbindLazyload(Class, propertyA, propertyB, ...);
Front-trigger hook.Called before a property is called.
[anyone apc_frontOfPropertyGetter:key bindWithBlock:^(id_apc_t instance, id value) {
///Before getter of property called.
}];
Post-trigger hook.Called after a property is called.
[anyone apc_backOfPropertySetter:key bindWithBlock:^(id_apc_t instance, id value) {
///After setter of property called.
}];
Condition-trigger hook.Called when the user condition is true.
[anyone apc_propertySetter:key bindUserCondition:^BOOL(id_apc_t instance, id value) {
///Your condition when setter called...
} withBlock:^(id_apc_t instance, id value) {
///If your condition has been triggered.
}];
Basic-value type
The currently supported structure types are: XReact, XPoint, XSize, XEdgeinsets, NSRange.
- Lazy-load is invalid on the base-value type property of the class hook.But is valid on the instance, The lazy loading method is triggered when the instance’s underlying value type property is first accessed.
User super method.
- APCUserEnvironment supports user call user method in super class.
-
id_apc_t
marks the id object as supporting APCUserEnvironment.[Person apc_lazyLoadForProperty:key usingBlock:^id (id_apc_t instance) { return @"Person.gettersetterobj"; }];
[Man apc_lazyLoadForProperty:key usingBlock:^id (id_apc_t instance) {
//Call above ↑
return APCSuperPerformedAsId(instance);
}];
[Superman apc_lazyLoadForProperty:key usingBlock:^id (id_apc_t instance) {
//Call above ↑
return APCSuperPerformedAsId(instance);
}];
## Lazy loading of instance thread safe.
- You can ignore the next instructions, If you don't access the property while binding the property, or access the property while unbinding the property, or bind the property when unbinding the property.
- In a large number of `multi-threaded` concurrency, bind - unbind, bind - access property, unbind - access property, has a small probability of generating an error : 'Attempt to use unknown class.'The error occurred when an object was accessed when object_setClass() was not completed. Although this probability is relatively small, it is still worthy of attention.This project has implemented the hooking of the runtimelock, which is used to achieve thread safety, but this seriously affects the efficiency, so instead of adopting the scheme, the scheme below is used.
- It is absolutely safe to use the following form in multi-threaded :
```objc
///Thread-A...
apc_safe_instance(instance, ^(id object) {
APCLazyload(object, property);
});
///Thread-B...
apc_safe_instance(instance, ^(id object) {
APCUnbindLazyload(object, property);
});
///Thread-C...
apc_safe_instance(instance, ^(Man* object) {
[object accessProperty];
});
Lazy loading of class thread safe.
- You can ignore here, if you nerver unbind class hook.
- Bind or unbind a class hook is
thread safe
. - If the hooked class needs to be unbind, it is recommended that you implement the following method in main().
int main(int argc, const char * argv[]) {
/*
1. Call before app or runtime load!
2. This method will implement the function of deleting the method at runtime,
and if it is not called, it will adopt the scheme of analog deletion,
which will affect the user's use of the method swizzle.
The effect is that the correct class must be used to method-swizzle ,
get Method , get imp.
Exp :
class_replaceMethod(CorrectClass, ...);
class_getInstanceMethod(CorrectClass, ...);
*/
apc_main_classHookFullSupport();
return ... ...(argc, argv);
}
## Possible to do
- Support all structure types
- New dynamic border
## Author
- Emergency : [email protected]
Latest podspec
{ "name": "AutoPropertyCocoa", "version": "1.0.2", "platforms": { "osx": "10.10", "ios": "7.0", "tvos": "9.0", "watchos": "2.0" }, "summary": "Cocoa lazy loading of property and object-oriented property hook by objc runtime.", "homepage": "https://github.com/qddnovo/AutoPropertyCocoa", "license": "MIT", "authors": { "Meterwhite": "[email protected]" }, "requires_arc": true, "source": { "git": "https://github.com/qddnovo/AutoPropertyCocoa.git", "tag": "1.0.2" }, "source_files": "AutoPropertyCocoa/**/*.{h,c,m,mm}" }
Wed, 05 Jun 2019 10:23:08 +0000