iOS14 widget 從0到1

iOS14 widget特點(diǎn)

  • iOS14 widget可在屏幕進(jìn)行任意擺放,可以堆疊節(jié)省空間孔轴,是手機(jī)主頁更加個(gè)性化

  • iOS14 widget自定義功能更加完善剃法,可集成siri的只能話推薦

  • 蘋果在開發(fā)上更加的建議去如何設(shè)計(jì)一個(gè)漂亮的小部件(Widget),如通過顏色路鹰,版式和圖像傳達(dá)您的品牌贷洲,舒適的信息密度等,詳情可查看蘋果開發(fā)文檔

  • 適應(yīng)不同的屏幕尺寸


  • iOS14 widget只能用swiftUI開發(fā)

創(chuàng)建一個(gè)iOS14 widget

1.新增一個(gè)target :File->New->Target添加Widget Extension Target 點(diǎn)擊Next晋柱。

2.輸入widget組件名优构,根據(jù)需要決定是否勾選Include Configuration Intent(是否支持用戶配置)


3.創(chuàng)建完成后就會(huì)看到默認(rèn)生成的文件與代碼


實(shí)現(xiàn)一個(gè)iOS14 widget

widget實(shí)現(xiàn)原理

開發(fā)者通過 SwiftUI 構(gòu)建 Views,定義Timelines為 Views 提供對應(yīng)時(shí)間所需的數(shù)據(jù)雁竞,當(dāng)數(shù)據(jù)變化時(shí)钦椭,通過reload更新數(shù)據(jù)。TimelineProvider提供一組TimelineEntry和ReloadPolicy碑诉,用來后續(xù)刷新頁面彪腔。

系統(tǒng)自帶方法介紹

入口

@main
struct UserWidget: Widget {
    private let kind: String = "UserWidget"

    public var body: some WidgetConfiguration {

    }
}
  • kind:字符串,唯一標(biāo)識(shí) Widget联贩。
  • WidgetConfiguration:有兩類配置漫仆,分別為
    • StaticConfiguration : 可以在不需要用戶任何輸入的情況下自行解析, 可以在 Widget 的 App 中獲取相關(guān)數(shù)據(jù)并發(fā)送給 Widget泪幌。
    • IntentConfiguration:依賴于 App 的 Siri Intent盲厌,會(huì)自動(dòng)接收這些 Intent 并用于更新 Widget,用于構(gòu)建動(dòng)態(tài) Widget祸泪。
  • supportedFamilies:支持不同尺寸吗浩,可以指定支持的尺寸

內(nèi)容

struct Model: TimelineEntry {
    let date: Date
    // 顯示的內(nèi)容Model
}

數(shù)據(jù)模型,需要遵守TimelineEntry協(xié)議

struct Provider: TimelineProvider {
    // 占位視圖没隘,是一個(gè)標(biāo)準(zhǔn)的 SwiftUI View懂扼,當(dāng)?shù)谝淮握故净蛘甙l(fā)生錯(cuò)誤時(shí)都會(huì)展示該 View。
    func placeholder(in context: Context) -> TimelineEntry {
    }

    // 編輯屏幕在左上角選擇添加Widget、第一次展示時(shí)會(huì)調(diào)用該方法
    func getSnapshot(in context: Context, completion: @escaping (TimelineEntry) -> Void) {
    }

    // 進(jìn)行數(shù)據(jù)的預(yù)處理阀湿,轉(zhuǎn)化成Entry
    // 最后一定要調(diào)用 completion赶熟,進(jìn)而刷新Widget
    func getTimeline(in context: Context, completion: @escaping (Timeline<TimelineEntry>) -> Void) {
    }
}

provider 遵守TimelineProvider協(xié)議,控制widget刷新陷嘴,需要實(shí)現(xiàn)三個(gè)方法如上面代碼所示

  • getTimeline 是最重要的方法映砖,需要再這個(gè)方法李實(shí)現(xiàn)數(shù)據(jù)的獲取和模型轉(zhuǎn)換
  • getTimeline 的方法里有一個(gè) policy 參數(shù),表示刷新的時(shí)機(jī)灾挨,可以選擇.never(不刷新)邑退,.atEnd(Entry 顯示完畢之后自動(dòng)刷新) 或 .after(date)(到達(dá)某個(gè)特定時(shí)間后自動(dòng)刷新)
  • Widget 刷新的時(shí)間由系統(tǒng)統(tǒng)一決定(有時(shí)候設(shè)置了也不會(huì)自己刷新),如果需要強(qiáng)制刷新 Widget劳澄,可以在 App 中使用 WidgetCenter 來重新加載所有時(shí)間線:WidgetCenter.shared.reloadAllTimelines()

布局

struct EntryView: View {

    var entry: Provider.Entry // 數(shù)據(jù)模型

    @Environment(\.widgetFamily) var family // 尺寸環(huán)境變量

    @ViewBuilder
    var body: some View {
     
    }
}

EntryView

屏幕上 Widget 顯示的內(nèi)容地技,可以針對不同尺寸的 Widget 設(shè)置不同的 View。只能用swiftUI構(gòu)建

交互
widget只支持點(diǎn)擊交互秒拔,通過鏈接跳轉(zhuǎn)莫矗。
有兩種鏈接方式

  • widgetURL 點(diǎn)擊widget后打開app,small類型只下次widgetURL跳轉(zhuǎn)
  • Link 可以給單個(gè)控件設(shè)計(jì)跳轉(zhuǎn)鏈接砂缩,在app內(nèi)接受處理(appdelegate中的openurl 或者SceneDelegate中的openurl)
Link(destination: URL(string: "xxx")!) {
        VStack {
           
        }
    }

運(yùn)行

先運(yùn)行app的target趣苏,再運(yùn)行widget的target

?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請聯(lián)系作者
  • 序言:七十年代末,一起剝皮案震驚了整個(gè)濱河市梯轻,隨后出現(xiàn)的幾起案子食磕,更是在濱河造成了極大的恐慌,老刑警劉巖喳挑,帶你破解...
    沈念sama閱讀 221,820評論 6 515
  • 序言:濱河連續(xù)發(fā)生了三起死亡事件彬伦,死亡現(xiàn)場離奇詭異,居然都是意外死亡伊诵,警方通過查閱死者的電腦和手機(jī)单绑,發(fā)現(xiàn)死者居然都...
    沈念sama閱讀 94,648評論 3 399
  • 文/潘曉璐 我一進(jìn)店門,熙熙樓的掌柜王于貴愁眉苦臉地迎上來曹宴,“玉大人搂橙,你說我怎么就攤上這事〉烟梗” “怎么了区转?”我有些...
    開封第一講書人閱讀 168,324評論 0 360
  • 文/不壞的土叔 我叫張陵,是天一觀的道長版扩。 經(jīng)常有香客問我废离,道長,這世上最難降的妖魔是什么礁芦? 我笑而不...
    開封第一講書人閱讀 59,714評論 1 297
  • 正文 為了忘掉前任蜻韭,我火速辦了婚禮悼尾,結(jié)果婚禮上,老公的妹妹穿的比我還像新娘肖方。我一直安慰自己闺魏,他們只是感情好,可當(dāng)我...
    茶點(diǎn)故事閱讀 68,724評論 6 397
  • 文/花漫 我一把揭開白布俯画。 她就那樣靜靜地躺著舷胜,像睡著了一般。 火紅的嫁衣襯著肌膚如雪活翩。 梳的紋絲不亂的頭發(fā)上,一...
    開封第一講書人閱讀 52,328評論 1 310
  • 那天翻伺,我揣著相機(jī)與錄音材泄,去河邊找鬼。 笑死吨岭,一個(gè)胖子當(dāng)著我的面吹牛拉宗,可吹牛的內(nèi)容都是我干的。 我是一名探鬼主播辣辫,決...
    沈念sama閱讀 40,897評論 3 421
  • 文/蒼蘭香墨 我猛地睜開眼韧涨,長吁一口氣:“原來是場噩夢啊……” “哼挡闰!你這毒婦竟也來了?” 一聲冷哼從身側(cè)響起,我...
    開封第一講書人閱讀 39,804評論 0 276
  • 序言:老撾萬榮一對情侶失蹤茁瘦,失蹤者是張志新(化名)和其女友劉穎,沒想到半個(gè)月后补胚,有當(dāng)?shù)厝嗽跇淞掷锇l(fā)現(xiàn)了一具尸體蒂教,經(jīng)...
    沈念sama閱讀 46,345評論 1 318
  • 正文 獨(dú)居荒郊野嶺守林人離奇死亡,尸身上長有42處帶血的膿包…… 初始之章·張勛 以下內(nèi)容為張勛視角 年9月15日...
    茶點(diǎn)故事閱讀 38,431評論 3 340
  • 正文 我和宋清朗相戀三年畴嘶,在試婚紗的時(shí)候發(fā)現(xiàn)自己被綠了蛋逾。 大學(xué)時(shí)的朋友給我發(fā)了我未婚夫和他白月光在一起吃飯的照片。...
    茶點(diǎn)故事閱讀 40,561評論 1 352
  • 序言:一個(gè)原本活蹦亂跳的男人離奇死亡窗悯,死狀恐怖区匣,靈堂內(nèi)的尸體忽然破棺而出,到底是詐尸還是另有隱情蒋院,我是刑警寧澤亏钩,帶...
    沈念sama閱讀 36,238評論 5 350
  • 正文 年R本政府宣布,位于F島的核電站欺旧,受9級(jí)特大地震影響铸屉,放射性物質(zhì)發(fā)生泄漏。R本人自食惡果不足惜切端,卻給世界環(huán)境...
    茶點(diǎn)故事閱讀 41,928評論 3 334
  • 文/蒙蒙 一彻坛、第九天 我趴在偏房一處隱蔽的房頂上張望。 院中可真熱鬧,春花似錦昌屉、人聲如沸钙蒙。這莊子的主人今日做“春日...
    開封第一講書人閱讀 32,417評論 0 24
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽躬厌。三九已至,卻和暖如春竞帽,著一層夾襖步出監(jiān)牢的瞬間扛施,已是汗流浹背。 一陣腳步聲響...
    開封第一講書人閱讀 33,528評論 1 272
  • 我被黑心中介騙來泰國打工屹篓, 沒想到剛下飛機(jī)就差點(diǎn)兒被人妖公主榨干…… 1. 我叫王不留疙渣,地道東北人。 一個(gè)月前我還...
    沈念sama閱讀 48,983評論 3 376
  • 正文 我出身青樓堆巧,卻偏偏與公主長得像妄荔,于是被迫代替她去往敵國和親。 傳聞我的和親對象是個(gè)殘疾皇子谍肤,可洞房花燭夜當(dāng)晚...
    茶點(diǎn)故事閱讀 45,573評論 2 359

推薦閱讀更多精彩內(nèi)容