介紹幾個(gè)我在開發(fā)健康筆記2用到的Swift或SwiftUI第三方庫(kù)

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 中咕幻。如想查看更多的演示渔伯,可以移步

健康筆記2.0 使用SwiftUI2.0開發(fā)的iOS app

?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請(qǐng)聯(lián)系作者
  • 序言:七十年代末,一起剝皮案震驚了整個(gè)濱河市肄程,隨后出現(xiàn)的幾起案子锣吼,更是在濱河造成了極大的恐慌选浑,老刑警劉巖,帶你破解...
    沈念sama閱讀 206,126評(píng)論 6 481
  • 序言:濱河連續(xù)發(fā)生了三起死亡事件吐限,死亡現(xiàn)場(chǎng)離奇詭異鲜侥,居然都是意外死亡,警方通過(guò)查閱死者的電腦和手機(jī)诸典,發(fā)現(xiàn)死者居然都...
    沈念sama閱讀 88,254評(píng)論 2 382
  • 文/潘曉璐 我一進(jìn)店門描函,熙熙樓的掌柜王于貴愁眉苦臉地迎上來(lái),“玉大人狐粱,你說(shuō)我怎么就攤上這事舀寓。” “怎么了肌蜻?”我有些...
    開封第一講書人閱讀 152,445評(píng)論 0 341
  • 文/不壞的土叔 我叫張陵互墓,是天一觀的道長(zhǎng)。 經(jīng)常有香客問(wèn)我蒋搜,道長(zhǎng)篡撵,這世上最難降的妖魔是什么? 我笑而不...
    開封第一講書人閱讀 55,185評(píng)論 1 278
  • 正文 為了忘掉前任豆挽,我火速辦了婚禮育谬,結(jié)果婚禮上,老公的妹妹穿的比我還像新娘帮哈。我一直安慰自己舟肉,他們只是感情好嗅绰,可當(dāng)我...
    茶點(diǎn)故事閱讀 64,178評(píng)論 5 371
  • 文/花漫 我一把揭開白布废菱。 她就那樣靜靜地躺著差油,像睡著了一般。 火紅的嫁衣襯著肌膚如雪憾筏。 梳的紋絲不亂的頭發(fā)上嚎杨,一...
    開封第一講書人閱讀 48,970評(píng)論 1 284
  • 那天,我揣著相機(jī)與錄音氧腰,去河邊找鬼磕潮。 笑死,一個(gè)胖子當(dāng)著我的面吹牛容贝,可吹牛的內(nèi)容都是我干的。 我是一名探鬼主播之景,決...
    沈念sama閱讀 38,276評(píng)論 3 399
  • 文/蒼蘭香墨 我猛地睜開眼斤富,長(zhǎng)吁一口氣:“原來(lái)是場(chǎng)噩夢(mèng)啊……” “哼!你這毒婦竟也來(lái)了锻狗?” 一聲冷哼從身側(cè)響起满力,我...
    開封第一講書人閱讀 36,927評(píng)論 0 259
  • 序言:老撾萬(wàn)榮一對(duì)情侶失蹤焕参,失蹤者是張志新(化名)和其女友劉穎,沒(méi)想到半個(gè)月后油额,有當(dāng)?shù)厝嗽跇淞掷锇l(fā)現(xiàn)了一具尸體叠纷,經(jīng)...
    沈念sama閱讀 43,400評(píng)論 1 300
  • 正文 獨(dú)居荒郊野嶺守林人離奇死亡,尸身上長(zhǎng)有42處帶血的膿包…… 初始之章·張勛 以下內(nèi)容為張勛視角 年9月15日...
    茶點(diǎn)故事閱讀 35,883評(píng)論 2 323
  • 正文 我和宋清朗相戀三年潦嘶,在試婚紗的時(shí)候發(fā)現(xiàn)自己被綠了涩嚣。 大學(xué)時(shí)的朋友給我發(fā)了我未婚夫和他白月光在一起吃飯的照片。...
    茶點(diǎn)故事閱讀 37,997評(píng)論 1 333
  • 序言:一個(gè)原本活蹦亂跳的男人離奇死亡掂僵,死狀恐怖航厚,靈堂內(nèi)的尸體忽然破棺而出,到底是詐尸還是另有隱情锰蓬,我是刑警寧澤幔睬,帶...
    沈念sama閱讀 33,646評(píng)論 4 322
  • 正文 年R本政府宣布,位于F島的核電站芹扭,受9級(jí)特大地震影響麻顶,放射性物質(zhì)發(fā)生泄漏。R本人自食惡果不足惜舱卡,卻給世界環(huán)境...
    茶點(diǎn)故事閱讀 39,213評(píng)論 3 307
  • 文/蒙蒙 一辅肾、第九天 我趴在偏房一處隱蔽的房頂上張望。 院中可真熱鬧灼狰,春花似錦宛瞄、人聲如沸。這莊子的主人今日做“春日...
    開封第一講書人閱讀 30,204評(píng)論 0 19
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽(yáng)。三九已至蝴簇,卻和暖如春杯活,著一層夾襖步出監(jiān)牢的瞬間,已是汗流浹背熬词。 一陣腳步聲響...
    開封第一講書人閱讀 31,423評(píng)論 1 260
  • 我被黑心中介騙來(lái)泰國(guó)打工旁钧, 沒(méi)想到剛下飛機(jī)就差點(diǎn)兒被人妖公主榨干…… 1. 我叫王不留,地道東北人互拾。 一個(gè)月前我還...
    沈念sama閱讀 45,423評(píng)論 2 352
  • 正文 我出身青樓歪今,卻偏偏與公主長(zhǎng)得像,于是被迫代替她去往敵國(guó)和親颜矿。 傳聞我的和親對(duì)象是個(gè)殘疾皇子寄猩,可洞房花燭夜當(dāng)晚...
    茶點(diǎn)故事閱讀 42,722評(píng)論 2 345