TweaKit
,也称 "Tweak It",是一个用于调整参数和功能标志的纯 Swift 库。
功能
- 使用属性包装和结果构建器声明调整。
- 实时调整常用类型。
- 精心设计的 UI/UX。
- 模糊搜索调整。
- 使用 json 导入和导出调整。
要求
- iOS 13 以及更高版本
- Swift 5.4 以及更高版本
安装
CocoaPods
pod 'TweaKit', '~> 1.0'
Carthage
github "Alpensegler/TweaKit" ~> 1.0
Swift Package Manager
.package(url: "https://github.com/Alpensegler/TweaKit.git", .upToNextMajor(from: "1.0.0"))
开始使用
声明调整
import TweaKit
enum Tweaks {
@Tweak<CGFloat>(name: "Line Width", defaultValue: 1, from: 0.5, to: 2, stride: 0.05)
static var sketchLineWidth
@Tweak(name: "Line Color", defaultValue: UIColor(red: 0.227, green: 0.529, blue: 0.992, alpha: 1))
static var sketchLineColor
@Tweak(name: "Order", defaultValue: SketchAction.allCases)
static var sketchActionsOrder
@Tweak(name: "Name", defaultValue: "My Sketch")
static var sketchName
@Tweak(name: "Navigation Title", defaultValue: "Demo", options: ["Demo", "Example", "Guide"])
static var rootViewNavigationTitle
@Tweak(name: "Shake To Show Tweaks", defaultValue: true)
static var rootViewEnableShake
static let context = TweakContext {
TweakList("Sketch") {
TweakSection("Line") {
$sketchLineWidth
$sketchLineColor
}
TweakSection("Info") {
$sketchName
}
TweakSection("Actions") {
$sketchActionsOrder
}
}
TweakList("Root View") {
TweakSection("UI") {
$rootViewNavigationTitle
}
TweakSection("Interaction") {
$rootViewEnableShake
}
}
}
}
您可以调整以下类型
布尔值(Bool)
- 数字类型:
Int[8|16|32|64]
、UInt[8|16|32|64]
、Float
、Double
和CGFloat
字符串(String)
Array
满足某些协议的Element
UIColor
除了更改现有值,您还可以从给定选项中选择值。
初始化定制上下文
func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
_ = Tweaks.context
return true
}
您可以在任何时候初始化定制上下文,但您应该在使用它之前确保上下文已初始化。
使用微调
myViewController.title = Tweaks.rootViewNavigationTitle
mySketchView.lineWidth = Tweaks.sketchLineWidth
显示定制UI
Tweaks.context.show()
到此为止。现在您已经了解了足够多的关于 TweaKit
的知识。
您可以随意尝试演示应用程序,或查看 wiki 和 文档 以获取更多信息。
感谢
- UI/UX 由 @gggeeeeggge 负责。
- TweaKit 思想深受 SwiftTweaks 启发。
关于徽标
TweaKit
的徽标是一只可爱的小松鼠,一种会在夏季和冬季变换毛色的鼬科动物。