百度APP iOS暗黑模式適配的完美解決方案

本文做者：yanxin1563

原創： liushaohua

一 背景

在2019WWDC的開場演講中，蘋果公佈了即將推出的iOS13 DarkMode的新特性。此新特性不只能夠在夜晚保護視力，並且對於使用OLED的最新一代設備而言，也能夠幫助用戶節省電量消耗。不過此特性只支持iOS13以上的系統,爲了給全系統全部用戶最好的體驗,研發出了一套皮膚主題框架,不只能夠全系統支持DarkMode，還能夠擴展多套皮膚主題;

二 皮膚主題框架的誕生 BDPAppearance

 

2.1 業務方使用方式

• 目前系統全部控件及其Color屬性和Image屬性均已支持, 此處只列舉兩個例子:

// UIColor
view.backgroundColor = BDPAppearanceColor(@"C1");

// UIImage
imageV.image = BDPAppearanceImage(@"icon");

業務方只需如上使用簡單的API設置Color和Image，便可實現主題換膚；

 

2.2 實現原理

先來看一下BDPAppearance設計方案的架構圖

在項目初始化時，會先加載當前主題所使用的色值資源到內存中，相關控件經過 BDPAppearanceColor 用色名去找出對應主題下的色值，實例化出UIColor對象，並賦值給這些相關控件;

而內置的UIImage圖片是存放在Assets中的，經過BDPAppearanceImage用圖片名去加載當前主題下的UIImage對象便可；

• UIColor分類和UIImage分類

能夠看到圖中，給UIColor分類添加了ColorName屬性: 經過BDPAppearanceColor方式獲取UIColor實例對象時，經過分類會記錄當前Color對象所使用的色號名;

同理，經過BDPAppearanceImage獲取UIImage時，經過分類會記錄當前Image對象所使用的圖片名;

• changeTheme刷新主題

每個控件初始化添加到父視圖的時候，在- (void)didMoveToSuperview的時機將其添加到NSHashTable中， 點擊切換主題時，經過NSHashTable拿到當前視圖樹上全部的視圖控件，取出控件屬性中的UIColor和UIImage， 判斷其colorName和imageName是否有值，有值即表明當前控件須要適配主題，則用此colorName或者imageName去加載當前主題的新色值和新圖片，從新賦值給當前控件即完成了主題切換。

三 設計思路

設計此皮膚主題框架的原則：

業務方在現有業務的基礎上以最低成本的方式進行適配:即只需更換獲取顏色和圖片的方式

 

那麼在基於上述原則的前提下，咱們應該如何在切換主題時，讓全部的控件從新刷新主題呢？

在項目初期時，採用通知的方案：在didMoveToSuperview方法中給當前控件添加一個通知，當收到切換主題的通知時,則刷新當前控件的相關色值及圖片；

 

可是在作性能測試時，發現採用通知方式初始化，不只會有必定CPU消耗，同時也會增長初始化的耗時，視圖層級越多，性能損耗越明顯，因此放棄了此方案; 咱們的目的其實就是可讓當前全部的視圖能夠觸發刷新邏輯，最終採用了NSHashTable弱持有控件的方案;

兩種方式性能測試數據:

如下數據均是測試20次以上取的平均值;

壓力測試環境：視圖層級1w個View:

由以上測試數據得出: 在上萬個視圖量級下， HashTable 性能是遠遠優於通知的方式

四 業界開源框架對比

如下是目前業界GitHub排名靠前的開源庫對比:

同時對比iOS13系統API適配的方式:

UIColor *dynamicColor = [UIColor colorWithDynamicProvider:^UIColor * _Nonnull(UITraitCollection * _Nonnull traitCollection) {
        if (traitCollection.userInterfaceStyle == UIUserInterfaceStyleDark) {
            return [UIColor blackColor];
        } else {
            return [UIColor whiteColor];
        }
    }];

view.backgroundColor = dynamicColor;

對比能夠看出：BDPAppearance使用方式是在保留RD開發習慣上的基礎上最接近系統方式的，改動代碼量是最小的;

五 客戶端總體主題通訊設計

百度App涉及到主題相關模塊技術形態有：NA、H五、RN、HN等，而在多種技術形態下主題模式又是如何通訊呢？能夠參考下邊這張圖:

如圖所示：

• 初始化WKWebView時採用的方案：在UserAgent中拼接Key-Value的方式初始化WebView,達到在渲染時，最先時機拿到主題模式;

• 主題變化通訊採用的方案：數據通道和端能力，其本質是JS交互；

六 項目工程色值配置

• 6.1 端內色值表的管理

整個百度App涉及近百個業務,組件近三百個,色號表的管理也顯得尤其重要;

每一個組件內部所使用到的色號僅僅是有限個, 若是全部組件用到的色值都統一放入一個色值表中管理,顯然是不合理的,不利於解耦也更不利於組件化輸出;那麼最優的色值管理方式是什麼呢？

如上圖所示，組件各自管理本身所需的色值表,在項目編譯時,會經過腳本將全部組件的色值表進行色值去重後,合併成一個總的色值表存儲在Themes倉庫下,而後初始化主題資源時讀取Themes裏邊總的色值表便可; 此種處理方式則達到了組件間解耦的目的;

 

• 6.2 Sketch插件:ThemeMeasure

早期的開發中，UE出圖都是用的Sketch導出HTML格式標註圖,而根據百度App iOS相關 CRD、FE 對實現技術的選型及配合要求，UE 須要提供並維護一套 NA+H5 色表，標註界面時標顏色的編號而非色值。爲了達到此種效果，咱們同期研發出了Sketch插件，能夠在標註界面直接顯示出色號，解決了UE標註色號的痛點，大大提升了效率; 以下圖:

此插件共包含三種能力:

1.多種便捷方式助力色號標註

• Theme Measure 可讓設計師根據系統的推薦選擇色號進行標註，還有貼心的批量標註嚮導，改變了過去設計師手動寫色號進行標註的方式

2.一鍵轉換深色、夜間等主題

• Theme Measure 可以讓設計師一鍵將默認主題轉換爲深色、夜間或者其餘主題（須要有相應的色值數據，正確的色號標註），改變了過去設計師須要手動逐一調整產出深色、夜間設計稿的方式，大幅提高設計師對多主題適配的工做效率及體驗

3.熟悉的標註導出方式，全部標註均在一處

• 仍是使用熟悉的工具導出標註，色號、佈局、字號等標註均在同一個 HTML 文檔內，改變了過去須要額外提供一份色號標註的方式，提高設計與研發的協同效率與體驗

在整套皮膚主題機制下業務方僅僅花了不到兩週的時間即完成了整個手百的主題適配，也從側面證明此框架的優勢：輕量級，使用成本低;

資源配置同時也支持雲端下發，可動態新增多種主題;

七 總結

本文主要從皮膚主題框架實現、色值表的管理以及配套工具鏈等方面詳細的介紹了百度App iOS暗黑模式的適配,歡迎業內的朋友一塊兒交流學習;

原文連接地址：https://developer.baidu.com/topic/show/290490