Green Hills MULTI里的工程和普通桌面IDE不太一样，项目结构往往会和目标处理器、运行环境、链接布局一起确定。工程刚建好时，即使源码只有几个文件，只要目标板、工程层级或者路径配置有一处没对上，构建时就可能连续出现找不到头文件、链接文件缺失、目标架构不匹配等报错。遇到这种情况，与其盯着最后一条错误反复修改，不如从顶层工程和较早出现的构建信息往下查，思路会清楚很多。

　　一、Green Hills怎么创建工程

　　MULTI的Project Manager和Builder负责组织工程与构建关系，项目文件一般以.gpj保存。新建工程时，前面的向导选项会影响后面生成的工程骨架，所以处理器、操作系统和程序布局要和当前开发环境对应起来。

　　1、从Project Wizard建立顶层工程

　　先把顶层工程建出来，再往里面放程序、库和源文件，后面调整工程结构时不容易混乱。

　　①、启动【MULTI】并进入【Project Manager】。

　　②、依次选择【File】→【New Top Project】。

　　③、在【Project Wizard】中填写工程名称和保存目录。

　　④、进入【Operating system】并选择当前项目使用的运行环境。

　　⑤、在【Processor family or target board】中选择对应处理器系列或目标板。

　　⑥、确认设置后继续进入工程类型配置。

　　2、确定程序类型和运行布局

　　①、在向导中进入【Selection of project type】。

　　②、按项目内容选择【Program】等对应工程类型。

　　③、进入【Program layout】。

　　④、根据程序实际运行位置选择对应布局。

　　⑤、完成向导并生成顶层【default.gpj】。

　　向导生成的default.gpj是工程入口之一，后面的子工程、程序和文件关系会围绕这个顶层项目展开。工程复制到其他电脑时，也要一起检查它引用的路径和目标配置。

　　3、把源码加入对应的Program

　　工程骨架建立以后，不要只把源码复制到文件夹里，还要让Builder把这些文件纳入构建关系。

　　①、在【Project Manager】中展开顶层【default.gpj】。

　　②、选中需要加入代码的【Program】项目。

　　③、右键选择【Add File】。

　　④、加入当前项目的【.c】、【.cpp】或其他源文件。

　　⑤、检查新增文件是否出现在工程树中。

　　⑥、保存当前工程。

　　4、补充项目构建选项

　　①、选中需要配置的【.gpj】工程。

　　②、右键打开【Build Options】。

　　③、检查目标处理器相关选项。

　　④、补充项目使用的头文件搜索目录。

　　⑤、确认预处理宏、编译参数和链接相关设置。

　　⑥、保存后执行一次完整构建。

　　二、Green Hills工程配置异常导致编译失败如何处理

　　MULTI编译失败时，后面的报错经常是前面某个问题引出的连锁反应。排查时先找到构建输出里较早出现的有效错误，再顺着对应的源文件、工程层级和参数去查，比同时修改多处配置更容易定位原因。

　　1、先看构建输出里的原始报错

　　构建窗口里如果一次出现很多错误，不要从最后一条往回猜，先找到前面直接指向文件、路径或编译参数的信息。

　　①、重新执行当前工程的【Build】。

　　②、打开【Output】区域查看构建信息。

　　③、找到较早出现的编译或链接错误。

　　④、记录报错对应的【源文件】、【路径】或【选项】。

　　⑤、查看该文件实际使用的编译命令。

　　⑥、确认工程设置是否已经进入本次构建。

　　2、处理头文件或源码找不到的问题

　　①、选中报错文件所属的【.gpj】工程。

　　②、打开【Build Options】。

　　③、检查当前工程的头文件搜索目录。

　　④、核对路径相对于工程目录的位置。

　　⑤、确认目标【.h】或源文件确实存在。

　　⑥、保存修改并重新执行【Build】。

　　3、检查配置到底作用在哪一层

　　①、在【Project Manager】中查看报错文件所在的子工程。

　　②、分别检查顶层【default.gpj】和当前子工程。

　　③、打开对应层级的【Build Options】。

　　④、核对编译参数是否加在实际参与构建的项目上。

　　⑤、检查单个源文件是否存在独立选项。

　　⑥、修正后重新构建当前目标。

　　有些工程看起来已经填过参数，但设置加在了另一个Program或上层项目，出错文件并没有继承到。判断时以实际构建命令为准，会比只看配置窗口更可靠。

　　4、排查目标架构和程序布局不匹配

　　处理器系列、运行环境或者Program layout选错后，源码本身可能没有问题，构建仍会在编译或链接阶段停下来。

　　①、打开顶层【default.gpj】。

　　②、进入相关【Build Options】。

　　③、核对当前目标处理器设置。

　　④、检查工程使用的【Program layout】和目标环境。

　　⑤、确认启动文件、链接配置与当前平台对应。

　　⑥、修正配置后重新生成工程。

　　5、工程迁移后出现大量路径错误

　　①、打开顶层【default.gpj】。

　　②、检查工程树中失效的文件引用。

　　③、搜索已经不存在的旧目录或盘符。

　　④、修正头文件、库文件和子工程路径。

　　⑤、确认工具链目录在当前电脑可用。

　　⑥、重新执行完整构建。

　　三、Green Hills工程修复后怎么确认配置

　　编译错误消失以后，还要确认工程不是“碰巧过了一次”。尤其是从旧电脑迁移过来的项目，或者刚调整过工程层级的项目，清掉旧产物再重新构建一次，更容易发现残留配置。

　　1、清理旧结果后重新构建

　　①、在【Project Manager】中选中当前构建目标。

　　②、执行工程对应的【Clean】操作。

　　③、重新运行【Build】。

　　④、查看【Output】中的编译和链接过程。

　　⑤、确认各个源文件使用的是当前工程配置。

　　如果清理后仍然可以稳定完成构建，说明之前的成功结果不是旧目标文件留下来的假象，也方便继续进入下载和调试阶段。

　　2、把可复现的工程配置保留下来

　　工程后面还会改代码、换电脑或者交给其他人继续维护，单独保存源码并不够。

　　①、保留顶层【default.gpj】和相关子工程文件。

　　②、记录当前使用的工具链版本。

　　③、整理工程依赖的头文件和库目录。

　　④、保存目标处理器与构建选项记录。

　　⑤、归档本次能够通过构建的工程状态。

　　总结

　　Green Hills创建工程时，前面几个向导选项看起来只是基础配置，后面却会一直影响编译和链接。工程一旦报错，先去看构建输出，再确认.gpj层级、路径和目标设置，往往比到处改选项省事。平时把能正常构建的工程状态留一份，工具链版本和关键路径也记清楚，后面迁移项目或者新增模块时会少走不少弯路。希望这些整理能给大家处理Green Hills工程创建和编译问题时提供一些参考。