SDK: Implement Cesium MSBuild Project SDK

.config/dotnet-tools.json

@@ -0,0 +1,12 @@
+{
+  "version": 1,
+  "isRoot": true,
+  "tools": {
+    "nuke.globaltool": {
+      "version": "7.0.6",
+      "commands": [
+        "nuke"
+      ]
+    }
+  }
+}

.gitattributes

@@ -0,0 +1 @@
+build.sh eol=lf

.github/workflows/perform-common-steps/action.yml

@@ -4,16 +4,20 @@ runs:
   using: "composite"
   steps:
     - name: ⚙ Setup .NET SDK ⚙
-      uses: actions/setup-dotnet@v1
+      uses: actions/setup-dotnet@v3
       with:
-        dotnet-version: '8.0.x'
+        global-json-file: global.json
 
     - name: ♻ NuGet Cache ♻
       uses: actions/cache@v2
       with:
         path: ${{ env.NUGET_PACKAGES }}
         key: ${{ runner.os }}.nuget.${{ hashFiles('**/*.csproj') }}
 
+    - name: 🛠️ Restore local .NET tools 🛠️
+      shell: bash
+      run: dotnet tool restore
+
     - name: 🔄 Restore Nuget Packages 🔄
       shell: bash
-      run: dotnet restore
+      run: dotnet nuke RestoreAll

.github/workflows/run-build-and-unit-tests.yml

@@ -32,8 +32,16 @@ jobs:
 
       - name: 🛠 Build Solution 🛠
         shell: bash
-        run: dotnet build
+        run: dotnet nuke CompileAll
+
+      - name: 🚚 Publish Compiler Bundle 🚚
+        shell: bash
+        run: dotnet nuke PublishCompilerBundle
+
+      - name: 📦 Pack Compiler Bundle 📦
+        shell: bash
+        run: dotnet nuke PackCompilerBundle
 
       - name: ✅ Run Unit Tests ✅
         shell: bash
-        run: dotnet test
+        run: dotnet nuke TestAll

.gitignore

@@ -3,9 +3,13 @@
 
 bin/
 obj/
+artifacts/
+/.nuke/temp
 
 *.dll
 *.exe
 *.runtimeconfig.json
 *.received.txt
 *.user
+
+

.nuke/build.schema.json

@@ -0,0 +1,148 @@
+{
+  "$schema": "http://json-schema.org/draft-04/schema#",
+  "$ref": "#/definitions/build",
+  "title": "Build Schema",
+  "definitions": {
+    "build": {
+      "type": "object",
+      "properties": {
+        "Configuration": {
+          "type": "string",
+          "description": "Configuration to build - Default is 'Debug' or 'Release'",
+          "enum": [
+            "Debug",
+            "Release"
+          ]
+        },
+        "Continue": {
+          "type": "boolean",
+          "description": "Indicates to continue a previously failed build attempt"
+        },
+        "Help": {
+          "type": "boolean",
+          "description": "Shows the help text for this build assembly"
+        },
+        "Host": {
+          "type": "string",
+          "description": "Host for execution. Default is 'automatic'",
+          "enum": [
+            "AppVeyor",
+            "AzurePipelines",
+            "Bamboo",
+            "Bitbucket",
+            "Bitrise",
+            "GitHubActions",
+            "GitLab",
+            "Jenkins",
+            "Rider",
+            "SpaceAutomation",
+            "TeamCity",
+            "Terminal",
+            "TravisCI",
+            "VisualStudio",
+            "VSCode"
+          ]
+        },
+        "NoLogo": {
+          "type": "boolean",
+          "description": "Disables displaying the NUKE logo"
+        },
+        "Partition": {
+          "type": "string",
+          "description": "Partition to use on CI"
+        },
+        "Plan": {
+          "type": "boolean",
+          "description": "Shows the execution plan (HTML)"
+        },
+        "Profile": {
+          "type": "array",
+          "description": "Defines the profiles to load",
+          "items": {
+            "type": "string"
+          }
+        },
+        "PublishAot": {
+          "type": "boolean",
+          "description": "If set to true, publishes compiler packs in AOT mode"
+        },
+        "Root": {
+          "type": "string",
+          "description": "Root directory during build execution"
+        },
+        "RuntimeId": {
+          "type": "string",
+          "description": "If set, only executes targets for a specified runtime identifier. Provided RID must be included in <RuntimeIdentifiers> property of Cesium.Compiler project"
+        },
+        "Skip": {
+          "type": "array",
+          "description": "List of targets to be skipped. Empty list skips all dependencies",
+          "items": {
+            "type": "string",
+            "enum": [
+              "Clean",
+              "CompileAll",
+              "ForceClear",
+              "PackAllCompilerBundles",
+              "PackCompilerBundle",
+              "PackSdk",
+              "PublishAllCompilerBundles",
+              "PublishCompilerBundle",
+              "RestoreAll",
+              "TestAll",
+              "TestCodeGen",
+              "TestCompiler",
+              "TestIntegration",
+              "TestParser",
+              "TestRuntime",
+              "TestSdk"
+            ]
+          }
+        },
+        "SkipCaches": {
+          "type": "boolean",
+          "description": "If set to true, ignores all cached build results. Default: false"
+        },
+        "Solution": {
+          "type": "string",
+          "description": "Path to a solution file that is automatically loaded"
+        },
+        "Target": {
+          "type": "array",
+          "description": "List of targets to be invoked. Default is '{default_target}'",
+          "items": {
+            "type": "string",
+            "enum": [
+              "Clean",
+              "CompileAll",
+              "ForceClear",
+              "PackAllCompilerBundles",
+              "PackCompilerBundle",
+              "PackSdk",
+              "PublishAllCompilerBundles",
+              "PublishCompilerBundle",
+              "RestoreAll",
+              "TestAll",
+              "TestCodeGen",
+              "TestCompiler",
+              "TestIntegration",
+              "TestParser",
+              "TestRuntime",
+              "TestSdk"
+            ]
+          }
+        },
+        "Verbosity": {
+          "type": "string",
+          "description": "Logging verbosity during build execution. Default is 'Normal'",
+          "enum": [
+            "Minimal",
+            "Normal",
+            "Quiet",
+            "Verbose"
+          ]
+        }
+      }
+    }
+  }
+}

.nuke/parameters.json

@@ -0,0 +1,4 @@
+{
+  "$schema": "./build.schema.json",
+  "Solution": "Cesium.sln"
+}

Cesium.Ast/Cesium.Ast.csproj

@@ -1,8 +1,9 @@
 <Project Sdk="Microsoft.NET.Sdk">
 
     <PropertyGroup>
-        <TargetFramework>net7.0</TargetFramework>
+        <TargetFramework>net8.0</TargetFramework>
         <ImplicitUsings>enable</ImplicitUsings>
+        <GeneratePackageOnBuild>true</GeneratePackageOnBuild>
     </PropertyGroup>
 
     <ItemGroup>

Cesium.CodeGen/Contexts/AssemblyContext.cs

@@ -299,7 +299,7 @@ private TypeReference GetStubType(int size)
             "",
             stubStructTypeName,
             TypeAttributes.Sealed | TypeAttributes.ExplicitLayout | TypeAttributes.NestedPrivate,
-            Module.ImportReference(MscorlibAssembly.GetType("System.ValueType")))
+            Module.ImportReference(new TypeReference("System", "ValueType", MscorlibAssembly.MainModule, MscorlibAssembly.MainModule.TypeSystem.CoreLibrary)))
         {
             PackingSize = 1,
             ClassSize = size

Cesium.CodeGen/Ir/Types/InPlaceArrayType.cs

@@ -37,8 +37,8 @@ public FieldDefinition CreateFieldOfType(TranslationUnitContext context, TypeDef
 
         CustomAttribute GenerateCustomFieldAttribute()
         {
-            var typeType = context.Module.ImportReference(context.AssemblyContext.MscorlibAssembly.GetType("System.Type"));
-            var fixedBufferAttributeType = context.AssemblyContext.MscorlibAssembly.GetType("System.Runtime.CompilerServices.FixedBufferAttribute") ?? throw new AssertException(
+            var typeType = context.Module.ImportReference(new TypeReference("System", "Type", context.AssemblyContext.MscorlibAssembly.MainModule, context.AssemblyContext.MscorlibAssembly.MainModule.TypeSystem.CoreLibrary));
+            var fixedBufferAttributeType = new TypeReference("System.Runtime.CompilerServices", "FixedBufferAttribute", context.AssemblyContext.MscorlibAssembly.MainModule, context.AssemblyContext.MscorlibAssembly.MainModule.TypeSystem.CoreLibrary) ?? throw new AssertException(
                     "Cannot find a type System.Runtime.CompilerServices.FixedBufferAttribute.");
             var fixedBufferCtor = new MethodReference(".ctor", context.TypeSystem.Void, fixedBufferAttributeType);
             fixedBufferCtor.Parameters.Add(new ParameterDefinition(typeType));
@@ -104,12 +104,12 @@ private static TypeDefinition CreateFixedBufferType(
         // }
 
         ModuleDefinition module = context.Module;
-        var compilerGeneratedAttributeType = context.AssemblyContext.MscorlibAssembly.GetType("System.Runtime.CompilerServices.CompilerGeneratedAttribute") ?? throw new AssertException(
+        var compilerGeneratedAttributeType = new TypeReference("System.Runtime.CompilerServices", "CompilerGeneratedAttribute", context.AssemblyContext.MscorlibAssembly.MainModule, context.AssemblyContext.MscorlibAssembly.MainModule.TypeSystem.CoreLibrary) ?? throw new AssertException(
                 "Cannot find a type System.Runtime.CompilerServices.CompilerGeneratedAttribute.");
         var compilerGeneratedCtor = new MethodReference(".ctor", context.TypeSystem.Void, compilerGeneratedAttributeType);
         var compilerGeneratedAttribute = new CustomAttribute(module.ImportReference(compilerGeneratedCtor));
 
-        var unsafeValueTypeAttributeType = context.AssemblyContext.MscorlibAssembly.GetType("System.Runtime.CompilerServices.UnsafeValueTypeAttribute") ?? throw new AssertException(
+        var unsafeValueTypeAttributeType = new TypeReference("System.Runtime.CompilerServices", "UnsafeValueTypeAttribute", context.AssemblyContext.MscorlibAssembly.MainModule, context.AssemblyContext.MscorlibAssembly.MainModule.TypeSystem.CoreLibrary) ?? throw new AssertException(
                 "Cannot find a type System.Runtime.CompilerServices.UnsafeValueTypeAttribute.");
         var unsafeValueTypeCtor = new MethodReference(".ctor", context.TypeSystem.Void, unsafeValueTypeAttributeType);
         var unsafeValueTypeAttribute = new CustomAttribute(module.ImportReference(unsafeValueTypeCtor));
@@ -118,7 +118,7 @@ private static TypeDefinition CreateFixedBufferType(
             "",
             $"<SyntheticBuffer>{fieldName}",
             TypeAttributes.Public | TypeAttributes.Sealed | TypeAttributes.SequentialLayout | TypeAttributes.NestedPublic,
-            module.ImportReference(context.AssemblyContext.MscorlibAssembly.GetType("System.ValueType")))
+            module.ImportReference(new TypeReference("System", "ValueType", context.AssemblyContext.MscorlibAssembly.MainModule, context.AssemblyContext.MscorlibAssembly.MainModule.TypeSystem.CoreLibrary)))
         {
             PackingSize = 0,
             ClassSize = sizeInBytes,

Cesium.CodeGen/Ir/Types/StructType.cs

@@ -42,7 +42,7 @@ public TypeDefinition StartEmit(string name, TranslationUnitContext context)
             "",
             Identifier is null ? "<typedef>" + name : Identifier,
             TypeAttributes.Sealed,
-            context.Module.ImportReference(context.AssemblyContext.MscorlibAssembly.GetType("System.ValueType")));
+            context.Module.ImportReference(new TypeReference("System", "ValueType", context.AssemblyContext.MscorlibAssembly.MainModule, context.AssemblyContext.MscorlibAssembly.MainModule.TypeSystem.CoreLibrary)));
         switch (context.AssemblyContext.ArchitectureSet)
         {
             case TargetArchitectureSet.Dynamic:
@@ -106,7 +106,7 @@ private void EmitAsAnonStructure(TranslationUnitContext context)
             string.Empty,
             CreateAnonIdentifier(Members, IsUnion),
             TypeAttributes.Public | TypeAttributes.Sealed,
-            context.Module.ImportReference(context.AssemblyContext.MscorlibAssembly.GetType("System.ValueType")));
+            context.Module.ImportReference(new TypeReference("System", "ValueType", context.AssemblyContext.MscorlibAssembly.MainModule, context.AssemblyContext.MscorlibAssembly.MainModule.TypeSystem.CoreLibrary)));
 
         FinishEmit(type, type.Name, context); // emit fields
 

Cesium.Compiler/Cesium.Compiler.csproj

@@ -4,9 +4,11 @@
         <OutputType>Exe</OutputType>
         <TargetFramework>net8.0</TargetFramework>
         <ImplicitUsings>enable</ImplicitUsings>
-        <PublishAot Condition="$(NETCoreSdkRuntimeIdentifier) != 'osx-x64'">true</PublishAot>
+<!--        <PublishAot Condition="$(NETCoreSdkRuntimeIdentifier) != 'osx-x64' AND $(NETCoreSdkRuntimeIdentifier) != 'osx-arm64'">true</PublishAot>-->
         <PublishSingleFile>true</PublishSingleFile>
         <PublishTrimmed>true</PublishTrimmed>
+        <RollForward>Major</RollForward>
+        <RuntimeIdentifiers>win-x64;win-x86;win-arm64;linux-x64;linux-arm64;osx-x64;osx-arm64</RuntimeIdentifiers>
     </PropertyGroup>
 
     <ItemGroup>

Cesium.Compiler/Main.cs

@@ -1,43 +1,52 @@
+using System.Diagnostics.CodeAnalysis;
 using Cesium.CodeGen;
-using Cesium.Compiler;
 using Cesium.Core;
 using Mono.Cecil;
 
-await CommandLineParser.ParseCommandLineArgs(args, new CompilerReporter(), async args =>
+namespace Cesium.Compiler;
+
+public static class Program
+{
+    [DynamicDependency(DynamicallyAccessedMemberTypes.All, typeof(Arguments))]
+    public static async Task<int> Main(string[] args)
     {
-        var targetArchitectureSet = args.TargetArchitectureSet;
-        var targetRuntime = args.Framework switch
+        return await CommandLineParser.ParseCommandLineArgs(args, new CompilerReporter(), async args =>
         {
-            TargetFrameworkKind.NetFramework => TargetRuntimeDescriptor.Net48,
-            TargetFrameworkKind.NetStandard => TargetRuntimeDescriptor.NetStandard20,
-            _ => TargetRuntimeDescriptor.Net60
-        };
+            var targetArchitectureSet = args.TargetArchitectureSet;
+            var targetRuntime = args.Framework switch
+            {
+                TargetFrameworkKind.NetFramework => TargetRuntimeDescriptor.Net48,
+                TargetFrameworkKind.NetStandard => TargetRuntimeDescriptor.NetStandard20,
+                _ => TargetRuntimeDescriptor.Net60
+            };
 
-        var cesiumRuntime = args.CesiumCRuntime ?? Path.Combine(AppContext.BaseDirectory, "Cesium.Runtime.dll");
-        var defaultImportsAssembly = args.DefaultImportAssemblies ?? Array.Empty<string>();
+            var cesiumRuntime = args.CesiumCRuntime ?? Path.Combine(AppContext.BaseDirectory, "Cesium.Runtime.dll");
+            var defaultImportsAssembly = args.DefaultImportAssemblies ?? Array.Empty<string>();
 #pragma warning disable IL3000 // Automatic discovery of corelib is fallback option, if tooling do not pass that parameter
-        var corelibAssembly = args.CoreLib ?? typeof(Math).Assembly.Location; // System.Runtime.dll
+            var corelibAssembly = args.CoreLib ?? typeof(Math).Assembly.Location; // System.Runtime.dll
 #pragma warning restore IL3000
-        var moduleKind = args.ProducePreprocessedFile ? ModuleKind.Console : args.ModuleKind ?? Path.GetExtension(args.OutputFilePath).ToLowerInvariant() switch
-        {
-            ".exe" => ModuleKind.Console,
-            ".dll" => ModuleKind.Dll,
-            var o => throw new CompilationException($"Unknown file extension: {o}. \"modulekind\" is not specified.")
-        };
-        var compilationOptions = new CompilationOptions(
-            targetRuntime,
-            targetArchitectureSet,
-            moduleKind,
-            corelibAssembly,
-            cesiumRuntime,
-            defaultImportsAssembly,
-            args.Namespace,
-            args.GlobalClass,
-            args.DefineConstant.ToList(),
-            args.IncludeDirectories.ToList(),
-            args.ProducePreprocessedFile);
-        return await Compilation.Compile(args.InputFilePaths, args.OutputFilePath, compilationOptions);
-    });
+            var moduleKind = args.ProducePreprocessedFile ? ModuleKind.Console : args.ModuleKind ?? Path.GetExtension(args.OutputFilePath).ToLowerInvariant() switch
+            {
+                ".exe" => ModuleKind.Console,
+                ".dll" => ModuleKind.Dll,
+                var o => throw new CompilationException($"Unknown file extension: {o}. \"modulekind\" is not specified.")
+            };
+            var compilationOptions = new CompilationOptions(
+                targetRuntime,
+                targetArchitectureSet,
+                moduleKind,
+                corelibAssembly,
+                cesiumRuntime,
+                defaultImportsAssembly,
+                args.Namespace,
+                args.GlobalClass,
+                args.DefineConstant.ToList(),
+                args.IncludeDirectories.ToList(),
+                args.ProducePreprocessedFile);
+            return await Compilation.Compile(args.InputFilePaths, args.OutputFilePath, compilationOptions);
+        });
+    }
+}
 
 class CompilerReporter : ICompilerReporter
 {