Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Add FAQ for obscure SDK missing error message #712

Merged
merged 1 commit into from
Jul 10, 2020
+22 −1
Merged

Add FAQ for obscure SDK missing error message #712

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
23 changes: 22 additions & 1 deletion .github/CONTRIBUTING.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -2,6 +2,27 @@

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.

## FAQ: I see an error when opening the solution
```error : The expression "[System.IO.Path]::GetDirectoryName('')" cannot be evaluated. The path is not of a legal form.```

This (unhelpfully) seems to be caused by not having the correct .NET Core SDK installed (see https://github.com/novotnyllc/MSBuildSdkExtras/issues/190).

To find the version of the SDK that Caliburn Micro requires go to src/global.json.

e.g.
```
{
"sdk": {
"version": "3.1.300"
},
"msbuild-sdks": {
"MSBuild.Sdk.Extras": "2.0.54"
}
}
```

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.

## Raising Issues

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

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