4. DaVinci工程创建与配置入门

在 Adaptive AUTOSAR 开发中，DaVinci 工程是承载所有配置信息的容器。它并不等同于最终的可执行程序，而是把“平台能力、目标硬件、编译工具链、模块依赖”等元数据组织成一套可被生成器消费的模型。理解工程创建与配置的过程，本质上是在理解 Adaptive 应用的构建输入从何而来。

一、工程创建：从模板到可编辑模型

在 DaVinci Configurator 或 DaVinci Developer Adaptive 中新建工程时，第一步是选择工程模板。模板决定了初始包含哪些模块、使用哪一版 AUTOSAR 元模型以及默认的生成器版本。对于 Adaptive 工程，常见选择是“Adaptive Platform Project”或基于某个 Machine 模板的工程。模板选择错误会导致后续无法添加某些模块，因此建议先确认目标平台版本（如 R24-11）与元模型版本一致。

创建工程时需要填写三个关键属性：工程名称、存储路径、目标平台描述文件。工程名称建议使用“项目缩写_平台版本_用途”的格式，例如 ADP_R2411_Demo，便于在多个工程间区分。存储路径应避免中文和空格，因为部分生成器在调用外部工具链时对路径字符敏感。目标平台描述文件通常是一个 .arxml 或平台包，它定义了该平台支持哪些服务、哪些 API 以及内存布局约束。

工程创建完成后，DaVinci 会生成一个工程目录结构，典型包含：config/（配置模型）、generated/（生成代码）、scripts/（构建脚本）、tools/（工具链引用）。理解这个结构有助于定位后续配置修改的位置。

二、项目属性与目标平台配置

项目属性中最重要的是目标平台（Target Platform）和编译选项。目标平台决定了生成代码所依赖的硬件抽象层和操作系统接口。在 DaVinci 中，目标平台通常通过“Platform”或“Machine”节点配置，需要指定 CPU 架构（如 x86_64、aarch64）、字节序、以及可用的执行管理（Execution Management）能力。

编译选项配置包括：编译器类型（GCC、Clang）、C++ 标准（Adaptive 通常要求 C++14 或 C++17）、优化等级、以及是否启用异常和 RTTI。Adaptive 应用一般建议关闭异常和 RTTI 以减小体积，但若使用某些依赖标准库的组件，则需根据实际情况开启。这些选项会写入生成的 CMake 或构建脚本中，因此必须在生成代码前确认。

三、依赖关系配置：模块与服务的连接

Adaptive 工程的依赖关系主要体现在两个层面：模块依赖和服务依赖。模块依赖指工程中引用的功能集群（Functional Cluster）之间的依赖，例如使用 ara::com 时需要依赖通信管理模块；服务依赖指应用所依赖的 Adaptive 服务实例，例如诊断服务、持久化服务。

在 DaVinci 中配置依赖关系时，通常通过“Service Instance”和“Required Port”来声明。一个典型的配置过程是：先添加服务接口（Service Interface），再创建服务实例（Service Instance），最后在应用进程（Process）中声明所需的端口（Required Port）。生成器会根据这些声明自动生成代理类（Proxy）和骨架类（Skeleton）。

依赖关系配置错误是工程构建失败的主要原因之一。常见问题包括：服务实例未绑定到具体进程、端口方向配置错误、以及服务接口版本不匹配。排查时可以先检查生成日志中的“unresolved reference”或“missing service”提示，再回到配置模型中逐项核对。

四、生成与验证：配置是否生效

完成上述配置后，执行“Generate”操作。生成器会读取工程模型，输出 C++ 头文件、源文件以及构建脚本。验证配置是否生效，可以从三个角度检查：

• 生成日志：确认没有 error 级别的提示，warning 需要逐条判断是否影响功能。
• 生成目录：检查 generated/ 下是否出现了预期的 Proxy/Skeleton 文件，以及 CMakeLists.txt 中的编译选项是否与配置一致。
• 编译验证：在生成目录中执行一次构建，确认工具链能正确找到头文件路径和库路径。若出现链接错误，优先检查目标平台描述文件中的库路径配置。

一个常见的验证方法是：在生成代码中搜索配置时填写的服务接口名称，确认它出现在 Proxy 类的命名空间中。如果搜索不到，说明服务实例未正确绑定到进程，需要回到依赖关系配置中检查端口声明。

五、配置检查清单

为了减少反复修改，建议在生成前按以下清单逐项确认。该清单可直接用于工程评审或自检：