Clarion for Mac 详细使用指南

Clarion for Mac 是一款功能强大的专业软件开发环境，尤其擅长快速构建数据驱动的商业桌面及Web应用程序。它采用独特的模板驱动开发模式，结合强大的数据库支持，使开发者能够高效地完成从界面设计、业务逻辑编码到最终部署的全过程。本文旨在提供一份详尽的操作指南，帮助用户快速掌握其核心功能与工作流程。

一、核心界面与工作区详解

Clarion for Mac 的主界面是一个集成开发环境（IDE），主要分为以下几个关键区域：

• 菜单栏与工具栏：位于窗口顶部，提供文件操作、项目构建、调试、工具访问等核心命令的快捷入口。
• 应用程序浏览器：通常位于左侧面板，以树状结构展示当前解决方案（Solution）、应用程序（Application）、模块、数据文件、字典、窗口、报表等所有构成元素，是项目导航的核心。
• 编辑器工作区：中心区域，用于显示和编辑各种设计器（如窗口设计器、报表设计器、源代码编辑器）和文档。支持标签页切换。
• 属性面板：通常位于右侧，用于查看和修改在应用程序浏览器或编辑器工作区中所选对象（如一个按钮、一个数据字段）的所有属性，如尺寸、颜色、数据绑定、事件等。
• 输出与错误面板：位于底部，显示编译进度、构建日志、调试信息、错误和警告列表，是排查问题的重要窗口。
• 模板与代码片段面板：可能以浮动窗口或停靠面板形式存在，提供可拖拽的预定义控件和代码模板，加速开发。

二、完整操作流程：从创建到导出

1. 创建新项目

步骤1： 启动 Clarion for Mac。在启动界面或通过菜单栏 文件(File) -> 新建(New)... 打开新建项目向导。

步骤2： 在向导中，选择项目类型，例如“Windows Desktop Application”或“Web Application”。

步骤3： 指定项目名称、存储位置，并通常关联一个数据字典（Dictionary）文件（.DCT）来定义数据结构和关系。

步骤4： 点击“完成”，Clarion 将基于模板生成一个包含基本框架的新项目，并在应用程序浏览器中显示其结构。

2. 设计数据与界面

步骤1： 定义/打开数据字典： 通过 工具(Tools) -> 字典管理器(Dictionary Manager) 打开或创建字典。在此处定义表（Tables）、字段（Fields）、键（Keys）和关系（Relationships）。

步骤2： 创建程序模块： 在应用程序浏览器中右键点击应用程序名，选择“添加(Add)” -> “模块(Module)…”或“窗口(Window)…”。

步骤3： 使用窗口设计器： 双击新创建的窗口文件（.INC 或类似），中心工作区将打开窗口设计器。从工具栏或模板面板拖放控件（如按钮、文本框、列表框、数据网格）到窗口画布上。

步骤4： 绑定数据与设置属性： 选中控件，在右侧属性面板中设置其属性。对于数据控件，在“属性”中找到“Use”字段或类似选项，将其绑定到数据字典中定义的字段。通过属性面板可以轻松调整位置、字体、颜色、事件（如“Accepted”事件对应点击按钮）等。

3. 编写业务逻辑

步骤1： 嵌入源代码： 在窗口设计器中，选中控件（如按钮），在属性面板中找到其相关事件（如“Accepted”）。点击事件旁边的编辑（…）按钮，将打开内联源代码编辑器或过程编辑器。

步骤2： 使用过程编辑器： 在应用程序浏览器中双击过程（Procedure）文件，会打开专门的过程编辑器。这里可以编写更复杂的业务逻辑。Clarion 语言语法类似于 Pascal，易于读写。

步骤3： 插入模板代码： 在代码编辑器中右键，常可通过“插入(Insert)”菜单选择预置的代码模板（如循环、条件判断、数据库操作），极大提升编码效率。

4. 构建与调试

步骤1： 编译项目： 点击工具栏上的“编译(Compile)”按钮（或按 Cmd + B），Clarion 将开始编译应用程序。进度和结果（成功或错误）将显示在底部输出面板。

步骤2： 调试运行： 点击工具栏上的“运行(Run)”按钮（或按 Cmd + R）启动调试。程序将在调试模式下运行。可以设置断点（在代码行号前点击），使用 Cmd + F5 进行逐过程调试，观察变量值等。

注意： 首次运行前，请确保在项目设置中正确配置了目标类型（如生成 .APP 文件）。

5. 导出最终应用程序

步骤1： 生成最终版本： 在菜单栏选择 项目(Project) -> 项目属性(Project Properties)...，确保构建配置为“Release”（发布）模式以进行优化。

步骤2： 执行完整构建： 点击工具栏上的“构建(Build)”按钮（或使用 Cmd + Shift + B）。此操作将执行完整的编译和链接，生成最终的可执行文件包。

步骤3： 定位输出文件： 构建成功后，在输出面板中会显示生成文件的路径。通常，生成的可执行文件（.APP 应用程序包）位于项目文件夹下的 “Bin” 或 “Exe” 子目录中。此文件即可分发给最终用户。

三、常用功能进阶技巧

• 活用模板链： Clarion 的核心是模板。深入理解并自定义应用程序模板、窗口模板和控件模板，可以标准化开发，实现“一次设计，多处生成”。
• 数据字典的威力： 尽可能在数据字典中完整定义业务数据模型。之后在创建窗口或报表时，可以直接从字典拖拽表或字段到设计器，Clarion 会自动生成对应的、已绑定的控件，事半功倍。
• 快速导航与查找： 在应用程序浏览器中，使用 Cmd + F 可以快速定位文件或对象。在代码编辑器中，使用 Cmd + G 跳转到指定行。
• 多窗口布局管理： 对于复杂应用，可以保存不同的窗口布局（通过 窗口(Window) -> 保存布局(Save Layout)），在不同开发阶段（如设计、调试）快速切换。
• 继承与原型： 创建具有通用功能的“基类”窗口或过程，然后让其他窗口继承它，可以有效实现代码复用和统一界面风格。

四、常见问题与解决方案

• 问题1：编译时提示“未定义的符号”错误。
  • 解决方案： 检查是否引用了未包含的库文件（.LIB）或模块。在项目属性（Cmd + ,）的“链接器(Linker)”设置中添加正确的库路径和文件名。确保所有过程都已正确定义或在字典中声明。
• 问题2：程序运行时，数据无法保存到数据库。
  • 解决方案： 首先检查数据控件的“Use”属性是否绑定到了正确的表字段。其次，确认窗口或数据队列的“Update”属性已设置为允许更新。最后，检查数据库连接驱动和连接字符串是否正确。
• 问题3：窗口设计器中控件对齐困难，界面不美观。
  • 解决方案： 多使用设计器工具栏上的对齐工具（左对齐、顶对齐、水平居中、垂直间距相等）。可以按住 Shift 键多选控件后使用对齐功能。善用“网格对齐”选项。
• 问题4：调试时无法命中断点。
  • 解决方案： 确认是以调试模式（Debug）运行，而非直接运行（Release）。检查断点是否打在有效的可执行代码行上（注释行、空行无效）。有时需要完全重新编译（Cmd + Shift + B）后再调试。

五、Clarion for Mac 快捷键汇总表