web-to-app 配置模板將 WebViewConfig 通用配置存為命名快照并跨應(yīng)用一鍵套用在 web-to-appWebToApp中每個應(yīng)用都擁有一份獨(dú)立的通用配置WebViewConfig涵蓋瀏覽器行為、界面、網(wǎng)絡(luò)、隱私、工具欄等設(shè)置。當(dāng)你為一套瀏覽器環(huán)境反復(fù)調(diào)參后往往不希望為每個新應(yīng)用重新配置一遍——配置模板Config Templates功能正是為此設(shè)計把整套通用配置保存為命名快照之后任何應(yīng)用一鍵套用。讀完本文你將理解模板的快照邊界、UI 操作路徑、底層存儲實(shí)現(xiàn)ConfigTemplateStore.kt、Agent 工具接口以及測試對該機(jī)制的驗(yàn)證。模板是什么WebViewConfig 的完整快照模板是通用配置WebViewConfig的完整快照——即編輯通用配置編輯器里的全部設(shè)置JavaScript 開關(guān)、DOM Storage、緩存、User-Agent、桌面模式、縮放、刷新、全屏行為、下載、瀏覽器工具欄各按鈕、狀態(tài)欄樣式、長按菜單等。這一點(diǎn)可以從WebViewConfig的數(shù)據(jù)類定義得到印證它定義在 WebApp.kt 中是一個帶大量默認(rèn)值的data class字段從javaScriptEnabled、domStorageEnabled一直延伸到狀態(tài)欄、方向、注入腳本injectScripts等模板保存的就是這個對象的完整拷貝而非個別字段的差異。套用模板是整體替換而不是局部合并目標(biāo)應(yīng)用的WebViewConfig會被快照整體覆蓋結(jié)果與保存時完全一致不會出現(xiàn)新舊值混雜。Agent 工具的描述字符串中也明確寫了這一點(diǎn)Applying a template ... replacing its whole WebViewConfig with the template snapshot (a template is a full snapshot, never a partial merge). —— ConfigTemplateTools.kt邊界說明應(yīng)用類型相關(guān)設(shè)置入口文件、端口、依賴和 APK 導(dǎo)出設(shè)置不屬于模板。模板快照的載體是一個專門的輕量數(shù)據(jù)類data class ConfigTemplate( val name: String, val createdAt: Long, val webViewConfig: WebViewConfig )—— 定義于 ConfigTemplateStore.kt每條模板由名稱、創(chuàng)建時間戳和完整配置三部分組成。使用方法保存、套用與管理入口位于編輯通用配置編輯器頂欄的配置模板按鈕書庫圖標(biāo)Icons.Outlined.LibraryAddCheck。該按鈕的 Composable 實(shí)現(xiàn)是 ConfigTemplateMenuButton.kt它被掛載在通用配置編輯器的固定頂欄中而非滾動配置列表內(nèi)因?yàn)樗饔糜谡菖渲?。保存為模板點(diǎn)擊頂欄按鈕后下拉菜單第一項為保存為模板輸入模板名稱長度1–40 字符輸入框?qū)崟r顯示n/40計數(shù)超過 40 字符無法繼續(xù)輸入若名稱與已有模板重名忽略大小寫輸入框下方會顯示覆蓋提示保存即覆蓋舊快照保存成功后編輯器以 Snackbar 提示已保存。對應(yīng)源碼中保存對話框直接調(diào)用ConfigTemplateStore.save(context, trimmed, config)見 ConfigTemplateMenuButton.kt。套用模板兩種入口下拉菜單已保存的模板按名稱不區(qū)分大小寫排序直接列在菜單中點(diǎn)擊即把當(dāng)前應(yīng)用的通用配置整體替換為該快照并提示已套用 xxx管理對話框點(diǎn)擊卡片中的模板名同樣觸發(fā)套用。從源碼結(jié)構(gòu)看套用的 UI 實(shí)現(xiàn)是回調(diào)onApplyConfig(template.webViewConfig)ConfigTemplateMenuButton.kt將快照作為新配置裝載回編輯器改動與手動編輯一樣落在編輯器里確認(rèn)無誤后照常保存即可。管理模板下拉菜單底部的管理模板打開一個對話框以卡片列表展示所有模板名稱 x 天前式相對創(chuàng)建時間每張卡片提供點(diǎn)擊卡片套用該模板重命名彈出輸入框同樣受 40 字符上限約束若新名與另一個已存在模板重名忽略大小寫重命名會被拒絕并顯示錯誤提示刪除紅色刪除圖標(biāo)點(diǎn)擊即移除。存儲實(shí)現(xiàn)config_templates.json模板保存在本地app 存儲目錄context.filesDir中的config_templates.json應(yīng)用升級不會丟失。實(shí)現(xiàn)上有一個值得注意的設(shè)計決策——它刻意沒有做成 Room 實(shí)體而是 schema-free 的純 JSON 文件。源碼注釋解釋了原因隨著WebViewConfig持續(xù)演進(jìn)字段不斷增加用 Gson 直接序列化整個列表可以免去數(shù)據(jù)庫遷移成本見 ConfigTemplateStore.kt 的類注釋。關(guān)鍵行為均可在 ConfigTemplateStore.kt 中逐一對照行為規(guī)則名稱校驗(yàn)去除首尾空白后空名或超過MAX_NAME_LENGTH 40字符直接返回false拒絕同名覆蓋save按忽略大小寫匹配過濾后追加新快照即同名再次保存會覆蓋舊值查找/刪除/重命名全部按trim()ignoreCase匹配未命中時返回false而不拋異常重命名沖突新名若與其他模板重名忽略大小寫rename返回false列表排序按名稱小寫排序返回容錯降級文件不存在或 JSON 損壞時list通過runCatching { ... }.getOrDefault(emptyList())降級為空列表而不是崩潰寫入采用整文件覆蓋private fun write(context: Context, templates: ListConfigTemplate): Boolean runCatching { storeFile(context).writeText(Converters.gson.toJson(templates)) true }.getOrDefault(false)測試驗(yàn)證ConfigTemplateStoreTest單元測試 ConfigTemplateStoreTest.kt 基于 Robolectricsdk 33對上述每一條規(guī)則都有對應(yīng)斷言可作為行為契約參考保存后列出與讀取保存WebViewConfig(zoomEnabled false, toolbarShowConsole false)后get能按忽略大小寫的名稱如my setup匹配My Setup取回且兩個字段值與快照一致測試同名忽略大小寫覆蓋先存BasezoomEnabled true再存BASEzoomEnabled false列表只剩一條且值是新值測試非法名稱拒絕純空白名與 41 字符名均保存失敗測試刪除/重命名的忽略大小寫與未命中報告刪除不存在的模板返回false重命名到已存在名稱被拒絕測試損壞文件降級向config_templates.json寫入{not json后list返回空列表而非拋出異常測試。Agent 工具程序化管理模板應(yīng)用內(nèi) Agent 也可以管理模板四個內(nèi)置工具定義在 ConfigTemplateTools.kt 中由 ToolRegistryFactory.kt 注冊工具參數(shù)只讀行為ListConfigTemplates無是返回所有模板的名稱與創(chuàng)建時間yyyy-MM-dd HH:mm格式SaveConfigTemplatename1–40 字符、appId否以指定應(yīng)用的當(dāng)前WebViewConfig保存為命名快照同名忽略大小寫覆蓋ApplyConfigTemplatename、appId否用快照整體替換目標(biāo)應(yīng)用的WebViewConfigapp.copy(webViewConfig template.webViewConfig)后寫回數(shù)據(jù)庫DeleteConfigTemplatename否按名稱刪除模板不存在時報錯與 UI 入口不同Agent 工具以appId定位目標(biāo)應(yīng)用可先用ListApps/GetApp查詢且保存時直接讀取數(shù)據(jù)庫中該應(yīng)用的webViewConfig字段做快照。小結(jié)配置模板的機(jī)制可以歸納為三條快照語義模板 WebViewConfig完整拷貝套用即整體替換不合并、不含類型相關(guān)設(shè)置與 APK 導(dǎo)出設(shè)置輕量存儲單文件config_templates.jsonGson 序列化schema-free 設(shè)計讓W(xué)ebViewConfig新增字段時無需數(shù)據(jù)遷移損壞時降級為空列表雙入口一致編輯器頂欄 UIConfigTemplateMenuButton.kt與 Agent 工具ConfigTemplateTools.kt都收斂到同一份 ConfigTemplateStore 實(shí)現(xiàn)名稱規(guī)則1–40 字符、忽略大小寫、重名覆蓋在兩個入口保持一致并由單元測試完整約束。創(chuàng)作聲明：本文部分內(nèi)容由AI輔助生成（AIGC），僅供參考