未验证 提交 d0680029 编写于 作者: J Julien Couvreur 提交者: GitHub

Add notes for deploying roslyn from command-line (#42983)

上级 d6017624
......@@ -63,6 +63,8 @@ give it a try.
## Trying Your Changes in Visual Studio
### Deploying with F5
The Rosyln solution is designed to support easy debugging via F5. Several of our
projects produce VSIX which deploy into Visual Studio during build. The F5 operation
will start a new Visual Studio instance using those VSIX which override our installed
......@@ -111,6 +113,8 @@ default, a separate instance than the standard "Experimental Instance" used by
other Visual Studio SDK projects. If you're familiar with the idea of Visual
Studio hives, we deploy into the RoslynDev root suffix.
### Deploying with VSIX
If you want to try your extension in your day-to-day use of Visual Studio, you
can find the extensions you built in your Binaries folder with the .vsix
extension. You can double-click the extension to install it into your main
......@@ -120,12 +124,31 @@ Updates to indicate you're running your experimental version. You can uninstall
your version and go back to the originally installed version by choosing your
version and clicking Uninstall.
### Deploying with command-line
You can build and deploy with the following command:
`.\Build.cmd -Configuration Release -deployExtensions -launch`.
Then you can launch the `RoslynDev` hive with `devenv /rootSuffix RoslynDev`.
### Referencing bootstrap compiler
If you made changes to a Roslyn compiler and want to build any projects with it, you can either
use the Visual Studio hive where your **CompilerExtension** is installed, or from
command line, run msbuild with `/p:BootstrapBuildPath=YourBootstrapBuildPath`.
`YourBootstrapBuildPath` could be any directory on your machine so long as it had
csc and vbc inside it. You can check the cibuild.cmd and see how it is used.
### Troubleshooting your setup
To confirm what version of the compiler is being used, include `#error version` in your program
and the compiler will produce a diagnostic including its own version as well as the language
version it is operating under.
You can also attach a debugger to Visual Studio and check the loaded modules, looking at the folder
where the various `CodeAnalysis` modules were loaded from (the `RoslynDev` should load them somewhere
under `AppData`, not from `Program File`).
## Contributing
Please see [Contributing Code](https://github.com/dotnet/roslyn/blob/master/CONTRIBUTING.md) for details on contributing changes back to the code.
Markdown is supported
0% .
You are about to add 0 people to the discussion. Proceed with caution.
先完成此消息的编辑!
想要评论请 注册