IKVM.Clang.Sdk 2.0.4

IKVM.Clang.Sdk

MSBuild SDK for compiling C, C++, Objective-C, and assembly source files with the Clang compiler. Produces executables, shared libraries, and static libraries targeting any LLVM triple — Windows, Linux, macOS, WebAssembly, and more.

Requirements

• LLVM / Clang with clang and llvm-ar accessible on PATH
• MSBuild 17+ (ships with Visual Studio 2022, or via the .NET SDK)
• Visual Studio 2022 17.0+ with the IKVM.Clang extension for IDE support (optional)

Quick Start

Create a project file (conventionally .clangproj, but any extension works):

<Project>
    <Import Project="Sdk.props" Sdk="IKVM.Clang.Sdk" />

    <PropertyGroup>
        <TargetIdentifiers>x86_64-pc-windows-msvc</TargetIdentifiers>
        <OutputType>exe</OutputType>
    </PropertyGroup>

    <ItemGroup>
        <Compile Include="src\*.c" />
    </ItemGroup>

    <Import Project="Sdk.targets" Sdk="IKVM.Clang.Sdk" />
</Project>

Then build:

dotnet build

Output Types

Set <OutputType> in your project to one of:

Target Triples

TargetIdentifiers accepts one or more semicolon-separated LLVM target triples.

<TargetIdentifiers>x86_64-pc-windows-msvc</TargetIdentifiers>


<TargetIdentifiers>x86_64-pc-linux-gnu;aarch64-pc-linux-gnu</TargetIdentifiers>

Common triples:

Supported Source File Types

Key MSBuild Properties

Item Metadata

Compile items

Header items

Headers with <CopyToIncludeDirectory>true</CopyToIncludeDirectory> (the default) are copied to the intermediate headers\ output folder and automatically added to the include path of dependent projects.

Project References

Reference another IKVM.Clang.Sdk project to automatically link its library and expose its headers:

<ItemGroup>
    <ProjectReference Include="..\MyLib\MyLib.csproj" />
</ItemGroup>

The referenced project's output library and headers\ folder are wired up automatically.

Visual Studio Integration

Install the IKVM.Clang extension to get:

• Full CPS-based project system (Solution Explorer, property pages)
• Syntax highlighting for C, C++, Objective-C, and Assembly
• Custom project and file icons

When you open a project that uses this SDK, Visual Studio will offer to install the extension automatically if it is not already present.

Source and Issues

https://github.com/ikvmnet/ikvm-clang