11 Commits
Author SHA1 Message Date
cneicy 789aa2181b chore: exclude .NET metadata from UPM packages
Publish UPM package / publish (push) Successful in 3s
Publish NuGet packages / publish (push) Successful in 31s
2026-09-05 04:06:19 +08:00
cneicy c6d79fa2ad ci: trust bundled CAs during NuGet publish 2026-09-05 04:04:38 +08:00
cneicy 2150eb37b9 ci: provide OpenSSL for .NET packaging 2026-09-05 04:01:12 +08:00
cneicy 2aa2dd9cdc ci: run .NET packaging in invariant mode 2026-09-05 03:56:52 +08:00
cneicy aaed60f28d ci: bootstrap .NET SDK without system packages 2026-09-05 03:54:01 +08:00
cneicy 635eb447c5 ci: publish NuGet without external actions 2026-09-05 03:49:33 +08:00
cneicy 9dfc3cbc47 ci: install .NET prerequisites for package publishing 2026-09-05 03:45:09 +08:00
cneicy 3c08d076c5 feat: add NuGet and Godot distribution 2026-09-05 03:41:35 +08:00
cneicy 8b3121bc21 feat: add cross-engine runtime support 2026-09-05 02:33:54 +08:00
cneicy 0d1a7d0fb5 chore: release 0.1.5
Publish UPM package / publish (push) Successful in 3s
2026-08-28 04:31:01 +08:00
cneicy 57512d9a31 feat(startup): 支持等待 ContextLoader 启动
Publish UPM package / publish (push) Successful in 2s
2026-08-28 03:44:10 +08:00
16 changed files with 420 additions and 17 deletions
+123
View File
@@ -0,0 +1,123 @@
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 }}
DOTNET_SYSTEM_GLOBALIZATION_INVARIANT: '1'
DOTNET_CLI_TELEMETRY_OPTOUT: '1'
LD_LIBRARY_PATH: /opt/dotnet-libs/usr/lib/x86_64-linux-gnu
SSL_CERT_FILE: /opt/ca-certificates.crt
steps:
- name: Fetch exact tagged source
env:
GITEA_REF: ${{ gitea.ref }}
GITEA_REPOSITORY: ${{ gitea.repository }}
shell: bash
run: |
set -euo pipefail
tag="${GITEA_REF#refs/tags/}"
case "$tag" in
v[0-9]*) ;;
*) echo "Expected a version tag ref, got: $GITEA_REF" >&2; exit 1 ;;
esac
export SHRINKSDK_ARCHIVE_URL="https://git.crash.work/${GITEA_REPOSITORY}/archive/${tag}.tar.gz"
node --input-type=module <<'NODE'
import { writeFile } from 'node:fs/promises';
const response = await fetch(process.env.SHRINKSDK_ARCHIVE_URL);
if (!response.ok) {
throw new Error(`Release archive download failed: ${response.status} ${response.statusText}`);
}
await writeFile('release.tar.gz', new Uint8Array(await response.arrayBuffer()));
NODE
mkdir release
tar -xzf release.tar.gz --strip-components=1 -C release
rm -f release.tar.gz
printf '%s' "$tag" > release/.shrink-sdk-release-tag
- name: Install .NET 8 SDK
shell: bash
run: |
set -euo pipefail
node --input-type=module <<'NODE'
import { writeFile } from 'node:fs/promises';
import { rootCertificates } from 'node:tls';
await writeFile('/opt/ca-certificates.crt', rootCertificates.join('\n'));
const metadataResponse = await fetch('https://dotnetcli.blob.core.windows.net/dotnet/release-metadata/8.0/releases.json');
if (!metadataResponse.ok) throw new Error(`Release metadata download failed: ${metadataResponse.status}`);
const metadata = await metadataResponse.json();
const sdkVersion = metadata['latest-sdk'];
const release = metadata.releases.find(item => item.sdk?.version === sdkVersion);
const file = release?.sdk?.files?.find(item => item.rid === 'linux-x64' && item.name.endsWith('.tar.gz'));
if (!file) throw new Error(`Linux x64 SDK archive not found for ${sdkVersion}`);
const archiveResponse = await fetch(file.url);
if (!archiveResponse.ok) throw new Error(`SDK download failed: ${archiveResponse.status}`);
await writeFile('/tmp/dotnet-sdk.tar.gz', new Uint8Array(await archiveResponse.arrayBuffer()));
const poolUrl = 'https://deb.debian.org/debian-security/pool/updates/main/o/openssl/';
const poolResponse = await fetch(poolUrl);
if (!poolResponse.ok) throw new Error(`OpenSSL package index download failed: ${poolResponse.status}`);
const poolIndex = await poolResponse.text();
const packages = [...poolIndex.matchAll(/href="(libssl3_[^"]+_amd64\.deb)"/g)].map(match => match[1]).sort();
const packageName = packages.at(-1);
if (!packageName) throw new Error('Debian libssl3 package was not found');
const packageResponse = await fetch(poolUrl + packageName);
if (!packageResponse.ok) throw new Error(`OpenSSL package download failed: ${packageResponse.status}`);
await writeFile('/tmp/libssl3.deb', new Uint8Array(await packageResponse.arrayBuffer()));
NODE
mkdir -p /opt/dotnet
tar -xzf /tmp/dotnet-sdk.tar.gz -C /opt/dotnet
mkdir -p /opt/dotnet-libs
dpkg-deb -x /tmp/libssl3.deb /opt/dotnet-libs
rm -f /tmp/dotnet-sdk.tar.gz
rm -f /tmp/libssl3.deb
/opt/dotnet/dotnet --info
- name: Validate, pack and publish
shell: bash
run: |
set -euo pipefail
: "${NUGET_AUTH_TOKEN:?SHRINKSDK_PACKAGE_TOKEN is required}"
export PATH="/opt/dotnet:$PATH"
cd release
tag="$(cat .shrink-sdk-release-tag)"
projects=()
if [[ -d DotNet~ ]]; then
while IFS= read -r -d '' project; do projects+=("$project"); done < <(find DotNet~ -type f -name '*.csproj' -print0)
fi
if [[ -d Godot~ ]]; then
while IFS= read -r -d '' project; do projects+=("$project"); done < <(find Godot~ -type f -name '*.csproj' -print0)
fi
if [[ "${#projects[@]}" -eq 0 ]]; then
while IFS= read -r -d '' project; do projects+=("$project"); done < <(find . -maxdepth 1 -type f -name '*.csproj' -print0)
fi
test "${#projects[@]}" -gt 0
if [[ -f package.json ]]; then
version="$(node -p "require('./package.json').version")"
else
version="$(dotnet msbuild "${projects[0]}" -getProperty:Version -nologo)"
fi
test "$tag" = "v$version"
mkdir -p packages
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 .
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
+8
View File
@@ -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
+6
View File
@@ -6,3 +6,9 @@ Tools~/
*.sln
*.user
*.DotSettings.user
DotNet~/
Godot~/
NuGet.Config
Directory.Build.props
NuGet.Config.meta
Directory.Build.props.meta
+21
View File
@@ -0,0 +1,21 @@
# Changelog
本文件记录 `ShrinkContext.AppAdapter` 的包内变更。
## [0.1.5] - 2026-08-28
### Changed
- 精确依赖 `ShrinkApp.Core 0.1.4``ShrinkEventBus 2.0.1`
## [0.1.4] - 2026-08-28
### Added
- `ShrinkAppLoaderBootstrapper.WaitUntilStartedAsync(CancellationToken)` 支持多个调用方并发等待 ContextLoader 完成启动。
- `ShrinkAppLoaderBootstrapper.StartError` 暴露启动失败异常。
### Changed
- ContextLoader 启动失败时发布 `ShrinkAppStartFailedEvent`,等待方收到原始异常,不再依赖轮询。
- 精确依赖 `ShrinkApp.Core 0.1.3`
+7
View File
@@ -0,0 +1,7 @@
fileFormatVersion: 2
guid: b1937438081846a4ae5ca6f747953987
TextScriptImporter:
externalObjects: {}
userData:
assetBundleName:
assetBundleVariant:
@@ -11,12 +11,12 @@
"dependencies": {
"com.unity.test-framework": "1.1.33",
"com.cneicy.shrink-context-app-adapter": "file:../../..",
"com.cneicy.shrink-app-starter-basic": "0.2.0",
"com.cneicy.shrink-app-starter-basic": "0.2.1",
"com.cneicy.shrink-command": "0.2.0",
"com.cneicy.shrink-command-integration-app": "0.1.1",
"com.cneicy.shrink-datasaver-integration-app": "0.1.1",
"com.cneicy.shrink-command-integration-app": "0.1.2",
"com.cneicy.shrink-datasaver-integration-app": "0.1.2",
"com.cneicy.shrink-network": "0.2.1",
"com.cneicy.shrink-network-integration-app": "0.1.1",
"com.cneicy.shrink-network-integration-app": "0.1.2",
"com.cysharp.unitask": "https://github.com/Cysharp/UniTask.git?path=src/UniTask/Assets/Plugins/UniTask#7c0f199fe0d3fc528024488ccd671e6c7b27745b"
},
"testables": [
+13
View File
@@ -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>
+7
View File
@@ -0,0 +1,7 @@
fileFormatVersion: 2
guid: c36280bbe9441a74383b8075143c623f
DefaultImporter:
externalObjects: {}
userData:
assetBundleName:
assetBundleVariant:
+31
View File
@@ -0,0 +1,31 @@
#nullable enable
using System;
using System.Collections.Generic;
using Cysharp.Threading.Tasks;
using ShrinkApp;
namespace ShrinkContext.AppAdapter;
public sealed class ShrinkContextAppHost
{
private readonly ShrinkContextRuntime _runtime = new();
private readonly ShrinkComponentCatalog _catalog = new();
private readonly ShrinkContextLoader _loader;
public ShrinkContextAppHost(ShrinkAppServices? services = null)
{
Services = services ?? new ShrinkAppServices();
_loader = new ShrinkContextLoader(_runtime, _catalog);
}
public ShrinkAppServices Services { get; }
public ShrinkContextRuntime Runtime => _runtime;
public ShrinkLoaderTransactionDiagnostic? LastTransaction => _loader.LastTransaction;
public void Register(string name, Func<IShrinkComponent> factory) => _catalog.Register(name, factory);
public void Register<TComponent>(string name) where TComponent : IShrinkComponent, new() =>
_catalog.Register<TComponent>(name);
public UniTask ApplyAsync(IReadOnlyList<ShrinkLoaderEntry> entries) => _loader.ApplyAsync(entries);
public UniTask ShutdownAsync() => _runtime.ShutdownAsync();
}
@@ -0,0 +1,17 @@
<Project Sdk="Microsoft.NET.Sdk">
<PropertyGroup>
<TargetFramework>netstandard2.1</TargetFramework>
<EnableDefaultCompileItems>false</EnableDefaultCompileItems>
<AssemblyName>ShrinkContext.AppAdapter</AssemblyName>
<RootNamespace>ShrinkContext.AppAdapter</RootNamespace>
<PackageId>ShrinkSDK.Context.AppAdapter</PackageId>
<Version>0.2.0</Version>
<Description>Engine-neutral ShrinkContext composition host for ShrinkApp.</Description>
<ShrinkCodeGenEnabled>false</ShrinkCodeGenEnabled>
</PropertyGroup>
<ItemGroup>
<Compile Include="Runtime\*.cs" />
<PackageReference Include="ShrinkSDK.Context.Core" Version="0.2.0" />
<PackageReference Include="ShrinkSDK.App.Core" Version="0.2.0" />
</ItemGroup>
</Project>
+8
View File
@@ -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>
+32
View File
@@ -0,0 +1,32 @@
fileFormatVersion: 2
guid: 1b69be49e86a0a74c8ef026adbeff3e1
PluginImporter:
externalObjects: {}
serializedVersion: 2
iconMap: {}
executionOrder: {}
defineConstraints: []
isPreloaded: 0
isOverridable: 0
isExplicitlyReferenced: 0
validateReferences: 1
platformData:
- first:
Any:
second:
enabled: 0
settings: {}
- first:
Editor: Editor
second:
enabled: 0
settings:
DefaultValueInitialized: true
- first:
Windows Store Apps: WindowsStoreApps
second:
enabled: 1
settings: {}
userData:
assetBundleName:
assetBundleVariant:
+8
View File
@@ -2,6 +2,8 @@
ShrinkApp ↔ ShrinkContext 的桥接层:提供当前默认的 ContextLoader 宿主、声明式组合 Profile、诊断工具,并保留 `IShrinkAppModuleInstaller` 兼容适配。当前架构与边界见仓库根 `DESIGN.md`
Godot 和普通 .NET 项目安装 `ShrinkSDK.Context.AppAdapter`;可打包源码位于 `DotNet~`
## 组成
| 类型 | 职责 |
@@ -17,11 +19,17 @@ ShrinkApp ↔ ShrinkContext 的桥接层:提供当前默认的 ContextLoader
`ShrinkAppSettings.hostingMode` 设为 `ContextLoader`(Inspector 或资产字段)。经典项目默认 `ClassicHost`,行为零变化。
```csharp
// 场景业务等待宿主完成;失败时直接收到启动异常。
await ShrinkAppLoaderBootstrapper.WaitUntilStartedAsync(cancellationToken);
// 运行中按模块开关(宿主与其余模块不重启)
var host = ShrinkAppLoaderBootstrapper.Instance!.Host;
await host.SetModuleDisabledAsync("shrink.network", true);
```
`ShrinkAppLoaderBootstrapper.StartError` 保留最近一次启动异常;启动失败同时发布
`ShrinkAppStartFailedEvent`。调用方不需要轮询 `Host.IsRunning`
## 声明式组合
默认资源名为 `Assets/Resources/ShrinkAppComposition.asset`。组合根先用代码注册安装器或原生组件工厂,Bootstrapper 再应用 Profile;配置文件不能通过类型名反射实例化任意组件。
+68 -8
View File
@@ -1,6 +1,9 @@
#nullable enable
using System;
using System.Threading;
using Cysharp.Threading.Tasks;
using ShrinkApp;
using ShrinkEventBus;
using UnityEngine;
namespace ShrinkContext.AppAdapter
@@ -14,6 +17,7 @@ namespace ShrinkContext.AppAdapter
public sealed class ShrinkAppLoaderBootstrapper : MonoBehaviour
{
private static ShrinkAppLoaderBootstrapper? _instance;
private static UniTaskCompletionSource _startupCompletion = new();
/// <summary>
/// Starter/组合包在 SubsystemRegistration 阶段设置的默认装配表。
@@ -22,9 +26,43 @@ namespace ShrinkContext.AppAdapter
public static System.Action<ShrinkAppLoaderHost>? DefaultComposition { get; set; }
public static ShrinkAppLoaderBootstrapper? Instance => _instance;
public static Exception? StartError { get; private set; }
public ShrinkAppLoaderHost Host { get; private set; } = null!;
/// <summary>
/// 等待 ContextLoader 宿主完成启动。支持多个并发等待者;宿主失败时以原始异常结束。
/// </summary>
public static async UniTask WaitUntilStartedAsync(CancellationToken cancellationToken = default)
{
if (_instance?.Host?.IsRunning == true)
return;
if (StartError != null)
throw StartError;
if (ShrinkAppSettings.Instance.hostingMode != ShrinkAppHostingMode.ContextLoader)
{
throw new InvalidOperationException(
"ShrinkAppLoaderBootstrapper requires ShrinkAppHostingMode.ContextLoader.");
}
var task = _startupCompletion.Task;
if (cancellationToken.CanBeCanceled)
await task.AttachExternalCancellation(cancellationToken);
else
await task;
if (StartError != null)
throw StartError;
}
[RuntimeInitializeOnLoadMethod(RuntimeInitializeLoadType.SubsystemRegistration)]
private static void ResetStaticState()
{
_instance = null;
StartError = null;
_startupCompletion = new UniTaskCompletionSource();
}
[RuntimeInitializeOnLoadMethod(RuntimeInitializeLoadType.BeforeSceneLoad)]
private static void AutoBootstrap()
{
@@ -45,17 +83,39 @@ namespace ShrinkContext.AppAdapter
}
_instance = this;
Host = new ShrinkAppLoaderHost();
DefaultComposition?.Invoke(Host);
var profile = ShrinkAppCompositionProfile.LoadDefault();
if (profile != null)
Host.ApplyComposition(profile.ResolveDocument());
global::ShrinkApp.ShrinkApp.InitializeForExternalHost(Host.Services);
Host.StartAsync().Forget(ex =>
StartHostAsync().Forget();
}
private async UniTask StartHostAsync()
{
try
{
Host = new ShrinkAppLoaderHost();
DefaultComposition?.Invoke(Host);
var profile = ShrinkAppCompositionProfile.LoadDefault();
if (profile != null)
Host.ApplyComposition(profile.ResolveDocument());
global::ShrinkApp.ShrinkApp.InitializeForExternalHost(Host.Services);
await Host.StartAsync();
CompleteStartup(null);
}
catch (Exception ex)
{
CompleteStartup(ex);
EventBus.Post(new ShrinkAppStartFailedEvent
{
ErrorMessage = ex.Message,
FailedModuleId = string.Empty
});
Debug.LogException(ex);
Debug.LogError("[ShrinkApp.LoaderHost] 启动失败: " + ex.Message);
});
}
}
private static void CompleteStartup(Exception? error)
{
StartError = error;
_startupCompletion.TrySetResult();
}
private void OnDestroy()
+61
View File
@@ -2,6 +2,7 @@
using System;
using System.Collections.Generic;
using System.Linq;
using System.Reflection;
using Cysharp.Threading.Tasks;
using NUnit.Framework;
using ShrinkApp;
@@ -39,6 +40,8 @@ namespace ShrinkContext.AppAdapter.Tests
[TearDown]
public void TearDown()
{
ResetBootstrapperState();
SetSharedSettings(null);
if (_settings != null)
Object.DestroyImmediate(_settings);
}
@@ -68,6 +71,33 @@ namespace ShrinkContext.AppAdapter.Tests
CollectionAssert.AreEquivalent(new[] { "app.a", "app.b" }, probe.Value!.ModuleIds);
}
[Test]
public void WaitUntilStartedAsync_AllConcurrentWaitersCompleteTogether()
{
PrepareBootstrapperWaitState();
var first = ShrinkAppLoaderBootstrapper.WaitUntilStartedAsync();
var second = ShrinkAppLoaderBootstrapper.WaitUntilStartedAsync();
CompleteBootstrapperStartup(null);
TestAwait.Run(UniTask.WhenAll(first, second));
Assert.IsNull(ShrinkAppLoaderBootstrapper.StartError);
}
[Test]
public void WaitUntilStartedAsync_PropagatesObservableStartupError()
{
PrepareBootstrapperWaitState();
var expected = new InvalidOperationException("test startup failure");
CompleteBootstrapperStartup(expected);
var actual = Assert.Throws<InvalidOperationException>(() =>
TestAwait.Run(ShrinkAppLoaderBootstrapper.WaitUntilStartedAsync()));
Assert.AreSame(expected, actual);
Assert.AreSame(expected, ShrinkAppLoaderBootstrapper.StartError);
}
[Test]
public void SetModuleDisabled_RetiresModuleAndDependents_EnableReloadsWithoutRestart()
{
@@ -210,5 +240,36 @@ namespace ShrinkContext.AppAdapter.Tests
public string Value { get; }
}
private void PrepareBootstrapperWaitState()
{
ResetBootstrapperState();
_settings.hostingMode = ShrinkAppHostingMode.ContextLoader;
SetSharedSettings(_settings);
}
private static void CompleteBootstrapperStartup(Exception? error)
{
var method = typeof(ShrinkAppLoaderBootstrapper).GetMethod(
"CompleteStartup", BindingFlags.NonPublic | BindingFlags.Static);
Assert.IsNotNull(method);
method!.Invoke(null, new object?[] { error });
}
private static void ResetBootstrapperState()
{
var method = typeof(ShrinkAppLoaderBootstrapper).GetMethod(
"ResetStaticState", BindingFlags.NonPublic | BindingFlags.Static);
Assert.IsNotNull(method);
method!.Invoke(null, null);
}
private static void SetSharedSettings(ShrinkAppSettings? settings)
{
var property = typeof(ShrinkAppSettings).GetProperty(
nameof(ShrinkAppSettings.Instance), BindingFlags.Public | BindingFlags.Static);
Assert.IsNotNull(property);
property!.SetValue(null, settings);
}
}
}
+6 -5
View File
@@ -1,13 +1,13 @@
{
"name": "com.cneicy.shrink-context-app-adapter",
"version": "0.1.3",
"version": "0.2.0",
"displayName": "ShrinkContext - ShrinkApp Adapter",
"description": "把现有 IShrinkAppModuleInstaller 包装为 ShrinkContext 组件:依赖缺失改为等待而非抛错,模块激活由响应式余效应驱动。",
"unity": "2022.3",
"dependencies": {
"com.cneicy.shrink-context-core": "0.1.0",
"com.cneicy.shrink-app-core": "0.1.2",
"com.cneicy.shrink-eventbus": "2.0.0",
"com.cneicy.shrink-context-core": "0.2.0",
"com.cneicy.shrink-app-core": "0.2.0",
"com.cneicy.shrink-eventbus": "2.1.0",
"com.cysharp.unitask": "2.5.10",
"com.unity.modules.jsonserialize": "1.0.0"
},
@@ -22,5 +22,6 @@
"name": "cneicy",
"url": "https://git.crash.work/ShrinkSDK"
},
"documentationUrl": "https://git.crash.work/ShrinkSDK/ShrinkContext.AppAdapter"
"documentationUrl": "https://git.crash.work/ShrinkSDK/ShrinkContext.AppAdapter",
"changelogUrl": "https://git.crash.work/ShrinkSDK/ShrinkContext.AppAdapter/src/branch/main/CHANGELOG.md"
}