基于MSBuild的C跨平台工具集，让Linux、MacOS.zip

# 关于 MSBuildCppCrossToolset - 在Linux、MacOS中编译vcxproj [](https://github.com/Chuyu-Team/MSBuildCppCrossToolset/blob/master/LICENSE)  [](https://github.com/Chuyu-Team/MSBuildCppCrossToolset/graphs/contributors) [](https://github.com/Chuyu-Team/MSBuildCppCrossToolset/releases) [](https://github.com/Chuyu-Team/MSBuildCppCrossToolset/actions/workflows/Build.yml) * QQ群：[860674930](https://qm.qq.com/cgi-bin/qm/qr?k=n4INZdXYqxCgTnTLE5vUmD6qOT6jBsiL&jump_from=webapi&authKey=rEvllm8VBBgAAevZS0IOaGmwYnqFGUPKxX5AjyLWhMIaiF5Ded3ooMKf++G8hLAD) 重要提示：VCTargets中的文件从 `Microsoft Visual Studio\?\?\MSBuild\Microsoft\VC` 提取，Microsoft拥有其所有权利。 重要提示：本项目还未完工…… 本项目基于微软VCTargets修改，为MSBuild实现了跨平台编译vcxproj。相关VS配置高度抽象统一，并与目标编译器功能一比一映射。 > 举个例子：代码完全优化（Full选项），微软编译器时中映射为 `-Ox`，而使用GCC时则映射为`-O3`。 目前开发计划： * [x] [Fea 5](https://github.com/Chuyu-Team/MSBuildCppCrossToolset/issues/5), 添加最小化生成支持。 * [ ] 优化并行生成效率。 * [ ] 单元测试。 # 1. 兼容性 | 兼容的操作系统 | ApplicationType名称 | 支持的PlatformToolset（平台工具集） | ---------------- | ------------------- | ----------------- | Linux | Linux | YY_Cross_GCC_1_0（默认值）、YY_Cross_Clang_1_0 | MacOS | OSX | YY_Cross_GCC_1_0、YY_Cross_Clang_1_0（默认值） > 温馨提示：Windows系统由自己微软MSVC直接支持，所以这边不提供支持。 一般来说，vcxproj中的`ApplicationType`以及`PlatformToolset`无需设置，MSBuildCppCrossToolset会自动根据运行情况自动适应。 如果你想自行设置，请严格按上述表格中的值配置ApplicationType与PlatformToolset。 # 2. 使用方式 # 2.1. 安装 .NET SDK 下载地址：https://dotnet.microsoft.com/zh-cn/download > 必须选择 .NET 6.0或者更高版本。 ## 2.2. 配置 MSBuildCppCrossToolset 首先，我们从[Release](https://github.com/Chuyu-Team/MSBuildCppCrossToolset/releases)产物下载MSBuildCppCrossToolset并解压。 假设最终解压目录是`/home/john/Desktop/VCTargets`。我们执行下面这条命令： ``` export VCTargetsPath=/home/john/Desktop/VCTargets/v170/ ``` 它将临时添加`VCTargetsPath`环境变量，如果需要持久配置，请自行修改系统配置。 ## 2.3. 编译vcxproj项目 我们也提供了示例项目，点击查看[Samples](Samples) 假设项目位置： `/home/john/Desktop/ConsoleApplication2/ConsoleApplication2.vcxproj`。并且编译 Release版的x86版本，那么可以输入如下命令： ``` ; Linux、MacOS下编译 x64 dotnet msbuild '/home/john/Desktop/ConsoleApplication2/ConsoleApplication2.vcxproj' '-p:Configuration=Release;Platform=x64' ; Linux、MacOS下编译小端 ARM64 dotnet msbuild '/home/john/Desktop/ConsoleApplication2/ConsoleApplication2.vcxproj' '-p:Configuration=Release;Platform=ARM64' ; Windows下编译 x86。新人特别注意了，vcxproj里没有x86，只有Win32！！！ msbuild "D:\ConsoleApplication2\ConsoleApplication2.vcxproj" -p:Configuration=Release;Platform=Win32 ; Windows下编译 x64 msbuild "D:\ConsoleApplication2\ConsoleApplication2.vcxproj" -p:Configuration=Release;Platform=x64 ``` ## 2.4. 全局支持的属性 ### 2.4.1. PlatformToolset 全局属性 工具集，目前支持以下工具集： | 工具集 | 说明 | ------------------ | ----------------- | YY_Cross_GCC_1_0 | GCC工具集，Linux系统默认的工具集，MacOS暂时对YY_Cross_GCC_1_0支持不好。 | YY_Cross_Clang_1_0 | CLang工具集，MacOS系统默认的工具集。 示例： ```xml <PropertyGroup Condition="'$(Configuration)|$(Platform)'=='Debug|x86'" Label="Configuration"> <PlatformToolset>YY_Cross_GCC_1_0</PlatformToolset> </PropertyGroup> ``` ### 2.4.2. Platform 全局属性 一般来说，Platform拥有以下几种可能： | 目标系统 | 支持的 Platform | -------- | --------- | Linux | x86、x64、ARM、ARM64、MIPS | MacOS | x86、x64、ARM64 > 注意：Platform是在调用msbuild时传入的，一般不应该直接设置到工程。 示例： ``` dotnet msbuild '/home/john/Desktop/ConsoleApplication2/ConsoleApplication2.vcxproj' '-p:Configuration=Release;Platform=x64' ``` > 特别提醒：特别是Linux系统。编译时，必须安装Platform对应的Triplet，否则将找不到g++而失败！比如对于一个x64的Ubuntu，使用GCC编译ARM64小端的Linux程序，则先安装 `g++-aarch64-linux-gun`，命令如下所示： ``` sudo apt-get install g++-aarch64-linux-gun ``` ### 2.4.3. PlatformTriplet 全局属性 平台的Triplet值，比如说：i686-linux-gnu。一般无需设置，框架会根据Platform属性自动调整。 各个平台Platform的PlatformTriplet默认值如下表所示： | Platform | Linux | MacOS | | --------- | ---------------------------- | ---------------------------- | | x86 | i686-linux-gnu | i686-apple-darwin | x64 | x86_64-linux-gnu | x86_64-apple-darwin | ARM | arm-linux-gnueabihf | 不支持 | ARM64 | aarch64-linux-gnu | aarch64-apple-darwin | MIPS | mips-linux-gnu | 不支持 如果对默认的`PlatformTriplet`值不满意，可以考虑手工调整，示例： ```xml <PropertyGroup Condition="'$(Configuration)|$(Platform)'=='Debug|x64'" Label="Configuration"> <PlatformTriplet>x86_64-linux-gnu</PlatformTriplet> </PropertyGroup> ``` ### 2.4.4. Sysroot 全局属性 用于自定义库目录以及头文件位置。此路径会通过`--sysroot`传递给编译器以及链接器。示例： ```xml <PropertyGroup Condition="'$(Configuration)|$(Platform)'=='Debug|x64'" Label="Configuration"> <Sysroot>urs/opt/mysysroot</Sysroot> </PropertyGroup> ``` # 3. 支持的属性以及元素参数映射情况 ## 3.1. ClCompile 它描述了C/C++代码编译参数配置情况。 ### 3.1.1. CompileAs 属性（枚举） 选择源代码文件的编译语言选项。 | 选项 | Windows(MSVC) | Linux(GCC/CLang) | OSX(GCC/CLang) | 选项含义 | ----------------- | ----------------- | ----------------- | -------- | ------ | Default | | | | 使用默认语言（`.c` 文件编译为 C代码，`.m` 文件编译为Object-C代码，`.mm` 文件编译为Object-C++），其他统一编译为C++代码。 | CompileAsC | /TC | -x c | -x c | 编译为 C 代码。 | CompileAsCpp | /TP | -x c++ | -x c++ | 编译为 C++ 代码。 | CompileAsObjC | 不支持 | 不支持 | -x objective-c | 编译为 Object-C 代码。 | CompileAsObjCpp | 不支持 | 不支持 | -x objective-c++ | 编译为 Object-C++ 代码。 示例： ```xml <ClCompile Include="C:\123.cpp"> <CompileAs>CompileAsC</CompileAs> </ClCompile> ``` ### 3.1.2. AdditionalIncludeDirectories 属性（字符串列表） 指定一个或多个要添加到包括路径的目录；如�