10 Commits
Author SHA1 Message Date
cneicy 1b638dbad5 chore: exclude .NET metadata from UPM packages
Publish UPM package / publish (push) Successful in 2s
Publish NuGet packages / publish (push) Successful in 38s
2026-09-05 04:07:45 +08:00
cneicy 3d23567dea ci: trust bundled CAs during NuGet publish 2026-09-05 04:05:19 +08:00
cneicy 588a691354 ci: provide OpenSSL for .NET packaging 2026-09-05 04:02:13 +08:00
cneicy 2e850592b9 ci: run .NET packaging in invariant mode 2026-09-05 03:57:54 +08:00
cneicy efece17256 ci: bootstrap .NET SDK without system packages 2026-09-05 03:55:10 +08:00
cneicy 278d9226f6 ci: publish NuGet without external actions 2026-09-05 03:50:11 +08:00
cneicy 8e3abb5e0b ci: install .NET prerequisites for package publishing 2026-09-05 03:45:46 +08:00
cneicy 8898221198 feat: add NuGet and Godot distribution 2026-09-05 03:41:45 +08:00
cneicy 5d66389bd6 feat: add cross-engine runtime support 2026-09-05 02:34:07 +08:00
cneicy 46ed178e0b fix(tutorial): complete click targets from UI events
Publish UPM package / publish (push) Successful in 2s
2026-08-30 21:25:32 +08:00
16 changed files with 474 additions and 2 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
+4
View File
@@ -1,5 +1,9 @@
# Changelog
## 0.1.4
- `ClickTarget` 对 UI Button 和显式 `ShrinkTutorialAnchor` 改为点击事件驱动,不再依赖轮询鼠标按下、抬起的帧时序;非 UI 目标保留原有指针检测。
## 0.1.3
- 修复 `ClickTarget` 在目标按钮点击后立即打开、关闭或替换 UI 时误判未命中的问题;现在按下时确认原目标,松开时按按下时的目标区域完成步骤。
+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: ef223ea65c862734e8d84bd47cc3df97
DefaultImporter:
externalObjects: {}
userData:
assetBundleName:
assetBundleVariant:
+76
View File
@@ -0,0 +1,76 @@
using System;
using System.Collections.Generic;
namespace ShrinkTutorial;
[Serializable]
public sealed class ShrinkTutorialStep
{
public string StepId = string.Empty;
public string Title = string.Empty;
public string Body = string.Empty;
public string Target = string.Empty;
public ShrinkTutorialTargetMode TargetMode;
public ShrinkTutorialCompleteCondition CompleteCondition = ShrinkTutorialCompleteCondition.ClickTarget;
public ShrinkTutorialDialogAnchor DialogAnchor = ShrinkTutorialDialogAnchor.Auto;
public ShrinkTutorialMaskShape MaskShape = ShrinkTutorialMaskShape.Rect;
public string CustomEventName = string.Empty;
public bool BlockInputOutsideTarget = true;
}
[Serializable]
public sealed class ShrinkTutorialData
{
public string TutorialId = string.Empty;
public List<ShrinkTutorialStep> Steps = new();
}
public sealed class ShrinkTutorialRunner
{
private readonly IShrinkTutorialStorage _storage;
private ShrinkTutorialProgress _progress;
public ShrinkTutorialRunner(IShrinkTutorialStorage storage)
{
_storage = storage ?? throw new ArgumentNullException(nameof(storage));
_progress = storage.Load() ?? new ShrinkTutorialProgress();
}
public ShrinkTutorialData Current { get; private set; }
public int StepIndex { get; private set; } = -1;
public ShrinkTutorialStep CurrentStep => Current != null && StepIndex >= 0 && StepIndex < Current.Steps.Count ? Current.Steps[StepIndex] : null;
public event Action<ShrinkTutorialStep> StepChanged;
public event Action<string> Completed;
public bool Start(ShrinkTutorialData tutorial)
{
if (tutorial == null || tutorial.Steps.Count == 0 || _progress.completedTutorials.Contains(tutorial.TutorialId)) return false;
Current = tutorial;
StepIndex = 0;
StepChanged?.Invoke(CurrentStep);
return true;
}
public bool CompleteStep(string customEventName = null)
{
var step = CurrentStep;
if (step == null) return false;
if (step.CompleteCondition == ShrinkTutorialCompleteCondition.CustomEvent &&
!string.Equals(step.CustomEventName, customEventName, StringComparison.Ordinal)) return false;
StepIndex++;
if (StepIndex < Current.Steps.Count) { StepChanged?.Invoke(CurrentStep); return true; }
_progress.completedTutorials.Add(Current.TutorialId);
_storage.Save(_progress);
var id = Current.TutorialId;
Current = null;
StepIndex = -1;
Completed?.Invoke(id);
return true;
}
public void Reset()
{
Current = null;
StepIndex = -1;
_storage.Reset();
_progress = new ShrinkTutorialProgress();
}
}
+19
View File
@@ -0,0 +1,19 @@
<Project Sdk="Microsoft.NET.Sdk">
<PropertyGroup>
<TargetFramework>netstandard2.1</TargetFramework>
<EnableDefaultCompileItems>false</EnableDefaultCompileItems>
<AssemblyName>ShrinkTutorial.Runtime</AssemblyName>
<RootNamespace>ShrinkTutorial</RootNamespace>
<PackageId>ShrinkSDK.Tutorial</PackageId>
<Version>0.2.0</Version>
<Description>Engine-neutral ShrinkSDK tutorial state and step runtime.</Description>
<Nullable>disable</Nullable>
</PropertyGroup>
<ItemGroup>
<Compile Include="Runtime\ShrinkTutorialCore.cs" />
<Compile Include="..\Runtime\Core\ShrinkTutorialEnums.cs" />
<Compile Include="..\Runtime\Core\ShrinkTutorialLocalization.cs" />
<Compile Include="..\Runtime\Storage\IShrinkTutorialStorage.cs" />
<PackageReference Include="ShrinkSDK.Runtime.Abstractions" Version="0.1.0" />
</ItemGroup>
</Project>
+89
View File
@@ -0,0 +1,89 @@
#nullable enable
using Godot;
namespace ShrinkTutorial.Godot;
public partial class ShrinkGodotTutorialOverlay : Control
{
private readonly Label _title = new();
private readonly Label _body = new();
private ShrinkTutorialRunner? _runner;
private Control? _target;
public override void _Ready()
{
SetAnchorsAndOffsetsPreset(LayoutPreset.FullRect);
MouseFilter = MouseFilterEnum.Stop;
var panel = new PanelContainer { CustomMinimumSize = new Vector2(320, 100) };
panel.Position = new Vector2(24, 24);
var text = new VBoxContainer();
text.AddChild(_title);
text.AddChild(_body);
panel.AddChild(text);
AddChild(panel);
}
public void Bind(ShrinkTutorialRunner runner)
{
if (_runner != null) _runner.StepChanged -= ShowStep;
_runner = runner;
_runner.StepChanged += ShowStep;
if (_runner.CurrentStep != null) ShowStep(_runner.CurrentStep);
}
public override void _ExitTree()
{
if (_runner != null) _runner.StepChanged -= ShowStep;
_runner = null;
_target = null;
}
public override void _Process(double delta)
{
if (_runner?.CurrentStep is not { } step) return;
_target = ResolveTarget(step);
QueueRedraw();
}
public override void _Draw()
{
var viewport = GetViewportRect();
if (_target == null)
{
DrawRect(viewport, new Color(0, 0, 0, 0.72f));
return;
}
var hole = _target.GetGlobalRect().Grow(8);
var shade = new Color(0, 0, 0, 0.72f);
DrawRect(new Rect2(viewport.Position, new Vector2(viewport.Size.X, hole.Position.Y)), shade);
DrawRect(new Rect2(new Vector2(0, hole.End.Y), new Vector2(viewport.Size.X, viewport.Size.Y - hole.End.Y)), shade);
DrawRect(new Rect2(new Vector2(0, hole.Position.Y), new Vector2(hole.Position.X, hole.Size.Y)), shade);
DrawRect(new Rect2(new Vector2(hole.End.X, hole.Position.Y), new Vector2(viewport.Size.X - hole.End.X, hole.Size.Y)), shade);
}
public override void _GuiInput(InputEvent @event)
{
if (@event is not InputEventMouseButton { Pressed: true }) return;
var step = _runner?.CurrentStep;
if (step == null) return;
if (step.CompleteCondition == ShrinkTutorialCompleteCondition.AnyClick ||
step.CompleteCondition == ShrinkTutorialCompleteCondition.ClickTarget && _target?.GetGlobalRect().HasPoint(GetGlobalMousePosition()) == true)
_runner!.CompleteStep();
AcceptEvent();
}
private void ShowStep(ShrinkTutorialStep step)
{
_title.Text = step.Title;
_body.Text = step.Body;
Visible = true;
}
private Control? ResolveTarget(ShrinkTutorialStep step)
{
if (step.TargetMode == ShrinkTutorialTargetMode.Path) return GetTree().Root.GetNodeOrNull<Control>(step.Target);
if (step.TargetMode == ShrinkTutorialTargetMode.AnchorId) return GetTree().GetFirstNodeInGroup("shrink_tutorial_" + step.Target) as Control;
return null;
}
}
+15
View File
@@ -0,0 +1,15 @@
<Project Sdk="Microsoft.NET.Sdk">
<PropertyGroup>
<TargetFramework>net8.0</TargetFramework>
<AssemblyName>ShrinkTutorial.Godot</AssemblyName>
<RootNamespace>ShrinkTutorial.Godot</RootNamespace>
<PackageId>ShrinkSDK.Tutorial.Godot</PackageId>
<Version>0.1.0</Version>
<Description>Godot Control overlay and Resources for ShrinkSDK Tutorial.</Description>
<ShrinkCodeGenEnabled>false</ShrinkCodeGenEnabled>
</PropertyGroup>
<ItemGroup>
<PackageReference Include="GodotSharp" Version="4.6.3" />
<ProjectReference Include="..\DotNet~\ShrinkSDK.Tutorial.csproj" />
</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: c0fb75e35db0e10419f6c6afef97db05
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:
+2
View File
@@ -2,6 +2,8 @@
一个面向 Unity 2022.3+ 的互动式引导系统,重点解决这几件事:
共享教程状态与步骤运行时位于 `DotNet~`Godot 4.6 的 `Resource``Control` 遮罩和输入适配位于 `Godot~`。Godot 项目安装 `ShrinkSDK.Tutorial.Godot`
- 通过真实点击完成步骤,而不是纯文案翻页。
- 支持静态路径目标和动态锚点目标。
- 遮罩只屏蔽无关区域,目标区域可继续点击。
+62
View File
@@ -43,6 +43,8 @@ namespace ShrinkTutorial
private ShrinkTutorialMaskShape _clickTargetArmedShape;
private int _clickTargetArmedFrame;
private bool _clickTargetArmedWithTouch;
private Button _clickTargetButton;
private ShrinkTutorialAnchor _clickTargetAnchor;
private float _stepAutoTimer;
private string _receivedCustomEvent = string.Empty;
@@ -214,6 +216,7 @@ namespace ShrinkTutorial
_stepCompleted = false;
_stepCompletionQueued = false;
_clickTargetArmed = false;
UnbindClickTargetEvents();
_stepAutoTimer = tutorial.steps[stepIndex].autoDelay;
_receivedCustomEvent = string.Empty;
@@ -237,6 +240,8 @@ namespace ShrinkTutorial
if (targetTransform)
LogDebug($"Resolved target for step {stepIndex}: {GetTransformPath(targetTransform)}");
BindClickTargetEvents(step, targetTransform);
EmitSignal(step.enterSignal);
_dialog.SetSkipVisible(ResolveSettings().showSkipButton);
@@ -249,6 +254,7 @@ namespace ShrinkTutorial
yield return null;
}
UnbindClickTargetEvents();
EmitSignal(step.exitSignal);
_dialog.Hide();
@@ -364,6 +370,9 @@ namespace ShrinkTutorial
private void TickClickTargetCompletion(ShrinkTutorialStep step, Transform targetTransform)
{
if (_clickTargetButton || _clickTargetAnchor)
return;
if (!_clickTargetArmed &&
targetTransform &&
ShrinkTutorialTargetUtility.TryBuildScreenRect(targetTransform, out var targetRect) &&
@@ -427,6 +436,58 @@ namespace ShrinkTutorial
QueueStepCompletion();
}
private void BindClickTargetEvents(ShrinkTutorialStep step, Transform targetTransform)
{
if (step.completeCondition != ShrinkTutorialCompleteCondition.ClickTarget || !targetTransform)
return;
_clickTargetButton = targetTransform.GetComponent<Button>() ??
targetTransform.GetComponentInParent<Button>() ??
targetTransform.GetComponentInChildren<Button>(true);
if (_clickTargetButton)
{
_clickTargetButton.onClick.AddListener(HandleClickTargetEvent);
LogDebug($"Bound ClickTarget button event: {GetTransformPath(_clickTargetButton.transform)}");
return;
}
_clickTargetAnchor = targetTransform.GetComponent<ShrinkTutorialAnchor>() ??
targetTransform.GetComponentInParent<ShrinkTutorialAnchor>() ??
targetTransform.GetComponentInChildren<ShrinkTutorialAnchor>(true);
if (_clickTargetAnchor)
{
_clickTargetAnchor.Clicked += HandleClickTargetPointerEvent;
LogDebug($"Bound ClickTarget anchor event: {GetTransformPath(_clickTargetAnchor.transform)}");
}
}
private void HandleClickTargetEvent()
{
LogDebug($"ClickTarget button event received, tutorial={_currentTutorial?.tutorialId}, step={_currentStepIndex}");
QueueStepCompletion();
}
private void HandleClickTargetPointerEvent(PointerEventData eventData)
{
if (eventData != null && eventData.button != PointerEventData.InputButton.Left)
return;
LogDebug($"ClickTarget pointer event received, tutorial={_currentTutorial?.tutorialId}, step={_currentStepIndex}");
QueueStepCompletion();
}
private void UnbindClickTargetEvents()
{
if (_clickTargetButton)
_clickTargetButton.onClick.RemoveListener(HandleClickTargetEvent);
if (_clickTargetAnchor)
_clickTargetAnchor.Clicked -= HandleClickTargetPointerEvent;
_clickTargetButton = null;
_clickTargetAnchor = null;
}
private static bool IsPointInsideTarget(Rect targetRect, ShrinkTutorialMaskShape maskShape, Vector2 screenPosition)
{
return maskShape == ShrinkTutorialMaskShape.Circle
@@ -577,6 +638,7 @@ namespace ShrinkTutorial
_runner = null;
_stepCompletionQueued = false;
_clickTargetArmed = false;
UnbindClickTargetEvents();
TryStartQueuedTutorial();
}
+9 -1
View File
@@ -1,12 +1,20 @@
using System;
using UnityEngine;
using UnityEngine.EventSystems;
namespace ShrinkTutorial
{
public class ShrinkTutorialAnchor : MonoBehaviour
public class ShrinkTutorialAnchor : MonoBehaviour, IPointerClickHandler
{
[SerializeField] private string anchorId = string.Empty;
public string AnchorId => anchorId;
public event Action<PointerEventData> Clicked;
public void OnPointerClick(PointerEventData eventData)
{
Clicked?.Invoke(eventData);
}
public void SetAnchorId(string value)
{
+1 -1
View File
@@ -1,6 +1,6 @@
{
"name": "com.cneicy.shrink-tutorial",
"version": "0.1.3",
"version": "0.2.0",
"displayName": "ShrinkTutorial",
"description": "面向 Unity 的互动式新手引导系统,提供数据驱动教程、遮罩挖洞、动态锚点、步骤条件与运行时调度。",
"unity": "2022.3",