设置中心-Cordovaopenharmony统一配置入口

一、功能概述

应用的各种配置项（如单位选择、提醒时间、数据保留期限等）需要一个统一的管理入口。"设置中心"模块提供了一个集中的配置界面，让用户可以方便地调整应用行为。本篇文章围绕"设置中心"展开，介绍如何在Cordova Web 层实现配置存储和读取，并通过OpenHarmony ArkTS 插件提供原生设置界面。

我们继续采用"一段代码一段说明"的写作方式，并包含 ArkTS 示例代码。

二、Web 端设置中心界面

<divid="settings-page"class="page page-settings"><h1>设置中心</h1><divclass="settings-group"><h3>基本设置</h3><label><span>单位</span><selectid="unit-select"><optionvalue="ml">毫升 (ml)</option><optionvalue="l">升 (L)</option></select></label><label><span>每日目标</span><inputtype="number"id="daily-goal"min="500"max="5000"step="100"/></label></div><divclass="settings-group"><h3>提醒设置</h3><label><span>启用提醒</span><inputtype="checkbox"id="enable-reminder"/></label><label><span>提醒间隔 (分钟)</span><inputtype="number"id="reminder-interval"min="15"max="240"step="15"/></label></div><buttonid="btn-save-settings"class="btn-primary">保存设置</button></div>

这段 HTML 定义了设置中心页面的结构。分为多个设置组，每个组包含相关的配置项。

.page-settings{padding:16px 24px;}.settings-group{background:#374151;padding:12px;border-radius:4px;margin-bottom:16px;}.settings-group h3{margin-top:0;margin-bottom:12px;font-size:14px;}.settings-group label{display:flex;justify-content:space-between;align-items:center;padding:8px 0;border-bottom:1px solid #555;}.settings-group label:last-child{border-bottom:none;}.settings-group input, .settings-group select{padding:6px 8px;background:#1f2937;border:1px solid #555;color:#ccc;border-radius:4px;}

CSS 为设置项添加布局和样式。

三、加载和保存设置

asyncfunctionloadSettings(){constsettings=awaitdb.getSettings();document.getElementById('unit-select').value=settings.unit||'ml';document.getElementById('daily-goal').value=settings.dailyGoal||2000;document.getElementById('enable-reminder').checked=settings.enableReminder!==false;document.getElementById('reminder-interval').value=settings.reminderInterval||60;}asyncfunctionsaveSettings(){constsettings={unit:document.getElementById('unit-select').value,dailyGoal:parseInt(document.getElementById('daily-goal').value),enableReminder:document.getElementById('enable-reminder').checked,reminderInterval:parseInt(document.getElementById('reminder-interval').value),savedAt:newDate().toISOString(),};awaitdb.saveSettings(settings);syncSettingsToNative(settings);alert('设置已保存');}

loadSettings从数据库中读取已保存的设置，并填充到表单中。saveSettings收集表单数据，保存到数据库，并同步到原生侧。

document.addEventListener('DOMContentLoaded',()=>{loadSettings();document.getElementById('btn-save-settings')?.addEventListener('click',saveSettings);});

在DOMContentLoaded时加载设置，并绑定保存按钮事件。

四、通过 Cordova 同步设置到原生层

functionsyncSettingsToNative(settings){if(!window.cordova){console.warn('[Settings] cordova not ready, skip native sync');return;}cordova.exec(()=>{console.info('[Settings] sync success');},(err)=>{console.error('[Settings] sync failed',err);},'WaterTrackerSettings','updateSettings',[settings]);}

syncSettingsToNative将设置同步给 ArkTS 插件。

五、OpenHarmony ArkTS 插件与设置管理

// entry/src/main/ets/plugins/WaterTrackerSettingsPlugin.etsimportcommonfrom'@ohos.app.ability.common';exportinterfaceAppSettings{unit:string;dailyGoal:number;enableReminder:boolean;reminderInterval:number;}exportclassSettingsStore{privatestatic_settings:AppSettings|null=null;staticsetSettings(settings:AppSettings){this._settings=settings;}staticgetsettings(){returnthis._settings;}}exportdefaultclassWaterTrackerSettingsPlugin{context:common.UIAbilityContext;constructor(ctx:common.UIAbilityContext){this.context=ctx;}updateSettings(args:Array<Object>,callbackId:number){constsettings=args[0]asAppSettings;SettingsStore.setSettings(settings);console.info('[SettingsPlugin] settings updated');}}

ArkTS 侧的WaterTrackerSettingsPlugin插件接收设置数据，并通过SettingsStore缓存。

六、ArkUI 中应用设置

// entry/src/main/ets/pages/SettingsPage.etsimport{SettingsStore}from'../plugins/WaterTrackerSettingsPlugin';@Component struct SettingsView{build(){constsettings=SettingsStore.settings;Column(){Text('应用设置').fontSize(18).margin({bottom:8});if(settings){Text(`单位:${settings.unit}`).fontSize(14).margin({bottom:4});Text(`每日目标:${settings.dailyGoal}${settings.unit}`).fontSize(14);}else{Text('加载中...').fontSize(14);}}.padding(16)}}

SettingsView组件在原生界面中展示当前设置。

七、小结

本篇文章从设置加载、设置保存、Cordova 桥接到 ArkTS 插件，完整演示了"设置中心"在 Cordova&openharmony 混合应用中的实现路径。Web 层通过loadSettings加载设置，通过saveSettings保存设置；syncSettingsToNative将设置推送给原生侧，ArkTS 侧通过SettingsStore和WaterTrackerSettingsPlugin缓存数据，ArkUI 组件SettingsView则提供原生展示入口。

通过"一段代码一段说明"的方式，我们把整个设置管理流程拆解得足够细致。你可以在此基础上进一步扩展，例如添加更多配置项、设置导入导出、设置预设等功能，让"设置中心"真正成为用户个性化应用的枢纽.