痞子衡嵌入式：MCUXpresso IDE下添加新路徑下源文件進工程編譯的方法

2021 年 1 月 2 日
筆記
B5.開發環境MCUXpresso

　　大家好，我是痞子衡，是正經搞技術的痞子。今天痞子衡給大家介紹的是MCUXpresso IDE下添加新路徑下源文件進工程編譯的方法。

　　接著上篇文章《MCUXpresso IDE下SDK工程導入與workspace管理機制》接著聊，痞子衡說過不建議從零開始創建新工程項目，最好就是導入一個SDK里的現成項目（盡量跟你最終需求相近，主要是需要的SDK基礎驅動都要包含），然後在這個項目基礎上修改成自己想要的最終工程。

　　如果你是一個習慣於IAR或者MDK這種非Eclipse式集成開發環境的用戶，你可能會對MCUXpresso IDE下管理工程（主要是在工程里增加源文件）的方式感到不適應。本文痞子衡將為你指明MCUXpresso IDE下增加源文件讓你不適應的地方。

一、準備測試環境

　　上篇文章《MCUXpresso IDE下SDK工程導入與workspace管理機制》里我們導入了RT500的一個hello world項目進workspace空間，讓我們將這個項目拷貝到如下自定義的路徑，然後在MCUXpresso IDE下使用 Import project(s) from file system 方式並且不勾選 Copy projects into workspace 選項去打開自定義路徑下的hello world工程。

　　為簡單起見，我們再創建三組源文件：sw_delay1.c/h、sw_delay2.c/.h、sw_delay3.c/.h，我們會用這三組源文件來測試三種不同路徑類型下添加源文件進工程的情況。

////////////////sw_delayx.c////////////////
#include "sw_delayx.h"
void sw_delayx(uint32_t n)
{
    while (n != 0U)
    {
        n--;
    }
}

////////////////sw_delayx.h////////////////
#include <stdint.h>
#if defined(__cplusplus)
extern "C" {
#endif
void sw_delayx(uint32_t n);
#if defined(__cplusplus)
}
#endif

二、已有路徑下添加源文件進工程

　　第一種測試情況最簡單，我們直接把sw_delay1.c/h文件放到\mcux_test\evkmimxrt595_hello_world\source\路徑下，跟主函數源文件hello_world.c放在一起。當我們將新源文件放到已有路徑下時，在MCUXpresso IDE工程里新文件就立刻顯示在了介面左上角的workspace里（可以理解為直接被添加進工程了），根本不用你手動添加（這是跟IAR/MDK相比第一個不同的地方，也是你可能不適應的地方），這時候我們可以在主函數文件里直接引用和調用sw_delay1.c/h里的內容，不需要再額外做任何工程設置。

　　自動刷新工程路徑下源文件進工程是Eclipse型IDE的特色，這個特色其實挺好，只有一種情況下不太方便，那就是多個不同源文件中均有相同函數定義（可能是測試目的，或者刻意保留不同版本函數實現），這種情況下在工程編譯時會報錯，需要在IDE里主動右擊你不想添加進工程的源文件，在Properties框里勾選上 Exclude resource from build。

三、新路徑下添加源文件進工程

3.1 在工程文件所在路徑下

　　現在我們換一種情況，還是在當前工程路徑\mcux_test\evkmimxrt595_hello_world下，但是新建一個名為sw_delay2的文件夾，並且將sw_delay2.c/h文件放到\mcux_test\evkmimxrt595_hello_world\sw_delay2\路徑下。因為有了新路徑，此時還需要在工程Properties選項的MCU C Compiler / Includes里（最好在MCU Assembler / General 里也同樣設置）將該新路徑添加進去。

　　此時新文件夾sw_delay2及其中源文件好像同樣被自動更新到了工程workspace中，我們試試在主函數源文件中調用sw_delay2()，並編譯工程。很遺憾，工程編譯報錯，提示undefined reference to `sw_delay2’，就是找不到sw_delay2()函數，這是為什麼？

　　這裡要介紹第二個讓你不適應的地方，那就是工程文件所在路徑下的新建文件夾看起來被自動更新顯示到工程workspace中了，但其實其中源文件並沒有真正被添加進工程，還需要你手動做一次路徑添加，在工程Properties選項的C/C++ General的Paths and Symbols下做如下操作。做完之後，你可以在workspace里看到此時sw_delay2文件夾被提到了Debug上面顯示（在SDK工程里，Debug和doc文件夾一般顯示在最下面，這兩個並沒有被真正添加進工程源文件路徑，凡是顯示在它們後面的文件夾都是沒有被真正加入工程的），現在工程可以正常編譯了。

3.2 非工程文件所在路徑下

　　最後介紹一種最複雜的情況，這次不在工程路徑\mcux_test\evkmimxrt595_hello_world下做文章，我們在\mcux_test\路徑下新建一個名為sw_delay3的文件夾，並且將sw_delay3.c/h文件放到\mcux_test\sw_delay3\路徑下。因為這個新路徑跟工程路徑不相關，因此工程workspace沒有自動顯示它，此時當然需要我們手動來添加這個文件夾進工程。右擊工程選擇 New / Folder，使用Folder選項里Advanced下面的 Link to alternate location 功能將sw_delay3文件夾及其源文件添加進工程。

　　此時工程workspace中已經顯示了sw_delay3文件夾，但是顯示在最下面（Debug和doc之後），這時候我們可以當sw_delay3文件夾剛剛被放到\mcux_test\evkmimxrt595_hello_world\下面一樣，按3.1節里的方法走一遍，MCU C Compiler / Includes和C/C++ General – Paths and Symbols下都分別再設置一下。

　　這裡有第三個讓你不適應的地方，非工程文件所在路徑下的源文件夾在被強制鏈到工程里時，其Include路徑直接轉變成了當前工程路徑/${ProjName}/下，並不需要像IAR/MDK那樣使用 ../ 去回退尋找具體的相對路徑。

　　至此，MCUXpresso IDE下添加新路徑下源文件進工程編譯的方法痞子衡便介紹完畢了，掌聲在哪裡~~~

歡迎訂閱

文章會同時發布到我的部落格園主頁、CSDN主頁、知乎主頁、微信公眾號平台上。

微信搜索”痞子衡嵌入式“或者掃描下面二維碼，就可以在手機上第一時間看了哦。

Tags: B5.開發環境MCUXpresso