Cross-platform Stride.Launcher by Kryptos-FR · Pull Request #3027 · stride3d/stride

Kryptos-FR · 2025-12-30T16:01:48Z

PR Details

New Launcher using Avalonia instead of WPF. Still needs some love.

Related Issue

#1503

Types of changes

Docs change / refactoring / dependency upgrade
Bug fix (non-breaking change which fixes an issue)
New feature (non-breaking change which adds functionality)
Breaking change (fix or feature that would cause existing functionality to change)

Checklist

My change requires a change to the documentation.
I have added tests to cover my changes.
All new and existing tests passed.
I have built and run the editor to try this change out.

Jklawreszuk · 2026-01-05T21:15:23Z

+    /// Returns path of Launcher (we can't use Assembly.GetEntryAssembly().Location in .NET Core, especially with self-publish).
+    /// </summary>
+    /// <returns></returns>
+    internal static string? GetExecutablePath() => Environment.ProcessPath;


nitpick: Could this property not be used directly?

I think I just replaced code from the previous implementation to make it cross-platform without changing the overall structure. We could inline it manually.

On the other hand, the method name is a bit more explicit. It's likely inlined anyway by the compiler, so it's just a matter of preference.

Jklawreszuk · 2026-01-05T21:34:24Z

+    }
+
+    // Avalonia configuration, don't remove; also used by visual designer.
+    public static AppBuilder BuildAvaloniaApp()


nitpick: This method seems to be unused. It would be great to integrate with RunNewApp somehow

It's used by the Avalonia plugin. It's needed for the designer.

Kryptos-FR · 2026-01-08T13:07:56Z

@Jklawreszuk I have merged back master to this PR's branch.

It's mostly working but it would be nice to also support (un-)installing the Stride packages on Linux even if we can't fully use it there yet.

Did you want to contribute to it? The branch is on this repo, so feel free to push commits if you want.

Jklawreszuk · 2026-01-13T15:56:19Z

I am sorry, but it took some time to review all the files.Overall, it looks great! A quite accurate implementation of the original Launcher. However, I have a few comments:

~~The ‘See release notes’ feature does not work - also an empty button is displayed. A hint that might be helpful - MarkdownScrollViewer.Markdown property is always null.~~
It would be nice to implement a custom title bar like in the original, but this can be done in a separate PR.

Other than that I didnt notice nothing unusual 😅

Jklawreszuk · 2026-01-13T16:02:51Z

@Kryptos-FR Once the changes have been merged, I will try to adapt Launcher to Linux if necessary. But I think that installing/uninstalling packages works correctly, no?

Kryptos-FR · 2026-01-13T18:02:02Z

I don't remember if it does work. I assume since it's restoring packages it should.

I guess we'll know soon.

Use MarkView.Avalonia library for markdown

Jklawreszuk · 2026-04-24T22:46:31Z

@Kryptos-FR Have you tested it on Windows? It seems to work fine on Linux. They only issue I see is the empty button in the release notes page

Complete the launcher README with build, versioning and layout notes, and add a hub-and-spoke documentation set under docs/launcher/ covering architecture, view models, views, version management, self-update, settings, localization, packaging, lifecycle and cross-platform notes.

Captures the full delta between the current Avalonia branch and the WPF launcher on master — including silent regressions that are not marked with TODO/FIXME — and a phased roadmap to close the gap for cross-platform parity. Notes Stride.Metrics and PrivacyPolicyHelper as deliberate, permanent removals.

…ncher port roadmap Adds a test-infrastructure phase covering bootstrap of Stride.Launcher.Tests, view-model and Avalonia-headless integration tests, and CI wiring for both Windows and Linux.

…n flow

…Handle

…rmation dialog

…rsistence proposal

…Settings

…ct rows

Kryptos-FR · 2026-04-25T05:40:36Z

@Jklawreszuk I have also tested on Linux. I fixed a few minors issues, though the phantom button remains. There are now a few docmentation files about the launcher. If you can review them, that would be nice. One of the document is a tracker for this current porting effort and will be removed once all tasks are completed.

Kryptos-FR · 2026-04-25T05:42:39Z

      - name: Build
        run: |
          dotnet build build\Stride.Launcher.sln `
+            -m:1 -nr:false `


note: remove this since default in now parallel builds on master (#3133).

… versioning scheme

…wn ViewModelBase Copies the ViewModelBase implementation from Stride.Core.Presentation (minus IDestroyable/IViewModelServiceProvider) so the runner has no external MVVM dependency. Renames SetProperty → SetValue to match Stride's API.

Kryptos-FR requested a review from Jklawreszuk December 30, 2025 16:01

Kryptos-FR added the area-Launcher Stride Launcher label Dec 30, 2025

Kryptos-FR mentioned this pull request Dec 30, 2025

Make Stride.Launcher crossplatform #1503

Open

Kryptos-FR force-pushed the feature/launcher-avalonia-cherrypick branch 3 times, most recently from 7b72320 to 03f94a4 Compare December 30, 2025 18:49

Jklawreszuk reviewed Jan 5, 2026

View reviewed changes

Kryptos-FR force-pushed the feature/launcher-avalonia-cherrypick branch from 03f94a4 to e96d938 Compare January 7, 2026 20:45

Kryptos-FR force-pushed the feature/launcher-avalonia-cherrypick branch from e96d938 to e161999 Compare April 7, 2026 20:55

xen2 force-pushed the master branch 2 times, most recently from ab329f3 to 482bd28 Compare April 16, 2026 07:56

Kryptos-FR and others added 4 commits April 21, 2026 13:10

Cherry-pick Launcher from xplat-editor branch

72c363e

Update packages

2c247ce

Cherry-pick minimum changes to presentation libraries

9631523

Upgrade to Avalonia 12

4950387

Use MarkView.Avalonia library for markdown

Kryptos-FR force-pushed the feature/launcher-avalonia-cherrypick branch from e161999 to 4950387 Compare April 21, 2026 15:19

Kryptos-FR marked this pull request as ready for review April 21, 2026 15:20

ci: fix potential parallel build issue for the launcher job

726e083

Kryptos-FR and others added 6 commits April 25, 2026 07:31

docs: add Phase 5 (test infrastructure with Avalonia headless) to lau…

a9b7c5b

…ncher port roadmap Adds a test-infrastructure phase covering bootstrap of Stride.Launcher.Tests, view-model and Avalonia-headless integration tests, and CI wiring for both Windows and Linux.

feat(launcher): add close-confirmation localized strings

1f29517

feat(launcher): persist tab selection immediately on change

3a51352

feat(launcher): add MainViewModel.TryCloseAsync for close-confirmatio…

dd54dc9

…n flow

Kryptos-FR added 10 commits April 25, 2026 07:37

feat(launcher): restore close-confirmation prompt on main window

cc902fa

feat(launcher): capture Win32 HWND on main window for /LauncherWindow…

0a959a6

…Handle

docs(launcher): reflect restored window-lifecycle parity

6595f65

fix(launcher): bind Escape key to 'Keep launcher open' in close-confi…

b2ea7d7

…rmation dialog

docs(launcher): add 'beyond parity' section with alternate-version pe…

c737d51

…rsistence proposal

feat(launcher): add file-backed CompletedTasks storage API

677f0a2

refactor(launcher): route HasDoneTask/SaveTaskAsDone through Launcher…

8b8a8f0

…Settings

feat(launcher): cross-platform 'Show in Explorer' for recent projects

c2555d0

docs(launcher): reflect cross-platform services parity

eb4c2b6

docs(launcher): log Linux right-click hit-test offset on recent-proje…

73d9945

…ct rows

Kryptos-FR force-pushed the feature/launcher-avalonia-cherrypick branch from 309b8af to 73d9945 Compare April 25, 2026 05:38

Kryptos-FR commented Apr 25, 2026

View reviewed changes

Kryptos-FR added 2 commits April 27, 2026 09:55

fix: Avalonia.Controls.DataGrid doesn't necessarily follow Avalonia's…

3c7da25

… versioning scheme

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

Cross-platform Stride.Launcher#3027

Cross-platform Stride.Launcher#3027
Kryptos-FR wants to merge 23 commits intomasterfrom
feature/launcher-avalonia-cherrypick

Kryptos-FR commented Dec 30, 2025 •

edited

Loading

Uh oh!

Jklawreszuk Jan 5, 2026

Uh oh!

Kryptos-FR Jan 5, 2026 •

edited

Loading

Uh oh!

Jklawreszuk Jan 5, 2026

Uh oh!

Kryptos-FR Jan 5, 2026

Uh oh!

Kryptos-FR commented Jan 8, 2026 •

edited

Loading

Uh oh!

Jklawreszuk commented Jan 13, 2026 •

edited

Loading

Uh oh!

Jklawreszuk commented Jan 13, 2026

Uh oh!

Kryptos-FR commented Jan 13, 2026

Uh oh!

Jklawreszuk commented Apr 24, 2026

Uh oh!

Kryptos-FR commented Apr 25, 2026

Uh oh!

Kryptos-FR Apr 25, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

Uh oh!

Conversation

Kryptos-FR commented Dec 30, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

PR Details

Related Issue

Types of changes

Checklist

Uh oh!

Jklawreszuk Jan 5, 2026

Choose a reason for hiding this comment

Uh oh!

Kryptos-FR Jan 5, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Jklawreszuk Jan 5, 2026

Choose a reason for hiding this comment

Uh oh!

Kryptos-FR Jan 5, 2026

Choose a reason for hiding this comment

Uh oh!

Kryptos-FR commented Jan 8, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

Jklawreszuk commented Jan 13, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

Jklawreszuk commented Jan 13, 2026

Uh oh!

Kryptos-FR commented Jan 13, 2026

Uh oh!

Jklawreszuk commented Apr 24, 2026

Uh oh!

Kryptos-FR commented Apr 25, 2026

Uh oh!

Kryptos-FR Apr 25, 2026

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

Kryptos-FR commented Dec 30, 2025 •

edited

Loading

Kryptos-FR Jan 5, 2026 •

edited

Loading

Kryptos-FR commented Jan 8, 2026 •

edited

Loading

Jklawreszuk commented Jan 13, 2026 •

edited

Loading