To run the example project, clone the repo, and run pod install from the Example directory first.
There is a test case in Example/Tests/Tests.m. It's a good start to understand how to write mixin in Object-C.
#import <ObjCMixin/ObjCMixin.h>Declare a module.
@module(MyModule)
@property(nonatomic, strong) NSString *prefix;
- (void)saySomething:(NSString *)something;
@endImplement module methods in a .m file.
@module_implementation(MyModule)
// Module must implement methods required by property explicitly.
- (NSString *)prefix {
// Use `module_ivar` to retrieve a variable in module.
return module_ivar(self, prefix);
}
- (void)setPrefix:(NSString *)prefix {
// Update module instance variable.
module_ivar(self, prefix) = prefix;
}
// Implement method as usual.
- (void)saySomething:(NSString *)something {
NSString *prefix = _prefix;
NSLog(@"%@: %@", prefix, something);
}
@endDeclare an interface.
@interface Foo : NSObject<MyModule>
- (void)foo;
@endImplement Foo's method and mixin it with MyModule in a .m file.
@mixin(Foo, MyModule)
@implementation Foo
- (void)foo {
NSLog(@"Foo");
}
@endUse Foo to call methods in MyModule.
Foo *f = [[Foo alloc] init];
[f hello];
[f foo];
f.prefix = @"Hey";
NSLog(@"%@, you!", f.prefix);ObjCMixin provides following macros to make mixin cool.
@module(ModuleName): Declare a module.@module_implementation(ModuleName): Implement module methods.@mixin(TargetClass, ModuleName): Copy all methods from module toTargetClass.module_ivar(self, ivar): Get or set a variable binded with module instance.
ObjCMixin uses Object-C runtime api to hack classes. Due to runtime api limitations, ObjCMixin can only copy module methods to target class. Instance variables and synthesized properties cannot be copied from module class to target class.
Basically, a module can be considered as a category. The only difference between a module and a category is that code in module can be shared among more than one interface.
ObjCMixin is available through CocoaPods. To install it, simply add the following line to your Podfile:
pod "ObjCMixin", "~> 0.1.0"Huan Du, i@huandu.me
ObjCMixin is available under the MIT license. See the LICENSE file for more info.