[FAQ] [参考译文] [常见问题解答]使用 CCS v5为 MSP430项目创建库

https://e2e.ti.com/support/microcontrollers/msp-low-power-microcontrollers-group/msp430/f/msp-low-power-microcontroller-forum/886020/faq-creating-library-for-msp430-project-using-ccs-v5

为 MSP430创建 CCS v5静态库项目

第一步是通过选择"File"->"New "->"CCS Project"来创建一个新的 CCS v5项目。 设置项目名称、最重要的是、将"Output Type"设置为"Static Library"、如下所示。

创建静态库代码
下一步是创建静态库代码。 默认情况下、CCS v5项目将在项目中具有 main()函数的 main.c 文件、如下所示。

创建静态库代码时需要注意以下几点：

• 库代码不应包含任何名为"main"的函数、因为这会在应用程序使用库时导致链接错误、因为应用程序代码中也提供了"main"函数的多个定义。
• 库通常附带头文件、因此应使用库与应用程序共享的函数声明在此头文件中列出。

以下示例显示了"test_lib.lib"的实现、其中包含两个函数：increment()和 adding()。 源代码和头文件的实现如下

编译静态库工程
完成代码后、请确保编译成功、并且库文件已成功创建。

使用创建的静态库的示例应用

创建 CCS v5应用项目
使用创建的库的应用程序应在单独的项目中实现。 步骤类似于"Output Type"(输出类型)选项、应设置为"Executable"(可执行)、而不是"Static Library"(静态库)。

复制库文件和库头文件
为了使用创建的库文件、应将其复制到应用程序项目中、并将库文件中提供的函数声明的头文件复制到该项目中。

下图显示了如何通过创建特定文件夹在应用项目中完成库和头文件的复制。

设置应用程序兼容性/链接配置
为了启用引用包含的头文件和库文件的应用程序项目、应调整应用程序编译/链接配置。

首先、将包含路径添加到包含库头文件的文件夹中。 这可以通过转至项目属性("Project"->"Properties")并选择"Build"->"MSP430 Compiler"->"Include Options"来完成。

然后添加库头文件的路径。

下一步是在链接过程中包含库文件。 这可以通过两种方式来实现：

• 提供库名称、包括如下所示的路径：

• 仅提供库名称、并将库文件所在的文件夹添加到库搜索路径

编译应用程序项目
在调整应用程序项目配置以将库头文件包含在编译过程中、并将库文件本身包含在链接过程中之后、应用程序项目应能够成功编译。