航海主题制作.docx

1、航海主题制作航海主题制作一、简介航海桌面主题是一套灵活可自定义程度很高的系统。 用户可以通过主题配置文件修改桌面内容，布局和插入动画，互动内容，制作个性化的桌面。二、主题配置文件构成主题配置文件是一个zip文件包，可以通过任何zip文件生成工具打包制作。然 后修改扩展名为“ .v”。将配置文件上传到手机以下任一位置就可以被桌面设置 程序里的主题设置识别出来。c:SystemAppsHDesktop_OX一个主题配置文件必须含有以下文件A、 是描述主题信息，里面包含版号和主题名称。例： 经典风格 v/titlev/themeB、 是主题定义，具体内容后面介绍C、 是主题预览图，在设置的时候显示。

2、预览图可以适配不同分辨率。比如命名 成，就是在320X 240分辨率下使用。可以有多个预览图存在。三、定义主题基本内容A.在里可以定义主题 a.根节点称为theme_pack,含有多个theme标签。桌面运行的时候会根据theme 里的 res 属性选择适合当前屏幕大小的主题。下面是同时定义了 240X 320屏幕和其横屏情况下320X 240的主题。例： v/theme里有 skin, wallpaper, color , flag, statuspane 属性。skin属性指定了当前皮肤图片。wallpaper指定了默认壁纸，如果用户没设置过 壁纸就采用这个壁纸。 color 指定了壁纸采

3、用的文字颜色,可以设置获得焦点后 和未获得焦点的文字颜色，这会强制覆盖系统当前的颜色。 flag 属性里目前只 有一个值nosep,隐藏每行内容之间的分割线。statuspane属性是用来选择 symbian系统状态栏。可以是idle,flat,usual,empty。默认是empty。就是不显示 系统状态栏。里包含各种 plugin。plugin里最重要的属性是com，它指定了桌面将创建哪个组件。下面是可用的组件名称1.hd_placeholder2.hd_status3.hd_digitalclock4.hd_analogclock5.hd_clock6.hd_weather7.hd_la

4、rge_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 值的 情况下还有特殊的属性可以支持。pos属性是定义了 plugin的位置，这在插件作为绝对坐标对齐的时候生效，如果 插件不是绝对坐标对齐的，这个属性不生效。size指定了插件的大小，在任何时候生效。可以通过 *号表示服从默认大小设置。例：size=” *,32

5、表示宽度默认，高度32。bg 属性指定了 plugin 的背景内容，里面是一条绘制语句。在后面有专门介绍。flag是控制符。每种plugin都有默认的flag。一旦写了 flag，就会覆盖默认值。例：hd_clock的默认flag是可获得焦点，可以通过修改flag让他不能获得焦点。 这样用户操作键盘的时候就无法对焦到这个 plugin 上。flag 是有以下值组成的字符串： nav、abs、bottom 。nav表示可以获得焦点；abs表示绝对坐标对齐；bottom表示从底部开始排版； 这些值组成用空格分割，达到最终效果。例：flag=” nav abs”表示可获得焦点的绝对坐标对齐 flag

6、=” nav bottom ”表示可获得焦点的底部对齐flag= “”，那么表示不可获得焦点，向上排版对其。背景背景是由各种绘图语句构成的，用来指定 plugin 背景内容。最简单的方式是在 plugin 的 bg 属性里指定一个背景。例：比如 vplugin com=” hd_placeholder” pos=” 10,60 size= 220,102 bg= box:0,135,134,212;65,186,71,204 flag=” abs” /这里指定了一个box背景，从主题的skin文件里读取一个矩形绘制，以box方式 绘制到 plugin 的背景上。也可以多个背景叠加。另例：vpl

7、ugin com=” hd_large_weather_icon” size= 210,80 flag= abs nav pos= 13,76 fontsize= 18 fontcolor= 255,255,255 vbackground type= focus vrender bg= box:2,104,34,133;7,111,28,128 /vrender bg= box:2,104,34,133;7,111,28,128 / v/background v/plugin采用 background 标签的方式，给 plugin 指定了 2 个背景内容。注意，这里有个 type 属性。typ

8、e=” focus”表示这个背景在获得焦点时候生效。一个 plugin 可以拥有两个背景， 一个在无焦点时候生效， 一个在获得焦点时候生 效。唯一的列外是hd_shortcut。它的焦点背景只给图标用。而不是整个 plugin。 背景绘图语句有以下几种：box：outer_rect;inner_rectrow：outer_rect;inner_rectrow_top:outer_rect;inner_rectrow_bottom:outer_rect;inner_rectcol：outer_rect;inner_recctcol_left:outer_rect;inner_rectcol_ri

9、ght:outer_rect;inner_rect_fill：rect:rectimg：v(x,y)image_pathbox 是九宫格绘制方法。根据 outer_rect 和 inner_rect 划定的两个矩形确立一个 九宫格。缩放到plugin的背景区域上。九宫格的4个角不会被缩放。剩下5个格 子，左右两侧的会上下拉升， 上下两条会左右拉升。 中间的区域是向四个角拉升。 这种方式适合大多数需要指定圆角背景的情况。而且原始图片可以不是很大。row, col是类似与九宫格的方式，不过他们值确定 3个格子。两头不缩放，中间缩放。row是横向的缩放，col是纵向的缩放。他们可以指定各种功能对齐方

10、法。 比如top，bottom，left，right，当背景图片的大小不大于背景区域时候，会用这 些方法对齐。_fill 就是填充，将皮肤中的一个区域拉升填充到背景。空表示直接绘制一个皮肤里的内容。不做任何拉升操作img 指定了一个外部图片做背景。 里面写的是图片文件的名称。在名称前面可 以加一个园括号，加入偏移量。这样能指定他在 plugin 里的那个位置显示。通过背景和 hd_placeholder 组合可以绘制很复杂的背景例：下面这段代码定义了 htc 风格的大时钟vplugin com=” hd_placeholder” pos=” 10,60 size= 220,102 bg= bo

11、x:0,135,134,212;65,186,71,204 flag=” abs” /size= 80,87size= 80,87clock skin=” c:SystemAppsHDesktop_0 xvpart id= 7 rect= 245,0,280,64 /vpart id= 8 rect= 280,0,315,64 /vpart id= 9 rect= 315,0,350,64 /v/headervbody vhour dest= 13,23,93,73 /vmin dest= 115,23,195,73 /vam_pm dest= 20,70,35,80 /v/bodyv/clo

12、ckv/plugin外部文件寻址前面用到了各种图片，theme里的skin、wallpaper,背景里的img。他们都遵循 同样的外部文件寻址。外部文件寻址有以下几种情况1.只有文件名，无路径2.有完整的文件名和路径3.url只有文件名的情况，是在主题配置文件里寻找。主题配置文件是个 zip包，可以包含多个文件。相当于一个目录。可以将各种图片都打包到主题配置文件里。有完整文件名和路径的时候直接按完整文件名与路径寻找。url 是种特殊的情况。目前不支持从网络下载文件。只支持 比较复杂，只是航海 家内部使用。特殊的 plugin 定义有些特殊的 plugin 需要很复杂的定义才能完整工作hd_st

13、atus这是航海家风格的状态栏，里面可以定义各种组件，以及他们的对其方式 /indicator type=misscall 决定了对其方式，可以左对齐，居中对齐，右对齐。里面可以放各种指示信号 可以放的 indicator 列表：signal 信号battery 电量profile 情景模式network 网络date 日期week 星期clock 时钟wifi wifi 信号bt 蓝牙earphone 耳机title 网标armory 小徽章alarm 闹钟misscall 未接来电sms 未读短信email 未读电子邮件usb usb 插口qq 的图标QQ qq 占位符，如果 qq 启动了

14、会空出这个位置让给hd_digitalclock例：数字中定义继承与以前的航海风格大时钟。 下面是一个不可获得焦点的数字 时钟vplugin com=” hd_digitalclock” size= 210,140 flag=” vclock skin=” c:SystemAppsHDesktop_0 x ” 数字钟在 clock 标签里定义， skin 指定了时钟使用的皮肤文件。header 部分定义了各种元素在皮肤里的位置。主要是数字位置，因为大时钟的 数字都是用图片绘制的。也能定义 am 和 pm 需要的图标。vpart id= pm rect= 315,0,350,64 / body

15、里定义了时钟有哪几部分。最常用的是hour和min，这是小时和分钟。am_pm是用来显示上午下午，不过 如果用户没开12小时时间格式是不会显示的。其他还有显示日期的 date，农历的lunar,星期week，以及一个绘制命令draw。date,lunar,week都是文本字段，可以指定 color，align。color是一个rgb值，格 式是 red，green，blue。例：200， 100， 100。align 可以是 left， right， center 里的任一一种。date是有一个属性format，可以定义各种格式的时间，而不是单单显示日期。 这个内容很繁杂，别处再说。draw类

16、似前面的背景绘制命令。将时钟皮肤里的一个区域绘制到一处。例：draw src= 20,12,32,24 dest=” 32,32,64,64 /，不过不负责缩放。hd_analogclock模拟钟一定要指定size大小，还要指定轴axis的偏移量。之后需要指定时针和分 针。指定时针和分针的时候要指定两个半径， 内圈半径和轴半径。 内圈半径是指针图 片中间空白部分的半径。轴半径是指定了指针那个位置对应了轴。具体参考和。例：下面是一个模拟钟定义bg=” img:”axis_radius= 54 /vplugin com=” hd_analogclock” size= 134,134 axis= 6

17、4,62 flag=” vpart type= hour src= inner_radius= 40 v/pluginhd_cba这是绘制左右软键的plugin。它的特殊之处在于有一个color属性可以指定文字 颜色。除了 RGB值，可以写tran spare nt作为值，这样会隐藏左右软键，但是仍 然占据位置。这时候可以通过背景属性设置写图标作为左右软键的内容。hd_large_weather_icon这是模仿 htc 风格天气的组件。但是他实际上可以定制出任何组合的天气显示。这个组件里面可以插入控件。一共有三种控件， text, image, ani。下面是个范例flag= abs nav

18、 pos=例：vplugin com=” hd_large_weather_icon” size= 210,80 13,76 fontsize= 18 fontcolor= 255,255,255 ctrl就是插入的控件，rect表示位置，相对于plugin的左上角的坐标。text控件 有align属性，可以指定文本对齐方式。image控件有src属性指定图片。这里可 以指定航海家的 xml 图标文件。通过 imgid 属性指定默认的图标 id。ctrl 的控件可以指定 id。 id 是个很特殊的东西。 特定的 id 是有特定的含义。 plugin 会寻找这些有特定id的Ctrl并修改里面的值。像这里的 weathericon，就会被修 改成当前天气图标。city会被修改成城市。date会被修改成日期。temp是温度， condition 是当前天气文本。这可以理解成一种协议。 用户编辑文本修改表现形式。 桌面通过 id 寻找对应的位置写入信息。