Add a LibraryReference item allowing linking of static/shared native libraries.

Author: alexrp

doc/configuration/items.md

@@ -6,10 +6,13 @@ are used by the Zig SDK:
 
 * `Compile`: Source code files passed to the Zig compiler. By default, the Zig
   SDK will populate this item type according to the project type.
-* `IncludeDirectory`: Header include directories passed to the compiler with the
-  `-I` flag. Note that this applies to Zig as well, not just C/C++.
 * `PreludeHeader`: C/C++ header files that will be automatically `#include`d in
   every C/C++ source file by way of Clang's `-include` flag.
+* `IncludeDirectory`: Header include directories passed to the compiler with the
+  `-I` flag. Note that this applies to Zig as well, not just C/C++.
+* `LibraryReference`: Native libraries that should be linked to. These can be
+  either static or dynamic. For multi-platform projects, additions to this item
+  should be conditioned on the value of `RuntimeIdentifier` (or similar).
 * `CHeader`: Prepopulated by the Zig SDK with all files in the project directory
   ending in `.h`.
 * `CSource`: Prepopulated by the Zig SDK with all files in the project directory

src/sdk/ZigCompile.cs

@@ -69,6 +69,9 @@ public string Configuration
     [Required]
     public string LanguageStandard { get; set; } = null!;
 
+    [Required]
+    public ITaskItem[] LibraryReferences { get; set; } = null!;
+
     [Required]
     public bool LinkTimeOptimization { get; set; }
 
@@ -564,6 +567,7 @@ void TryAppendWarningSwitch(string name)
         // TODO: https://github.com/vezel-dev/zig-sdk/issues/8
 
         builder.AppendFileNamesIfNotNull(Sources, " ");
+        builder.AppendFileNamesIfNotNull(LibraryReferences, " ");
         builder.AppendSwitchIfNotNull(isZig ? "-femit-bin=" : "-o ", OutputBinary);
 
         if (!isZig)

src/sdk/build/Vezel.Zig.Sdk.Build.targets

@@ -58,6 +58,7 @@
                     FastMath="$(FastMath)"
                     IncludeDirectories="@(IncludeDirectory)"
                     LanguageStandard="$(LanguageStandard)"
+                    LibraryReferences="@(LibraryReference)"
                     LinkTimeOptimization="$(LinkTimeOptimization)"
                     MicrosoftExtensions="$(MicrosoftExtensions)"
                     NullabilityAnalysis="$(NullabilityAnalysis)"

src/sdk/build/Vezel.Zig.Sdk.Test.targets

@@ -34,6 +34,7 @@
                     FastMath="$(FastMath)"
                     IncludeDirectories="@(IncludeDirectory)"
                     LanguageStandard="$(LanguageStandard)"
+                    LibraryReferences="@(LibraryReference)"
                     LinkTimeOptimization="$(LinkTimeOptimization)"
                     MicrosoftExtensions="$(MicrosoftExtensions)"
                     NullabilityAnalysis="$(NullabilityAnalysis)"