feat(linux): add graphical platform services

2026-07-27 11:54:59 +02:00 · 2026-07-27 11:54:59 +02:00 · 66f114b258
commit 66f114b258
parent 1628d9f587
28 changed files with 1328 additions and 155 deletions
--- a/tests/AcDream.Runtime.Tests/Platform/ApplicationPathSetTests.cs
+++ b/tests/AcDream.Runtime.Tests/Platform/ApplicationPathSetTests.cs
@ -0,0 +1,162 @@
+using AcDream.Runtime.Platform;
+
+namespace AcDream.Runtime.Tests.Platform;
+
+public sealed class ApplicationPathSetTests
+{
+    [Fact]
+    public void LinuxUsesXdgRootsAndPublishesFeaturePaths()
+    {
+        string root = Path.GetFullPath(
+            Path.Combine(Path.GetTempPath(), "acdream-runtime-xdg"));
+        var platform = new FixtureEnvironment(isWindows: false)
+        {
+            CurrentDirectoryValue = Path.Combine(root, "work"),
+            UserProfile = Path.Combine(root, "home"),
+            Variables =
+            {
+                ["XDG_CONFIG_HOME"] = Path.Combine(root, "cfg"),
+                ["XDG_DATA_HOME"] = Path.Combine(root, "data"),
+                ["XDG_CACHE_HOME"] = Path.Combine(root, "cache"),
+            },
+        };
+
+        ApplicationPathSet paths = ApplicationPathSet.Resolve(
+            platform: platform);
+
+        Assert.Equal(
+            Path.Combine(root, "cfg", "acdream"),
+            paths.ConfigDirectory);
+        Assert.Equal(
+            Path.Combine(root, "data", "acdream"),
+            paths.DataDirectory);
+        Assert.Equal(
+            Path.Combine(root, "cache", "acdream"),
+            paths.CacheDirectory);
+        Assert.Equal(
+            Path.Combine(paths.ConfigDirectory, "settings.json"),
+            paths.SettingsFile);
+        Assert.Equal(
+            Path.Combine(paths.ConfigDirectory, "keybinds.json"),
+            paths.KeyBindingsFile);
+        Assert.Equal(
+            Path.Combine(paths.DataDirectory, "plugins"),
+            paths.PluginsDirectory);
+        Assert.Equal(
+            Path.Combine(paths.CacheDirectory, "diagnostics"),
+            paths.DiagnosticsDirectory);
+        Assert.Null(paths.LegacyConfigDirectory);
+    }
+
+    [Fact]
+    public void LinuxFallsBackToHomeAndNormalizesOverrides()
+    {
+        string root = Path.GetFullPath(
+            Path.Combine(Path.GetTempPath(), "acdream runtime paths"));
+        var platform = new FixtureEnvironment(isWindows: false)
+        {
+            CurrentDirectoryValue = Path.Combine(root, "work"),
+            UserProfile = Path.Combine(root, "home"),
+        };
+
+        ApplicationPathSet paths = ApplicationPathSet.Resolve(
+            "relative config",
+            "dåta",
+            "cache",
+            platform);
+
+        Assert.Equal(
+            Path.GetFullPath(
+                "relative config",
+                platform.CurrentDirectoryValue),
+            paths.ConfigDirectory);
+        Assert.Equal(
+            Path.GetFullPath("dåta", platform.CurrentDirectoryValue),
+            paths.DataDirectory);
+        Assert.Equal(
+            Path.GetFullPath("cache", platform.CurrentDirectoryValue),
+            paths.CacheDirectory);
+    }
+
+    [Fact]
+    public void WindowsUsesRoamingConfigAndLocalData()
+    {
+        string root = Path.GetFullPath(
+            Path.Combine(Path.GetTempPath(), "acdream-runtime-windows"));
+        var platform = new FixtureEnvironment(isWindows: true)
+        {
+            CurrentDirectoryValue = Path.Combine(root, "work"),
+            ApplicationData = Path.Combine(root, "AppData", "Roaming"),
+            LocalApplicationData =
+                Path.Combine(root, "AppData", "Local"),
+        };
+
+        ApplicationPathSet paths = ApplicationPathSet.Resolve(
+            platform: platform);
+
+        Assert.Equal(
+            Path.Combine(
+                platform.ApplicationData,
+                "acdream"),
+            paths.ConfigDirectory);
+        Assert.Equal(
+            Path.Combine(
+                platform.LocalApplicationData,
+                "acdream"),
+            paths.DataDirectory);
+        Assert.Equal(
+            Path.Combine(
+                platform.LocalApplicationData,
+                "acdream",
+                "cache"),
+            paths.CacheDirectory);
+        Assert.Equal(
+            Path.Combine(
+                platform.LocalApplicationData,
+                "acdream"),
+            paths.LegacyConfigDirectory);
+    }
+
+    private sealed class FixtureEnvironment(bool isWindows)
+        : IApplicationPathEnvironment
+    {
+        public bool IsWindows { get; } = isWindows;
+
+        public string CurrentDirectoryValue { get; init; } =
+            Environment.CurrentDirectory;
+
+        public string CurrentDirectory => CurrentDirectoryValue;
+
+        public string UserProfile { get; init; } =
+            Environment.GetFolderPath(
+                Environment.SpecialFolder.UserProfile);
+
+        public string ApplicationData { get; init; } =
+            Environment.GetFolderPath(
+                Environment.SpecialFolder.ApplicationData);
+
+        public string LocalApplicationData { get; init; } =
+            Environment.GetFolderPath(
+                Environment.SpecialFolder.LocalApplicationData);
+
+        public Dictionary<string, string> Variables { get; } =
+            new(StringComparer.Ordinal);
+
+        public string? GetEnvironmentVariable(string name) =>
+            Variables.TryGetValue(name, out string? value)
+                ? value
+                : null;
+
+        public string GetFolderPath(
+            Environment.SpecialFolder folder) =>
+            folder switch
+            {
+                Environment.SpecialFolder.UserProfile => UserProfile,
+                Environment.SpecialFolder.ApplicationData =>
+                    ApplicationData,
+                Environment.SpecialFolder.LocalApplicationData =>
+                    LocalApplicationData,
+                _ => string.Empty,
+            };
+    }
+}