netbiz.ets 文件
如果你要构建 Netbiz 应用,你需要将 netbiz.ets 文件放在 mod_dirs 偏好设置所列的某个目录中。有关该文件应放置的位置,参见File Organization。
netbiz.ets 文件用于:
- 定义 Netbiz 项目中将可用的各个编辑器。
- 指定可用的资源文件,这些资源文件包含使用 Dialog Box Editor 创建的自定义对话框(
op_etsed.)。 - 指定可用的图标数据库,这些数据库由图标编辑器创建。
- 指定 Netbiz 工具启动时将调用的函数的名称。
- 指定显示在主 Netbiz 工具窗口标题栏中的文本(程序横幅)。
netbiz.ets 文件是编辑器配置文件的一个示例。编辑器配置文件声明一系列编辑器。每个要在你的应用中出现的编辑器,都必须在编辑器配置文件中有一个条目。该文件的默认版本名为 netbiz.ets,存储在 <reldir>/sys/configs 目录中;不过,它可以存储在 mod_dirs 偏好设置所包含的任何目录中。
当你启动应用时,它会读取编辑器配置文件,以确定向用户提供哪些工具。通过向编辑器配置文件添加条目,你可以向界面添加更多工具。所有额外的工具都必须基于现有的工具类型。通过删除编辑器配置文件中的条目,你可以从用户界面中移除工具。
示例 netbiz.ets 文件分析
下面的示例 netbiz.ets 文件将使你的应用会话包含系统菜单(应用启动后即存在)、License Manager 和 Network Editor。
注: 此处显示的文件并非实际文件,仅作示例说明。
图 6:示例 netbiz.ets 文件

netbiz.ets 文件结构
netbiz.ets 文件(以及任何编辑器配置文件)使用如下结构:
- 第一行将该 ETS 脚本标识为编辑器配置文件。
- 第一行之后是全局参数,其形式为
<attribute name>:<attribute value>。program_banner。该属性指定一个将显示在应用窗口标题栏中的字符串。该字符串必须放在引号内。如果指定了 program_banner 偏好设置(例如在偏好设置文件中),其值将覆盖该属性。icon_dbs。该属性指定一个或多个图标数据库文件(以逗号分隔),这些文件将在启动时加载。这些图标数据库文件必须位于当前的模型目录中。这些图标数据库文件可以在 ODK 应用内部创建和编辑。如果指定了 icon_dbs 偏好设置(例如在偏好设置文件中),该列表将被添加到这个列表中。program_resources。该属性指定一个或多个用户界面资源文件(以逗号分隔),这些文件将被搜索对话框描述。这些资源文件必须位于当前的模型目录中。你可以使用op_etsed工具创建和编辑资源文件。ets_initialization。该属性指定一个或多个 ETS 库文件(以逗号分隔),这些文件将在程序启动时加载,并调用其初始化函数。初始化函数必须名为<ets_library_name>_ets_init,不接受参数,也不返回值。这些 ETS 库文件必须位于当前的模型目录中。
- 全局参数之后是工具条目定义块。每个条目定义以“start_editor”行开始,以“end_editor”行结束。在这两行之间,以
<attribute name>: <attribute value>的形式给出描述该工具的属性。name。该属性是 ODK 应用内部使用的唯一字符串。base_type。该属性是该工具条目所基于的默认工具的名称。表 3列出了该属性的有效值。title。该属性是 ODK 应用显示在工具窗口标题栏中的字符串。因此,它应当是对用户有意义的词语或短语。该字符串必须放在引号内。operation_list_files。该属性指向配置工具菜单和菜单项的 ETS 文件。你可以通过用逗号分隔文件名或重复该属性来包含多个操作列表文件。startup_function_library。该属性指定单个 ETS 库文件,当打开此类型的编辑器(目前仅指 base type 为“project”的编辑器)的新文件(而非已有文件)时加载该文件。加载该库是为了调用其启动函数。启动函数必须名为<ets_library_name>_ets_startup,不接受参数,也不返回值。该 ETS 库文件必须位于当前的模型目录中。
- 以“#”作为行首字符的行被视为注释,将被忽略。
表 3:工具基础类型
| 属性值 | 对应工具 |
|---|---|
| System | system window |
| ace | Application Characterization Editor |
| anim | Animation Viewer (op_vuanim) |
| antenna | Antenna Pattern Editor(需要 Wireless 模块) |
| etsconfig | ETS Configuration File Editor |
| etssrc | ETS Source Editor(C 代码) |
| etssrc_cpp | ETS Source Editor(C++ 代码) |
| extsrc | External Source Editor(C 代码) |
| extsrc_cpp | External Source Editor(C++ 代码) |
| filter | Filter Editor |
| gdf | Generic Data File Editor |
| ici | ICI Editor |
| icon | Icon Database Editor |
| licenseman | License Manager |
| link | Link Model Editor |
| modulation | Modulation Curve Editor(需要 Wireless 模块) |
| network | Network Model Editor |
| node | Node Model Editor |
| orb | Orbit Viewer (op_vuorb)(需要 Wireless 模块) |
| packet | Packet Format Editor |
| path | Path Model Editor |
| PDF Editor | |
| plstage | Pipeline Stage Editor(C 代码) |
| plstage_cpp | Pipeline Stage Editor(C++ 代码) |
| probe | Probe Model Editor |
| process | Process Model Editor |
| project | Project Editor |
| simulation | Simulation Sequence Editor |
| wrc | Dialog Box Resource File Editor (op_etsed) |