1、航 海 桌 面 主 题介 绍航海桌面主题是一套灵活可自定义程度很高的系统。用户可以通过主题配置文件修改桌面内容，布局和插入动画，互动内容，制作个性化的桌面。主 题 配 置 文 件 构 成主题配置文件是一个 zip 文件包，可以通过任何 zip 文件生成工具打包制作。然后修改扩展名为.v。将配置文件上传到手机以下任一位置就可以被桌面设置程序里的主题设置识别出来。c:SystemAppsHDesktop_02001E8B2theme_pkg, c:Hanghai, e:Hanghai, c:vApps, e:vApps一个主题配置文件必须含有以下文件 meta.xml theme.xml prev
2、.jpgmeta.xml 是描述主题信息，里面包含版号和主题名称。0.0.7经典风格theme.xml 是主题定义，具体内容后面介绍prev.jpg 是主题预览图，在设置的时候显示。预览图可以适配不同分辨率。比如命名成prev_320_240.jpg，就是在 320240 分辨率下使用。可以有多个预览图存在。定 义 主 题基 本 内 容在 theme.xml 里可以定义主题。根节点称为 theme_pack，含有多个 theme 标签。桌面运行的时候会根据 theme 里的res 属性选择适合当前屏幕大小的主题。下面是同时定义了 240320 屏幕和其横屏情况下 320240 的主题。 the
3、me 里有 skin，wallpaper ，color ，flag，statuspane 属性。 skin 属性指定了当前皮肤图片。 wallpaper 指定了默认壁纸，如果用户没设置过壁纸就采用这个壁纸。 color指定了壁纸采用的文字颜色，可以设置获得焦点后和未获得焦点的文字颜色，这会强制覆盖系统当前的颜色。 flag 属性里目前只有一个值 nosep，隐藏每行内容之间的分割线。statuspane 属性是用来选择 symbian 系统状态栏。可以是 idle,flat,usual,empty。默认是 empty。就是不显示系统状态栏。theme 里包含各种 plugin。plugin 里
4、最重要的属性是 com，这个指定了桌面将创建那个组件。下面是可用的组件名称1. hd_placeholder2. hd_status3. hd_digitalclock4. hd_analogclock5. hd_clock6. hd_weather7. hd_large_weather_icon8. hd_news9. hd_sns10.hd_music11.hd_luna12.hd_search13.hd_todo14.hd_calendar15.hd_dock16.hd_shortcutplugin 里除了 com 属性还能放 pos，size，bg，flag 属性，在使用某些 com
5、值的情况下还有特殊的属性可以支持。pos 属性是定义了 plugin 的位置，这在插件作为绝对坐标对齐的时候生效，如果插件不是绝对坐标对齐的，这个属性不生效。size 指定了插件的大小，在任何时候生效。可以通过*号表示服从默认大小设置。比如size=*,32表示宽度默认，高度 32。bg 属性指定了 plugin 的背景内容，里面是一条绘制语句。在后面有专门介绍。flag 是控制符。每种 plugin 都有默认的 flag。一旦写了 flag，就会覆盖默认值。比如 hd_clock 的默认 flag 是可获得焦点，可以通过修改 flag 让他不能获得焦点 。这样用户操作键盘的时候就无法对焦到这
6、个 plugin 上。flag 是有以下值组成的字符串 。nav abs bottomnav 表示可以获得焦点abs 表示绝对坐标对其bottom 表示从底部开始排版这些值组成用空格分割，达到各种效果。flag=nav abs表示可获得焦点的绝对坐标对齐flag=nav bottom表示可获得焦点的底部对齐flag=”，那么表示不可获得焦点，向上排版对其。背 景背景是由各种绘图语句构成的，用来指定 plugin 背景内容。最简单的方式是在 plugin 的 bg 属性里指定一个背景。 比如这里指定了一个 box 背景，从主题的 skin 文件里读取一个矩形绘制，以 box 方式绘制到plugi
7、n 的背景上。也可以多个背景叠加。比如采用 background 标签的方式，给 plugin 指定了 2 个背景内容。注意，这里有个 type 属性。type=focus表示这个背景在获得焦点时候生效。一个 plugin 可以拥有两个背景，一个在无焦点时候生效，一个在获得焦点时候生效。唯一的列外是 hd_shortcut。它的焦点背景只给图标用。而不是整个 plugin。背景绘图语句有以下几种：box:outer_rect;inner_rectrow:outer_rect;inner_rectrow_top:outer_rect;inner_rectrow_bottom:outer_rect
8、;inner_rectcol:outer_rect;inner_recctcol_left:outer_rect;inner_rectcol_right:outer_rect;inner_rect_fill:rect:rectimg:image_pathbox 是九宫格绘制方法。根据 outer_rect 和 inner_rect 划定的两个矩形确立一个九宫格。缩放到 plugin 的背景区域上。九宫格的 4 个角不会被缩放。剩下 5 个格子，左右两侧的会上下拉升，上下两条会左右拉升。中间的区域是向四个角拉升。这种方式适合大多数需要指定圆角背景的情况。而且原始图片可以不是很大。row，col
9、是类似与九宫格的方式，不过他们值确定 3 个格子。两头不缩放，中间缩放。row 是横向的缩放，col 是纵向的缩放。他们可以指定各种哦功能对其方法。比如top，bottom，left ，right，当背景图片的大小不大于背景区域时候，会用这些方法对齐。_fill 就是填充，将皮肤中的一个区域拉升填充到背景。空表示直接绘制一个皮肤里的内容。不做任何拉升操作。img 指定了一个外部图片做背景。 里面写的是图片文件的名称。在名称前面可以加一个园括号，加入偏移量。这样能指定他在 plugin 里的那个位置显示。通过背景和 hd_placeholder 组合可以绘制很复杂的背景下面这段代码定义了 htc
10、 风格的大时钟外 部 文 件 寻 址前面用到了各种图片，theme 里的 skin、wallpaper ，背景里的 img。他们都遵循同样的外部文件寻址。外部文件寻址有以下几种情况1. 只有文件名，无路径2. 有完整的文件名和路径3. url只有文件名的情况，是在主题配置文件里寻找。主题配置文件是个 zip 包，可以包含多个文件。相当于一个目录。可以将各种图片都打包到主题配置文件里。有完整文件名和路径的时候直接按这个路径寻找url 是种特殊的情况。目前不支持从网络下载文件。只支持 file:/和 jar:/。file:/实际上就是把完整路径写成 url。用途不大。jar:/ 比较复杂，只是航海
11、家内部使用。特 殊 的 plugin 定 义有些特殊的 plugin 需要很复杂的定义才能完整工作。hd_status这是航海家风格的状态栏，里面可以定义各种组件，以及他们的对其方式group 决定了对其方式，可以左对齐，居中对齐，右对齐。里面可以放各种指示信号。可以放的 indicator 列表signal 信号battery 电量profile 情景模式network 网络date 日期week 星期clock 时钟wifi wifi 信号bt 蓝牙earphone 耳机title 网标armory 小徽章alarm 闹钟misscall 未接来电sms 未读短信email 未读电子邮件u
12、sb usb 插口qq qq 占位符，如果 qq 启动了会空出这个位置让给 qq 的图标hd_digitalclock数字中定义继承与以前的航海风格大时钟。下面是一个不可获得焦点的数字时钟数字钟在 clock 标签里定义，skin 指定了时钟使用的皮肤文件。header 部分定义了各种元素在皮肤里的位置。主要是数字位置，因为大时钟的数字都是用图片绘制的。也能定义 am 和 pm 需要的图标。body 里定义了时钟有哪几部分。最常用的是 hour 和 min，这是小时和分钟。am_pm 是用来显示上午下午，不过如果用户没哟开 12 小时时间格式是不会显示的。其他还有显示日期的 date，农历的
13、lunar，星期 week，以及一个绘制命令 draw。date,lunar,week 都是文本字段，可以指定 color，align。color 是一个 rgb 值，格式是red，green，blue，例如 200，100，100。 align 可以是 left，right，center 里的任一一种。date 是有一个属性 format，可以定义各种格式的时间，而不是单单显示日期。这个内容很繁杂，别处再说。draw 类似前面的背景绘制命令。将时钟皮肤里的一个区域绘制到一处。，不过不负责缩放。hd_analogclock模拟钟一定要指定 size 大小，还要指定轴 axis 的偏移量。之后需
14、要指定时针和分针。指定时针和分针的时候要指定两个半径，内圈半径和轴半径。内圈半径是指针图片中间空白部分的半径。轴半径是指定了指针那个位置对应了轴。具体参考 hour.png 和min.png。下面是一个模拟钟定义hd_cba这是绘制左右软键的 plugin。它的特殊之处在于有一个 color 属性可以指定文字颜色。除了 rgb 值，可以写 transparent 作为值，这样会隐藏左右软键，但是仍然占据位置。这时候可以通过背景属性设置写图标作为左右软键的内容。hd_large_weather_icon这是模仿 htc 风格天气的组件。但是他实际上可以定制出任何组合的天气显示。这个组件里面可以插
15、入控件。一共有三种控件，text，image，ani。下面是个范例ctrl 就是插入的控件，rect 表示位置，相对于 plugin 的左上角的坐标。 text 控件有align 属性，可以指定文本对齐方式。image 控件有 src 属性指定图片。这里可以指定航海家的 xml 图标文件。通过 imgid 属性指定默认的图标 id。ctrl 的控件可以指定 id。id 是个很特殊的东西。特定的 id 是有特定的含义。plugin 会寻找这些有特定 id 的 ctrl 并修改里面的值。像这里的 weathericon，就会被修改成当前天气图标。city 会被修改成城市。date 会被修改成日期。temp 是温度，condition 是当前天气文本。这可以理解成一种协议。用户编辑文本修改表现形式。桌面通过 id 寻找对应的位置写入信息。
