FunnyButton
Example
在平时开发，运行期间有时候想中途看一下某个视图或变量的信息，虽说打断点是可以查看，但有时候断点调试有时候会卡住好一会才能看到（尤其是大项目经常卡很久），极度影响效率。
基于这种情况，FunnyButton就是为了能够便捷调试的全局按钮，添加好点击事件，就能随时点击查看某个视图或变量的信息，又可以直接调试某些函数。
Feature：
✅ 位于Window层级，不会被app内的界面覆盖；
✅ 自适应安全区域，自动靠边，适配横竖屏；
✅ 可执行单个/多个点击事件；
✅ 兼容Objective-C环境调试；
✅ 仅限DEBUG环境；
✅ API简单易用。
Basic use
为了兼容OC，基于NSObject的扩展提供给所有基类设置点击事件的接口，以UIViewController为例：
- Swift
// 建议初始化好页面时设置
override func viewDidAppear(_ animated: Bool) {
super.viewDidAppear(animated)
// 设置点击事件
replaceFunnyAction {
// 注意内存泄漏：闭包内部用到`self`记得使用`[weak self]`
print("点我干森莫")
}
}
// 建议页面即将消失时移除这些事件
override func viewWillDisappear(_ animated: Bool) {
super.viewWillDisappear(animated)
// 移除点击事件
removeFunnyActions()
}
- Objective-C
// 建议初始化好页面时设置
- (void)viewDidAppear:(BOOL)animated {
[super viewDidAppear:animated];
// 设置点击事件
[self replaceFunnyActionWithWork:^{
// 注意内存泄漏：闭包内部用到`self`记得使用`__weak`
NSLog(@"点我干森莫");
}];
}
// 建议页面即将消失时移除这些事件
- (void)viewWillDisappear:(BOOL)animated {
[super viewWillDisappear:animated];
// 移除点击事件
[self removeFunnyActions];
}
API
FunnyButton.API.swift - 公开可使用接口。
- replace action - 替换、覆盖全部事件
/// 替换单个`Action`
@objc func replaceFunnyAction(work: @escaping () -> ()) { ... }
/// 替换多个`Action`
@objc func replaceFunnyActions(_ actions: [FunnyAction]) { ... }
- add action - 在已有的事件上添加新的事件
/// 添加单个`Action`
@objc func addFunnyAction(name: String? = nil, work: @escaping () -> ()) { ... }
/// 添加多个`Action`
@objc func addFunnyActions(_ actions: [FunnyAction]) { ... }
- remove action - 删除目标/全部事件
/// 带条件移除目标`Action`（`decide`返回`true`则删除）
@objc func removeFunnyActions(where decide: (FunnyAction) -> Bool) { ... }
/// 移除所有`Action`
@objc func removeFunnyActions() { ... }
- update layout - 刷新布局
/// 刷新`FunnyButton`布局
@objc func updateFunnyLayout() { ... }
Custom button UI
FunnyButton.swift - 可改动的UI属性均为静态属性，且有默认实现，如需改动建议启动App时配置。
public class FunnyButton: UIButton {
......
/// 普通状态
static var normalEmoji = "😛"
/// 点击状态
static var touchingEmoji = "😝"
/// 毛玻璃样式（nil为无毛玻璃）
static var effect: UIVisualEffect? = {
if #available(iOS 13, *) {
return UIBlurEffect(style: .systemThinMaterial)
}
return UIBlurEffect(style: .prominent)
}()
/// 背景色
static var bgColor: UIColor? = UIColor(red: 200.0 / 255.0, green: 100.0 / 255.0, blue: 100.0 / 255.0, alpha: 0.2)
/// 初始点（想`靠右/靠下`的话，`x/y`的值就设置大一点，最后会靠在安全区域的边上）
static var startPoint: CGPoint = CGPoint(x: 600, y: 100)
/// 安全区域的边距
static var safeMargin: CGFloat = 12
......
}
// Initialization Example:
func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
......
FunnyButton.normalEmoji = "🦖"
FunnyButton.touchingEmoji = "🐲"
return true
}
Installation
FunnyButton is available through CocoaPods. To install it, simply add the following line to your Podfile:
pod 'FunnyButton'
Author
Rogue24, [email protected]
License
FunnyButton is available under the MIT license. See the LICENSE file for more info.
1.4k Dec 29, 2022
575 Dec 28, 2022
21 Dec 14, 2022
465 Dec 24, 2022
433 Nov 15, 2022
608 Dec 30, 2022
3 Aug 4, 2022
2 Feb 20, 2022
114 Jun 12, 2022
153 Sep 15, 2022
3.4k Dec 28, 2022
2.1k Jan 8, 2023
1.8k Dec 29, 2022
631 Jan 3, 2023
5.9k Dec 24, 2022
1.2k Dec 30, 2022
13.3k Dec 31, 2022
8.9k Jan 6, 2023
631 Jan 3, 2023
3.4k Dec 28, 2022
5.9k Dec 24, 2022
1.2k Dec 30, 2022
13.3k Dec 31, 2022
8.9k Jan 6, 2023
733 Oct 29, 2022
1.8k Jan 3, 2023
55 Sep 24, 2022
2.1k Jan 8, 2023