TAESDK2模板开发手册-v1.0.0.doc

TAE SDK 2.0模板开发手册 版本：1.0.0 第一章 SDK开发环境配置 1 1.1 JDK的下载/安装/环境配置 1 1.2 SDK的下载/安装 1 第二章 创建模板 3 2.1 SDK启动/模板创建 3 2.2 模板参数详解 4 2.3 模板目录结构 5 第三章 创建布局布局管理 8 3.1创建布局 8 3.2模板目录及其描述文件 10 3.3布局管理 11 3.4模块添加 14 第四章 开发模块 15 4.1高级模板与简易模版 15 4.2创建设计师模块 16 4.3设计师模块的目录结构 17 4.4删除模块 18 第五章 模板组装 21 5.1模块添加 21 5.2 模块描述文件详解 22 5.3 编辑设计师模块 26 5.3.1 Less的使用 30 5.3.2 JS的编辑 35 5.3.3 common.php的使用 37 第六章 管理风格 40 6.1 默认风格 40 6.2 多套风格 42 第七章 发布模版 44 7.1打包上传 44 第八章 系统设置 45 8.1 系统模块HTML同步 45 8.1.1 为什么要同步系统模块 45 8.1.2 同步系统模块简介 45 8.1.3 默认同步 45 8.1.4 切换店铺同步 46 8.2 模式激活 47 8.3 编译 48 附录A 49 附录B 60 附录C 71 模板上传(打包)验证规则 104 第一章 SDK开发环境配置 1.1 JDK的下载/安装/环境配置 下载：通过谷歌搜索或者是直接到oracle的官网去下载 安装：默认安装就可以 环境配置配置： JAVA_HOME是：jdk的安装目录（例如我的电脑上的是C:\Program Files\Java\jdk1.6.0_33） classpath是：.;%JAVA_HOME%\lib;%JAVA_HOME%\lib\tools.jar path是：%JAVA_HOME%\bin;%JAVA_HOME%\jre\bin; 测试安装是否ok? 命令行：javac或者java –version查看是否会出现相应的结果 1.2 SDK的下载/安装 SDK的下载： /read.php?tid=22997 SDK安装 首先以设计师身份从淘宝店铺装修市场下载SDK安装包（Windows版或者Mac版），然后将安装包解压到任何一个本地磁盘目录（注—SDK不要放在桌面或含有中文名称以及空格的目录下）：解压后的目录结构如所示： 各个目录的作用如下： ? 目录： ? bin目录： bin目录主要放置启动和关闭SDK Server的脚本命令 ? conf 目录： conf 目录主要存放SDK的配置文件以及SDK web控制台的war应用 ? db目录： db目录主要存放SDK模拟数据文件，? htdocs目录： htdocs目录存放设计师设计的模板文件，这个目录下可以存放多套模板文件 ? jre目录 re目录提供SDK运行的Java环境? lib 目录 lib目录主要存放SDK运行所需要的jar包 ? logs目录 logs目录主要存放SDK运行的日志文件 ? temp目录 temp目录存放 ? packages目录 packages目录存放 ? Readme Readme文档介绍启动SDK的方法 Windows版本下， 双击SDK安装后的“启动设计师SDK”图标，即可启动SDK。 如果你使用的是Mac版本，这需要打开terminal，然后进入SDK的bin子目录，执行 sh startServer.sh即可。要关闭SDK，只需要在启动窗口中按下Ctrl+C即可关闭SDK（Mac同样）。 SDK不要放在桌面或含有中文名称以及空格的目录下。 启动SDK后，你的默认浏览器会被自动打开，并且自动打开WEB控制台页面，即看到界面： 图2-1 sdk web控制台页面 当然，某些时候也会出现异常情况：浏览器没有自动打开、没有看到默认的页面（尤其是通过SVN更新的SDK的用户），此时的解决方法为：首先查看SDK启动的命令行提示信息，如下图2-2所示，服务器的IP地址和端口号都已打印出，通过提示，可以手动开启浏览器，然后在地址栏直接输入1:8080/即可。 图2-2 SDK启动的命令行信息 2.2 模板参数详解 点击“创建新模板”，出现以下界面， 图2-3 编辑模板页面 上图每个表单对象的含义为： 模板类型：简易模版/高级模板，它们的区别为：简易模版只含有系统模块，而高级模板包含简易模版的所有功能，并且高级模板还可以设计设计师模块。 目录名称：模板目录的文件夹名称，不支持中文 模板名称：模板显示名称，支持中文 模版版本：当前模板的版本号 模板缩略图：模板的展示图标，填写相对路径，目前支持png、jpg和gif格式的图片 调用数