如何在MPLAB X IDE中配置跨Windows/Linux的共享预构建Bash脚本

核心思路 #

针对Windows（MPLAB X自带MinGW Bash或Git Bash）与Linux原生Bash的命令差异，通过系统环境判断+命令兼容封装+路径统一处理实现脚本跨平台通用。

具体步骤 #

1. 统一Bash执行环境 #

• Windows端：确保MPLAB X调用Git Bash或MPLAB自带的MinGW Bash（避免用CMD/PowerShell）。在预构建步骤中显式指定Bash路径执行脚本：

  "C:\Program Files\Git\bin\bash.exe" "${PROJECT_DIR}/prebuild.sh"
  

• Linux端：直接用系统Bash执行：

  bash "${PROJECT_DIR}/prebuild.sh"
  

  也可利用MPLAB X内置条件语法简化配置：

  $if{isWindows, "C:\Program Files\Git\bin\bash.exe" "${PROJECT_DIR}/prebuild.sh", bash "${PROJECT_DIR}/prebuild.sh"}
  

2. 编写跨平台兼容脚本 #

脚本开头加入系统判断，封装差异命令，以下是可直接复用的模板：

#!/bin/bash

# 识别操作系统并封装兼容命令
OS=$(uname -s)
if [[ "$OS" == "Linux" ]]; then
    SED_INPLACE="sed -i"
elif [[ "$OS" == "MSYS_NT"* || "$OS" == "MINGW"* ]]; then
    # Windows下MinGW/Git Bash的sed -i需加空参数
    SED_INPLACE="sed -i ''"
fi

# 统一路径格式：Windows路径转POSIX格式
PROJECT_DIR_POSIX="$PROJECT_DIR"
if [[ "$OS" == "MSYS_NT"* || "$OS" == "MINGW"* ]]; then
    PROJECT_DIR_POSIX=$(cygpath -u "$PROJECT_DIR")
fi

# 生成C头文件示例：自动构建版本信息头
OUTPUT_HEADER="${PROJECT_DIR_POSIX}/src/generated_build_info.h"

# 写入头文件内容
cat > "$OUTPUT_HEADER" << EOF
#ifndef GENERATED_BUILD_INFO_H
#define GENERATED_BUILD_INFO_H

#define BUILD_DATE "$(date +%Y-%m-%d)"
#define BUILD_TIME "$(date +%H:%M:%S)"
#define BUILD_PLATFORM "$OS"

#endif // GENERATED_BUILD_INFO_H
EOF

# 若需修改现有头文件，用封装后的sed命令
# $SED_INPLACE 's/OLD_BUILD_TAG/$(git rev-parse --short HEAD)/g' "$OUTPUT_HEADER"

3. 处理常见命令差异 #

• sed：Windows下sed -i必须加空参数''，通过变量SED_INPLACE封装解决差异。
• 路径解析：用cygpath -u将Windows的C:\xxx格式转为POSIX的/c/xxx，避免路径报错。
• 权限设置：Linux下需给脚本加可执行权限：chmod +x prebuild.sh，提交Git时保留权限配置，Windows端无需额外操作。

4. MPLAB X项目配置 #

1. 将脚本放在项目根目录，命名为prebuild.sh。
2. 右键项目→属性→构建→预构建步骤，添加上述执行命令即可。

验证方法 #

• Windows端：执行MPLAB X构建，检查生成的头文件内容是否正确，无脚本执行报错。
• Linux端：拉取共享代码后执行构建，确认头文件内容与Windows端一致。

内容的提问来源于stack exchange，提问作者Gabriel Staples