Skip to content

Commit 8ee797a

Browse files
authored
Add FAQ for obscure SDK missing error message
Issue #648 did not state the exact error that occurred when opening the solution but if the SDK is missing (as described in novotnyllc/MSBuildSdkExtras#190) the solution fails to load. This is an obscure error message that is hard to search for within this repository. The modification adds a simple and prominent FAQ that explains the problem and how to fix it.
1 parent 6d275af commit 8ee797a

File tree

1 file changed

+22
-1
lines changed

1 file changed

+22
-1
lines changed

.github/CONTRIBUTING.md

Lines changed: 22 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2,6 +2,27 @@
22

33
Thanks for wanting to contribute to Caliburn.Micro. Contributions don't need to take the form of code, submitting issues and writing documentation is just as important.
44

5+
## FAQ: I see an error when opening the solution
6+
```error : The expression "[System.IO.Path]::GetDirectoryName('')" cannot be evaluated. The path is not of a legal form.```
7+
8+
This (unhelpfully) seems to be caused by not having the correct .NET Core SDK installed (see https://github.com/novotnyllc/MSBuildSdkExtras/issues/190).
9+
10+
To find the version of the SDK that Caliburn Micro requires go to src/global.json.
11+
12+
e.g.
13+
```
14+
{
15+
"sdk": {
16+
"version": "3.1.300"
17+
},
18+
"msbuild-sdks": {
19+
"MSBuild.Sdk.Extras": "2.0.54"
20+
}
21+
}
22+
```
23+
24+
Once this version listed in the global.json file is installed the solution will open with all the projects loaded. If the correct versions of the SDKs for Android, UAP and Xamarin are not installed there are error messages at build time that contain instructions on how to proceed.
25+
526
## Raising Issues
627

728
Basic support is provided by the community on [Stack Overflow][http://stackoverflow.com/questions/tagged/caliburn.micro] including the core contributors.
@@ -78,4 +99,4 @@ Some things that will increase the chance that your pull request is accepted.
7899

79100
* [Caliburn.Micro documentation](http://caliburnmicro.com/documentation/)
80101
* [General GitHub documentation](http://help.github.com/)
81-
* [Stack Overflow](http://stackoverflow.com/questions/tagged/caliburn.micro)
102+
* [Stack Overflow](http://stackoverflow.com/questions/tagged/caliburn.micro)

0 commit comments

Comments
 (0)