SwiftUIX
SwiftUIX試圖彌補(bǔ)仍處于新生階段的SwiftUI框架的空白,提供了廣泛的組件卫键,擴(kuò)展和實(shí)用程序套件來(lái)補(bǔ)充標(biāo)準(zhǔn)庫(kù)荞彼。 迄今為止迁央,該項(xiàng)目是缺少的UIKit / AppKit功能的最完整的移植币励,力求使其以大多數(shù)類似于Apple的方式交付阳仔。
這個(gè)項(xiàng)目的目標(biāo)是補(bǔ)充SwiftUI標(biāo)準(zhǔn)庫(kù)攒霹,提供數(shù)百種擴(kuò)展和視圖怯疤,使開發(fā)人員可以輕松地通過(guò)SwiftUI的革命來(lái)構(gòu)建應(yīng)用程序。
提供了非常多的蘋果本應(yīng)提供但沒(méi)有提供的功能擴(kuò)展催束。項(xiàng)目的發(fā)起者非常年輕集峦,但mac的開發(fā)經(jīng)驗(yàn)十分豐富。到目前為止一直保持的較高的更新頻率和維護(hù)狀態(tài)。這個(gè)庫(kù)同時(shí)支持UIKit和Appkit塔淤,對(duì)于需要做蘋果生態(tài)全平臺(tái)的用戶十分友好摘昌。由于目前SwiftUI的List和LazyVStack的問(wèn)題還很多,他自己在開發(fā)中也深受其苦高蜂,前天在交流中聪黎,他已經(jīng)決定重做CocoaList功能,尤其提高對(duì)Fetchrequest的支持妨马。
對(duì)于進(jìn)行SwiftUI開發(fā)的朋友挺举,它是十分值得推薦的。
目前的問(wèn)題是文檔太少烘跺。不過(guò)對(duì)我來(lái)說(shuō)也未嘗不是一個(gè)好事湘纵。在研究它的用法過(guò)程中,給了我更多的機(jī)會(huì)閱讀并學(xué)習(xí)它的代碼滤淳,對(duì)SwiftUI梧喷,UIkit等有了更多的認(rèn)識(shí)和了解。
Charts
denielgindi對(duì)著名的安卓圖表庫(kù) MPAndroidChart的Swift移植脖咐。是目前不多的純Swift解決方案铺敌。它的優(yōu)勢(shì)也是同時(shí)支持UIKit和Appkit,同時(shí)提供了不錯(cuò)的Demo社區(qū)活躍度屁擅。
不過(guò)他的開發(fā)者好像不打算在3.x版本上在增加太多的功能偿凭,非常多目前急需并且已有解決方案的功能并沒(méi)有被當(dāng)前版本接受。所以整體的視覺(jué)呈現(xiàn)還是比較傳統(tǒng)的派歌。社區(qū)上對(duì)于功能的討論不少弯囊,但合并的極少,4.0的版本好像也已經(jīng)開發(fā)了不短的時(shí)間了胶果,不過(guò)進(jìn)度好像也不是特別理想匾嘱。
從效率上講,Charts應(yīng)該是非常合格的了早抠。
航歌 上面有非常詳細(xì)的中文使用教程霎烙,對(duì)我的學(xué)習(xí)幫助很大。
為了健康筆記開發(fā)的需要蕊连,我在當(dāng)前3.6的版本上合并了兩個(gè)社區(qū)上較為成熟的解決方案:
-
圓角Bar
dataSet.roundedCorners = [.topLeft,.topRight]
-
漸變色Bar
dataSet.drawBarGradientEnabled = true dataSet.colors = [UIColor(named: "barColor1")!, UIColor(named: "barColor1")!, UIColor(named: "barColor2")!] dataSet.gradientPositions = [0, 40, 100]
由于當(dāng)前的Charts本身并不支持對(duì)于圖表滾動(dòng)后停止事件的響應(yīng)悬垃,我自己為它增加了停止響應(yīng)。
//滾動(dòng)終止時(shí)調(diào)用
func chartScrollStop(_ chartView:ChartViewBase){
print("stopped")
}
修改后的代碼在此可以獲得咪奖。
Introspect
Introspect允許您獲取SwiftUI視圖的基礎(chǔ)UIKit或AppKit元素盗忱。
例如,使用Introspect羊赵,您可以訪問(wèn)UITableView來(lái)修改分隔符趟佃,或訪問(wèn)UINavigationController來(lái)自定義選項(xiàng)卡欄扇谣。
有一個(gè)非常推薦的利器。目前官方對(duì)于SwiftUI中的控件提供的可控選項(xiàng)很少闲昭,如果想做一些深度定制的話罐寨,通常就是自己寫代碼來(lái)重新包裝UIkit控件。不過(guò)introspect提供了一個(gè)非常巧妙的辦法通過(guò)簡(jiǎn)單的注入方式便可以對(duì)SwiftUI控件做更多的調(diào)整序矩。
比如:
只有當(dāng)內(nèi)容超出顯示范圍才進(jìn)行滾動(dòng)
ScrollView{
....
}
.introspectScrollView{ scrollView in
crollView.isScrollEnabled = scrollView.contentSize.height > scrollView.frame.height
}
顯示TextField的clear按鈕
TextField("note_noteName",text: $myState.noteName)
.introspectTextField{ text in
text.clearButtonMode = .whileEditing
}
對(duì)于新的控件它本身還沒(méi)提供具體支持的也可以方便的注入
修改SwiftUI2.0中新提供的TextEditor背景色
TextEditor(text: $text)
.introspect(selector: TargetViewSelector.sibling){ textView in
textView.backgroundColor = .clear
}
等等鸯绿。類似的用法在我整個(gè)的開發(fā)中的使用頻率是很高的。
SwiftDate
使用Swift編寫的時(shí)間日期處理庫(kù)簸淀。同時(shí)支持蘋果平臺(tái)以及Linux瓶蝴。
它提供了非常詳盡的文檔,航哥上也有非常好的中文教程租幕。
由于健康筆記需要對(duì)數(shù)據(jù)進(jìn)行不少處理舷手,尤其是需要將相同時(shí)間粒度的數(shù)據(jù)進(jìn)行合并比較。SwiftDate提供的Region方案提供了完美的解決途徑劲绪。
在SwiftDate中男窟,我多數(shù)使用它提供的DateInRegion來(lái)處理日期。通過(guò)
SwiftDate.defaultRegion = region
我?guī)缀鯚o(wú)需關(guān)心日期的本地化問(wèn)題贾富。而且它也提供了部分的日期時(shí)間的本地化顯示方案(但并不完美)歉眷。
一些使用舉例:
除非用戶在app中設(shè)定了特定的時(shí)區(qū),否則使用當(dāng)前設(shè)備的默認(rèn)設(shè)置:
if let data = UserDefaults.standard.data(forKey: "dateRegion"),
let region = try? JSONDecoder().decode(Region.self, from: data) {
SwiftDate.defaultRegion = region
}
else {
SwiftDate.defaultRegion = Region(calendar: Calendars.gregorian, zone: Zones.current, locale: Locales.current)
}
判斷某個(gè)日期和指定日期的天數(shù)差(本地時(shí)區(qū)):
let startDate = DateInRegion(datas.first!.viewModel.date1).dateTruncated(at: [.hour,.minute,.second])!
duration = date.difference(in: .day, from: startDate) ?? 0
如果你的程序需要對(duì)日期進(jìn)行頻繁的處理或者有較多的本地化需求時(shí)颤枪,SwiftDate是非常好的選擇汗捡!
SwiftUIOverlayContainer
SwiftUIOverlayContainer本身并不提供任何預(yù)置的視圖樣式,不過(guò)通過(guò)它畏纲,你有充分的自有度來(lái)實(shí)現(xiàn)自己需要的視圖效果凉唐。OverlayContainer的主要目的在于幫助你完成動(dòng)畫、交互霍骄、樣式定制等基礎(chǔ)工作,使開發(fā)者能夠?qū)r(shí)間和精力僅需投入在視圖本身的代碼上淡溯。
這是我自己寫的一個(gè)庫(kù)读整,這次通過(guò)它實(shí)現(xiàn)的屏幕側(cè)邊滑動(dòng)菜單。
本來(lái)它的用途主要不是做這個(gè)的咱娶,暫時(shí)使用它來(lái)完成側(cè)向滑動(dòng)菜單也是權(quán)宜之計(jì)米间,表現(xiàn)尚可。
ZIPFoundation
ZIP Foundation是一個(gè)用于創(chuàng)建膘侮,讀取和修改ZIP存檔文件的庫(kù)屈糊。
它是用Swift編寫的,基于Apple的libcompression來(lái)實(shí)現(xiàn)高性能和高能效琼了。
小巧逻锐、高效夫晌,使用便捷。健康筆記在數(shù)據(jù)導(dǎo)入導(dǎo)出時(shí)昧诱,使用它來(lái)完成zip文件的操作晓淀。
比如解壓備份數(shù)據(jù):
//打開沙盒讀取權(quán)限
_ = url.startAccessingSecurityScopedResource()
//解壓
do {
try FileManager.default.unzipItem(at: url, to: URL(fileURLWithPath: NSTemporaryDirectory()))
}
catch {
}
MarkdownView
基于WKwebView實(shí)現(xiàn)的Markdown文件Viewer。對(duì)md的解析是通過(guò)調(diào)用js庫(kù)來(lái)完成的盏档。
由于SwiftUI的Text文本排版能力幾乎為零凶掰,因此我選擇使用md格式來(lái)保存app所需的一些文字顯示,比如隱私政策等蜈亩。
MarkdownView的渲染效率一般懦窘,但我的顯示需求并不大,所以感覺(jué)不明顯稚配。但它的開發(fā)者對(duì)js文件進(jìn)行了加擾處理畅涂,所以如果你想對(duì)其中它所調(diào)用的例如mardown-it進(jìn)行更多配置的話,就幾乎不可能了药有。
另外毅戈,通過(guò)UIViewRepresentable對(duì)其進(jìn)行封裝,在SwiftUI下是無(wú)法正確獲取frame的尺寸的愤惰,從而無(wú)法正確顯示苇经。我對(duì)于UIkit所知甚少,只能做了最簡(jiǎn)單的修改宦言,勉強(qiáng)讓其可以在SwiftUI下完成所需要的功能扇单。
修改后的版本可在這里下載
另外,我在UIViewRepresentable包裝中增加了一些簡(jiǎn)單的修改奠旺,使其可以方便的將md中的圖片蜘澜,替換成Bundle中的本地圖片。
調(diào)用代碼 下載
ExcelExport
生成XSL文件的Swift代碼响疚。
這段代碼有一段時(shí)間了鄙信,不過(guò)去年又做了更新,不過(guò)我感覺(jué)更新后的版本還不如之前的忿晕。但它的新版本不支持Date的字段導(dǎo)出装诡,老版本導(dǎo)出的Date字段格式在Excel中也有問(wèn)題。我合并了兩個(gè)版本践盼,并且讓其在命名上對(duì)SwiftUI更加友好鸦采。
修改后的代碼 下載
必須對(duì)日期做如下處理,日期字段才能被Excel順利識(shí)別
let date = DateInRegion(memo.viewModel.date).toFormat("yyyy-MM-dd")
let time = DateInRegion(memo.viewModel.date).toFormat("HH:mm:ss.FFF")
let dateCell = ExcelCell(date + "T" + time,type: .dateTime)
上述的庫(kù)都被使用在 健康筆記2.0 中咕幻。如想查看更多的演示渔伯,可以移步