第六章 魔兽插件程序员指南.doc

程序员快速入手指南 作者：炽火 Zero ℃ 原文发表于：猫扑魔兽板块实用资料区 引言 本文将以一般的软件编程的眼光审视魔兽插件。剥去其难解的外皮，让你有个清晰的大致了解。 “一针见血”是技术性教学文章的最高境界 —— 炽火 魔兽插件的架构 插件工程 —— 每个插件就是一个项目(或称为工程)。目录位置： 魔兽目录\Interface\Addons\项目名\工程描述 —— 即后缀名为Toc的文件。描述工程的必要信息，也是项目载入时的总入口。屏幕布局 —— 布局描述使用XML文件。使用各种标签代表特定对象(控件)，并描述相互位置及各种特征属性。功能脚本 —— 脚本文件使用LUA语言。使用WoW提供的API函数编写代码实现各种具体操作。 TOC —— 工程描述文件 后缀名为toc的文件就是工程文件，包含工程的基本信息。主要包含以下内容： 1 ## Interface: 适用的魔兽版本号 2 ## Title: 显示的标题（默认语言） 3 ## Notes: 显示的说明（默认语言） 4 ## Title-zhCN: 特定语言的标题（简体中文） 5 ## Notes-zhCN: 特定语言的说明（简体中文） 6 ## Author: 作者 7 ## Version: 版本 8 ## Dependencies: 依赖的插件 9 ## RequiredDeps: 必须依赖的其他插件, 与上项作用相同 10 ## OptionalDeps: 可选倚赖, 一般为库. 11 ## SavedVariables: 统一存放的变量 12 ## SavedVariablesPerCharacter: 按角色存放的变量 13 ## LoadOnDemand: 1 插件在启用状态下不被加载, 必须在游戏内由另一个插件LoadAddOn()调用加载, 通常为存放数据用. 14 ## LoadWith: 当指定插件加载时才加载，前提是 15 ## DefaultState: disabled 默认状态 16 ## Secure: 安全, 只有暴雪插件才能被标记为安全 17 ## LoadManagers: 加载管理器, 通常是另一个插件(例子: AddonLoader, DBM) 18 ## X-Email: 如题 19 ## X-*: 以X-开头的标记通常为自定义标记, 请遵守这个准则. 20 # 注释1 dklasjfkasdj 21 Script.lua -- 脚本文件 22 % 注释2 dskajfklasdjfklsdaj 23 Layout.xml -- 布局文件 ‘#’ 和 ‘%’ 为行注释符号。 而以##开头的注释行可就不光是好看的了，这些都是插件的工程描述标记，要是不注意插件根本就不会载入。 示例中彩色的标记表示标准标记，每个标准标记都有特定功能。其它eMail, Author等为扩展标记，只有注释功能。 工程标记之后的部分为包含文件列表，脚本文件和布局文件，数量随意，但每种至少要有一个：一个lua或一个xml。 包含文件列表中的顺序对应着载入顺序，非常要紧！！！！ 请将所有文件保存为UTF-8 NOBOM, 否则有可能会导致读取错误. 可以用专业文本编辑器修改编码及换行符, 如果你不知道什么是文本编辑器, 可以使用开源的Notepad++. 建议你多下几个插件，打开看看，参考一下。 XML —— 屏幕布局描述文件 在魔兽插件中使用XML来描述UI的屏幕布局。 注释符号：!-- 注释内容 -- 。 如果要写中文注释，必须在XML文件开头添加一行：?xml version=1.0 encoding=UTF-8? XML文件主要内容 一个XML文件往往包含以下内容： !-- Ui标签是包含所有其它标签的根标签 -- Ui xmlns=/wow/ui/ xmlns:xsi=/2001/XMLSchema-instance xsi:schemaLocation=/wow/ui/ C:\Projects\WoW\Bin\Interface\FrameXML\UI.xsd Script file=localization.lua/ !-- 在此载入用于汉化的lua文件 -- Frame name=zBar parent=UIParent !-- 一个Frame框架 -- Scripts !-- 脚本部分，用于处理事件 -- OnLoad zBar_OnLoad();