https://github.com/rickytan/fixit
Yet another javascript fixing solution for Objective-C
https://github.com/rickytan/fixit
aspect bugfix fixit javascript javascriptcore js objc runtime
Last synced: 5 months ago
JSON representation
Yet another javascript fixing solution for Objective-C
- Host: GitHub
- URL: https://github.com/rickytan/fixit
- Owner: rickytan
- License: mit
- Created: 2018-12-10T09:00:31.000Z (about 7 years ago)
- Default Branch: master
- Last Pushed: 2020-07-16T12:45:24.000Z (over 5 years ago)
- Last Synced: 2025-06-26T21:40:22.546Z (6 months ago)
- Topics: aspect, bugfix, fixit, javascript, javascriptcore, js, objc, runtime
- Language: Objective-C
- Homepage:
- Size: 74.2 KB
- Stars: 8
- Watchers: 2
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# FIXiT
[](https://travis-ci.org/rickytan/FIXiT)
[](https://cocoapods.org/pods/FIXiT)
[](https://cocoapods.org/pods/FIXiT)
[](https://cocoapods.org/pods/FIXiT)
## 简介
此项目可以理解为 **JS** 版的 **[Aspect](https://github.com/steipete/Aspects)**
## 用法示例（快速入手）
### 修复已有方法的 Bug
OC 中定义了类型：
```objc
@implementation NSObject (Crash)
- (void)crashIt
{
NSLog(@"%@", @[][1]);
}
- (CGPoint)locationOf:(NSArray *)locations
atIndex:(NSInteger)index
defaultValue:(CGPoint)point
{
return locations[index].CGPointValue;
}
@end
```
添加 JS 文件以修复：
```javascript
var fix = Fixit.fix('NSObject');
fix.instanceMethod('crashIt', function () {
});
// fix.instanceMethod 返回原实现
var originMethod = fix.instanceMethod('locationOf:atIndex:defaultValue:', function (locations, index, point) {
// 此函数中的 this 就是 OC 的实例
if (index < locations.length) {
return locations[index];
// 或者调原实现
return originMethod.apply(this, arguments);
// 等价于
return originMethod.call(this, locations, index, point);
}
return point; // 这里的 point 会变为 NSValue，直接返回即可
});
```
### 在原有实现上添加行为
已有的 OC 类定义：
```objc
@implementation MyViewController
{
UIButton * _button;
}
- (void)viewDidLoad
{
[super viewDidLoad];
...
}
```
添加 JS 文件以添加行为：
```javascript
require('UIAlertView, UIColor');
var fix = Fixit.fix('MyViewController');
var originViewDidLoad = fix.instanceMethod('viewDidLoad', function () {
// 先调原实现
originViewDidLoad.apply(this, arguments);
this.view.backgroundColor = UIColor.yellowColor;
// 或者
this.view['setBackgroundColor:'](UIColor.yellowColor);
// [] 取 JS 的属性或方法，当无参数时是属性，有参数时是方法
var button = this['_button']; // 与 this._button 等价
// button 变量是 nil 安全的，当然也可以判断一下，使用 isNil 函数，
// 而不能 if (button == nil)，或者 if (button)。
// 所有不能转为 JS 对象的 OC 对象在 JS 代码中都是一个代理对象（Proxy）
if (!isNil(button)) {
// 调用时参数需要与 OC 中对应
button['setTitle:forState:']('test title', 0);
}
// 创建一个弹窗，注意使用 nil，而不是 null
var that = this;
dispatch_after(2, function() {
// 注意 JS context 的变化，这里的 this 已经不是 MyViewController 了
UIAlertView.alloc['initWithTitle:message:delegate:cancelButtonTitle:otherButtonTitles:'](that.title, 'message!!!', nil, 'ok', nil).show();
});
});
```
## Requirements
* Xcode 9+
* iOS 10+
## Installation
FIXiT is available through [CocoaPods](https://cocoapods.org). To install
it, simply add the following line to your Podfile:
```ruby
pod 'FIXiT'
```
## Author
rickytan, ricky.tan.xin@gmail.com
## License
FIXIT is available under the MIT license. See the LICENSE file for more info.