feat: add NuGet and Godot distribution

.gitea/workflows/publish-nuget.yml

@@ -0,0 +1,52 @@
+name: Publish NuGet packages
+
+on:
+  push:
+    tags:
+      - 'v*'
+  workflow_dispatch:
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      packages: write
+    env:
+      NUGET_AUTH_TOKEN: ${{ secrets.SHRINKSDK_PACKAGE_TOKEN }}
+    steps:
+      - name: Checkout tagged source
+        uses: actions/checkout@v4
+
+      - name: Set up .NET
+        uses: actions/setup-dotnet@v4
+        with:
+          dotnet-version: '8.0.x'
+
+      - name: Validate tag and pack projects
+        env:
+          GITEA_REF: ${{ gitea.ref }}
+        shell: bash
+        run: |
+          set -euo pipefail
+          tag="${GITEA_REF#refs/tags/}"
+          version="$(node -p "require('./package.json').version")"
+          test "$tag" = "v$version"
+          mkdir -p packages
+          mapfile -d '' projects < <(find DotNet~ Godot~ -type f -name '*.csproj' -print0 2>/dev/null || true)
+          test "${#projects[@]}" -gt 0
+          for project in "${projects[@]}"; do
+            dotnet restore "$project" --configfile NuGet.Config
+            dotnet pack "$project" --configuration Release --no-restore --output "$PWD/packages" --include-symbols --include-source
+          done
+          find packages -maxdepth 1 -name '*.nupkg' -type f | grep -q .
+
+      - name: Publish packages
+        shell: bash
+        run: |
+          set -euo pipefail
+          : "${NUGET_AUTH_TOKEN:?SHRINKSDK_PACKAGE_TOKEN is required}"
+          dotnet nuget push 'packages/*.nupkg' --api-key "$NUGET_AUTH_TOKEN" --source https://git.crash.work/api/packages/ShrinkSDK/nuget/index.json --skip-duplicate
+          if compgen -G 'packages/*.snupkg' > /dev/null; then
+            dotnet nuget push 'packages/*.snupkg' --api-key "$NUGET_AUTH_TOKEN" --source https://git.crash.work/api/packages/ShrinkSDK/nuget/index.json --skip-duplicate
+          fi

.gitignore

@@ -8,3 +8,11 @@
 /Tools~/**/[Oo]bj/
 *.user
 *.DotSettings.user
+/DotNet~/**/[Bb]in/
+/DotNet~/**/[Oo]bj/
+/Godot~/**/[Bb]in/
+/Godot~/**/[Oo]bj/
+/artifacts/
+/packages/
+!DotNet~/**/*.csproj
+!Godot~/**/*.csproj

.npmignore

@@ -6,3 +6,7 @@ Tools~/
 *.sln
 *.user
 *.DotSettings.user
+DotNet~/
+Godot~/
+NuGet.Config
+Directory.Build.props

Directory.Build.props

@@ -0,0 +1,13 @@
+<Project>
+  <PropertyGroup>
+    <LangVersion>latest</LangVersion>
+    <Nullable>enable</Nullable>
+    <Deterministic>true</Deterministic>
+    <ContinuousIntegrationBuild>true</ContinuousIntegrationBuild>
+    <Authors>ShrinkSDK</Authors>
+    <Company>ShrinkSDK</Company>
+    <RepositoryUrl>https://git.crash.work/ShrinkSDK</RepositoryUrl>
+    <IncludeSymbols>true</IncludeSymbols>
+    <SymbolPackageFormat>snupkg</SymbolPackageFormat>
+  </PropertyGroup>
+</Project>

DotNet~/Runtime/ShrinkAppCore.cs

@@ -0,0 +1,137 @@
+#nullable enable
+
+using System;
+using System.Collections.Generic;
+using System.Linq;
+using Cysharp.Threading.Tasks;
+
+namespace ShrinkApp;
+
+[AttributeUsage(AttributeTargets.Class, Inherited = false, AllowMultiple = false)]
+public sealed class ShrinkAppModuleInstallerAttribute : Attribute { }
+
+public interface IShrinkAppModuleInstaller
+{
+    string ModuleId { get; }
+    int Order { get; }
+    IReadOnlyList<string> DependsOn { get; }
+    void RegisterServices(ShrinkAppContext context);
+    UniTask InitializeAsync(ShrinkAppContext context);
+}
+
+public interface IShrinkAppModuleShutdown
+{
+    UniTask ShutdownAsync(ShrinkAppContext context);
+}
+
+public sealed class ShrinkAppSettings
+{
+    public bool VerboseLogging { get; set; }
+    public string[] DisabledModuleIds { get; set; } = Array.Empty<string>();
+}
+
+public sealed class ShrinkAppServices
+{
+    private readonly Dictionary<Type, object> _services = new();
+    public void Register<T>(T service) where T : class => _services[typeof(T)] = service ?? throw new ArgumentNullException(nameof(service));
+    public bool TryGet<T>(out T? service) where T : class
+    {
+        service = _services.TryGetValue(typeof(T), out var value) ? value as T : null;
+        return service != null;
+    }
+    public T GetRequired<T>() where T : class => TryGet<T>(out var value) ? value! : throw new InvalidOperationException($"Required service is not registered: {typeof(T).FullName}");
+    public bool TryUnregister<T>(T service) where T : class => _services.TryGetValue(typeof(T), out var value) && ReferenceEquals(value, service) && _services.Remove(typeof(T));
+}
+
+public sealed class ShrinkAppContext
+{
+    public ShrinkAppContext(object? host, ShrinkAppSettings settings, ShrinkAppServices services)
+    {
+        Host = host;
+        Settings = settings ?? throw new ArgumentNullException(nameof(settings));
+        Services = services ?? throw new ArgumentNullException(nameof(services));
+    }
+    public object? Host { get; }
+    public ShrinkAppSettings Settings { get; }
+    public ShrinkAppServices Services { get; }
+    public static ShrinkAppContext CreateStandalone(ShrinkAppServices services, ShrinkAppSettings? settings = null) => new(null, settings ?? new ShrinkAppSettings(), services);
+}
+
+public sealed class ShrinkAppRuntime
+{
+    private readonly List<IShrinkAppModuleInstaller> _started = new();
+    public ShrinkAppRuntime(object? host = null, ShrinkAppSettings? settings = null, ShrinkAppServices? services = null)
+    {
+        Context = new ShrinkAppContext(host, settings ?? new ShrinkAppSettings(), services ?? new ShrinkAppServices());
+    }
+    public ShrinkAppContext Context { get; }
+    public bool IsRunning { get; private set; }
+    public IReadOnlyList<string> StartedModules => _started.Select(item => item.ModuleId).ToArray();
+
+    public async UniTask StartAsync()
+    {
+        if (IsRunning) return;
+        var installers = Sort(CreateInstallers(), Context.Settings.DisabledModuleIds);
+        try
+        {
+            foreach (var installer in installers) installer.RegisterServices(Context);
+            foreach (var installer in installers)
+            {
+                await installer.InitializeAsync(Context);
+                _started.Add(installer);
+            }
+            IsRunning = true;
+        }
+        catch
+        {
+            await ShutdownStartedAsync();
+            throw;
+        }
+    }
+
+    public async UniTask ShutdownAsync()
+    {
+        await ShutdownStartedAsync();
+        IsRunning = false;
+    }
+
+    private async UniTask ShutdownStartedAsync()
+    {
+        for (var index = _started.Count - 1; index >= 0; index--)
+            if (_started[index] is IShrinkAppModuleShutdown shutdown) await shutdown.ShutdownAsync(Context);
+        _started.Clear();
+    }
+
+    private static IReadOnlyList<IShrinkAppModuleInstaller> CreateInstallers() =>
+        ShrinkAppInstallers.GetDiscoveredInstallerTypes().Select(type =>
+            Activator.CreateInstance(type) as IShrinkAppModuleInstaller ?? throw new InvalidOperationException($"Failed to create installer: {type.FullName}"))
+            .ToArray();
+
+    private static IReadOnlyList<IShrinkAppModuleInstaller> Sort(IEnumerable<IShrinkAppModuleInstaller> source, IEnumerable<string> disabledIds)
+    {
+        var disabled = new HashSet<string>(disabledIds ?? Array.Empty<string>(), StringComparer.OrdinalIgnoreCase);
+        var byId = source.Where(item => !disabled.Contains(item.ModuleId)).ToDictionary(item => item.ModuleId, StringComparer.OrdinalIgnoreCase);
+        var states = new Dictionary<string, int>(StringComparer.OrdinalIgnoreCase);
+        var result = new List<IShrinkAppModuleInstaller>();
+        foreach (var installer in byId.Values.OrderBy(item => item.Order).ThenBy(item => item.ModuleId, StringComparer.OrdinalIgnoreCase))
+            Visit(installer, byId, states, result);
+        return result;
+    }
+
+    private static void Visit(IShrinkAppModuleInstaller installer, IReadOnlyDictionary<string, IShrinkAppModuleInstaller> byId,
+        IDictionary<string, int> states, ICollection<IShrinkAppModuleInstaller> result)
+    {
+        var state = states.TryGetValue(installer.ModuleId, out var value) ? value : 0;
+        if (state == 2) return;
+        if (state == 1) throw new InvalidOperationException($"Circular installer dependency: {installer.ModuleId}");
+        states[installer.ModuleId] = 1;
+        foreach (var dependencyId in installer.DependsOn ?? Array.Empty<string>())
+        {
+            if (!byId.TryGetValue(dependencyId, out var dependency))
+                throw new InvalidOperationException($"Installer dependency missing. Module={installer.ModuleId}, DependsOn={dependencyId}");
+            Visit(dependency, byId, states, result);
+        }
+        states[installer.ModuleId] = 2;
+        result.Add(installer);
+    }
+}

DotNet~/ShrinkSDK.App.Core.csproj

@@ -0,0 +1,20 @@
+<Project Sdk="Microsoft.NET.Sdk">
+  <PropertyGroup>
+    <TargetFramework>netstandard2.1</TargetFramework>
+    <EnableDefaultCompileItems>false</EnableDefaultCompileItems>
+    <AssemblyName>ShrinkApp.Core.Runtime</AssemblyName>
+    <RootNamespace>ShrinkApp</RootNamespace>
+    <PackageId>ShrinkSDK.App.Core</PackageId>
+    <Version>0.2.0</Version>
+    <Description>ShrinkSDK engine-neutral application composition runtime.</Description>
+    <ShrinkCodeGenEnabled>false</ShrinkCodeGenEnabled>
+  </PropertyGroup>
+  <ItemGroup>
+    <Compile Include="Runtime\ShrinkAppCore.cs" />
+    <Compile Include="..\Runtime\ShrinkAppGeneratedRegistry.cs" />
+    <Compile Include="..\Runtime\ShrinkAppInstallers.cs" />
+    <PackageReference Include="UniTask" Version="2.5.10" />
+    <PackageReference Include="ShrinkSDK.CodeGen" Version="0.1.0" PrivateAssets="compile;runtime;contentfiles;native" />
+    <PackageReference Include="ShrinkSDK.Runtime.Abstractions" Version="0.1.0" />
+  </ItemGroup>
+</Project>

NuGet.Config

@@ -0,0 +1,8 @@
+<?xml version="1.0" encoding="utf-8"?>
+<configuration>
+  <packageSources>
+    <clear />
+    <add key="ShrinkSDK" value="https://git.crash.work/api/packages/ShrinkSDK/nuget/index.json" />
+    <add key="nuget.org" value="https://api.nuget.org/v3/index.json" protocolVersion="3" />
+  </packageSources>
+</configuration>

README.md

@@ -2,6 +2,8 @@
 
 `ShrinkApp.Core` 是 `Shrink` 系列模块的统一宿主层。它不直接替代各个基础包的独立使用方式，而是在项目需要“导入一组包后直接起盘”时，提供统一的启动链、模块安装器、服务容器和基础生命周期事件。
 
+Godot 和普通 .NET 项目安装 `ShrinkSDK.App.Core`；可打包源码位于 `DotNet~`，其公开合同与 Unity 包共用同一份 Runtime 源码。
+
 ## 当前定位
 
 - 统一宿主：在 `BeforeSceneLoad` 阶段创建 `ShrinkAppHost`

package.json

@@ -6,7 +6,7 @@
   "unity": "2022.3",
   "dependencies": {
     "com.cneicy.shrink-eventbus": "2.1.0",
-    "com.cneicy.shrink-shared-codegen": "0.1.0",
+    "com.cneicy.shrink-shared-codegen": "0.1.1",
     "com.cysharp.unitask": "2.5.10"
   },
   "keywords": [