diff options
| author |  Jan Tattermusch <jtattermusch@users.noreply.github.com> | 2017-06-10 09:21:53 +0200 |
|---|---|---|
| committer |  GitHub <noreply@github.com> | 2017-06-10 09:21:53 +0200 |
| commit | 8b26317f01159b4a818267676f9e87471ecc9e2a (patch) | |
| tree | b1b5ed5b00752dbd69de5a6505901cfd20af0eeb | |
| parent | fcf61267e55b91a4ca708e57e6634e4db4057bb1 (diff) | |
add vsprojects deprecation notice
| -rw-r--r-- | vsprojects/README.md | 10 |
1 files changed, 10 insertions, 0 deletions
diff --git a/vsprojects/README.md b/vsprojects/README.md index 1f0cdc24ba..b389cf88d2 100644 --- a/vsprojects/README.md +++ b/vsprojects/README.md @@ -1,5 +1,15 @@ + + # Pre-generated MS Visual Studio project & solution files +**DEPRECATED, please use cmake instead (it can generate Visual Studio projects for you). We will continue providing pre-generated VS projects for a while, but we will likely get rid of them entirely at some point.** + +**Pre-generated MS Visual Studio projects used to be the recommended way to build on Windows, but there were some limitations:** +- **hard to build dependencies, expecially boringssl (deps usually support cmake quite well)** +- **the nuget-based openssl & zlib dependencies are hard to maintain and update. We've received issues indicating that they are flawed.** +- **.proto codegen is hard to support in Visual Studio directly (but we have a pretty decent support in cmake)** +- **It's a LOT of generated files. We prefer not to have too much generated code in our github repo.** + Versions 2013 and 2015 are both supported. You can use [their respective community editions](https://www.visualstudio.com/en-us/downloads/download-visual-studio-vs.aspx). |