godotengine / godotengine/godot-csharp-visualstudio

Where is the official "how to install" documentation?

Open
#40 1 comment 0 reactions 1 assignee Claimed by @neikeq View on GitHub
enhancement
Dominant language
C#
Stars
276
Forks
27
PR merge metrics
No merged PRs in 30d

Description

See title.

I was directed to this extension by a helpful but somewhat random youtube video I found by searching (FinePointCGI).
https://www.youtube.com/watch?v=lOjOb4Lv_ww

I then also found another seemingly unofficial gist describing the process along with useful comments from people with issue.
https://gist.github.com/31/302bab2630ddf8d90ab4aec0d358b538

Why is this ESSENTIAL information not documented clearly here in the MD doc?

Required steps such the need to manually copy a "magical" csproj contents into the Stub project csproj file is utterly dubious / stupidly brittle. I detest "magical" "don't ask why, just do it" steps as it leaves us without the ability or knowledge to help ourselves. We need to have at least some details on what this csproj is actually doing. Why is it even needed?

Case in point, as of this week the "Play in editor" currently works (starts the app in the Godot editor with debugging) for VS 2019 but not VS2022 (see comments on Gist).

If the information in the above video and Gist are correct, please document those steps clearly here. This is possibly the messiest and somewhat amatuerish install I've had to fight my way through for a long time.

NB: the extension VSIX doesn't even install cleanly first time (fails with a file already exists error). I eventually found another thread here saying to install the Mobile dev tools for .NET first. https://github.com/godotengine/godot-csharp-visualstudio/issues/24
Just painful all round at the moment.

Contributor guide

No contributing guide indexed for this repository

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.