mirror of
https://github.com/aphrody-labs/PowerShell.git
synced 2026-10-17 04:36:39 +00:00
fix Markdown formatting to follow one-sentence-per-line in windows-full.md (#2081)
This commit is contained in:
1 parent
1e13d7897a
commit
65988ac2c0
1 file changed
+14
-21
@@ -1,32 +1,27 @@
|
||||
Build PowerShell on Windows for .NET Full
|
||||
=========================================
|
||||
|
||||
This guide supplements the
|
||||
[Windows .NET Core instructions](./windows-core.md), as building the
|
||||
.NET 4.5.1 (desktop) version is pretty similar.
|
||||
This guide supplements the [Windows .NET Core instructions](./windows-core.md),
|
||||
as building the .NET 4.5.1 (desktop) version is pretty similar.
|
||||
|
||||
Environment
|
||||
===========
|
||||
|
||||
In addition to the dependencies specified in the .NET Core
|
||||
instructions, you'll need to:
|
||||
In addition to the dependencies specified in the .NET Core instructions, you'll need to:
|
||||
|
||||
Install the Visual C++ Compiler via Visual Studio 2015.
|
||||
-------------------------------------------------------
|
||||
|
||||
This component is required to compile the native `powershell.exe` host.
|
||||
|
||||
This is an optionally installed component, so you may need to run the
|
||||
Visual Studio installer again.
|
||||
This is an optionally installed component, so you may need to run the Visual Studio installer again.
|
||||
|
||||
If you don't have any Visual Studio installed, you can use
|
||||
[Visual Studio 2015 Community Edition][vs].
|
||||
If you don't have any Visual Studio installed, you can use [Visual Studio 2015 Community Edition][vs].
|
||||
|
||||
> Compiling with older versions should work, but we don't test it.
|
||||
|
||||
**Troubleshooting note:** If `cmake` says that it cannot determine the
|
||||
`C` and `CXX` compilers, you either don't have Visual Studio, or you
|
||||
don't have the Visual C++ Compiler component installed.
|
||||
**Troubleshooting note:** If `cmake` says that it cannot determine the `C` and `CXX` compilers,
|
||||
you either don't have Visual Studio, or you don't have the Visual C++ Compiler component installed.
|
||||
|
||||
[vs]: https://www.visualstudio.com/en-us/products/visual-studio-community-vs.aspx
|
||||
|
||||
@@ -45,8 +40,7 @@ choco install cmake.portable
|
||||
Build using our module
|
||||
======================
|
||||
|
||||
Use `Start-PSBuild -FullCLR` from the `build.psm1`
|
||||
module.
|
||||
Use `Start-PSBuild -FullCLR` from the `build.psm1` module.
|
||||
|
||||
The output location of `powershell.exe` will be
|
||||
|
||||
@@ -60,15 +54,15 @@ Build manually
|
||||
The build contains the following steps:
|
||||
|
||||
- generating Visual Studio project: `cmake`
|
||||
- building `powershell.exe` from generated solution: `msbuild
|
||||
powershell.sln`
|
||||
- building `powershell.exe` from generated solution: `msbuild powershell.sln`
|
||||
- building managed DLLs: `dotnet publish --runtime net451`
|
||||
|
||||
|
||||
What can you do with the produced binaries?
|
||||
=========================================
|
||||
|
||||
**Important**: "We don’t support production deployments of these binaries on any platform". For PowerShell .NET (aka: FullCLR PowerShell) our recommendation is to continue using the PowerShell .NET version already shipping in Windows Client and Windows Server.
|
||||
**Important**: "We don’t support production deployments of these binaries on any platform".
|
||||
For PowerShell .NET (aka: FullCLR PowerShell) our recommendation is to continue using the PowerShell .NET version already shipping in Windows Client and Windows Server.
|
||||
|
||||
The primary reason to build the PowerShell FullCLR binaries is to test backward compatibility, and interoperability between .NET and CoreCLR.
|
||||
It is also important to mention that some features like PowerShell Workflows are not currently available in the CoreCLR version.
|
||||
@@ -82,10 +76,9 @@ Running Dev version of FullCLR PowerShell
|
||||
|
||||
Running FullCLR version is not as simple as CoreCLR version.
|
||||
|
||||
If you just run `./powershell.exe`, you will get a `powershell`
|
||||
process, but all the interesting DLLs (such as
|
||||
`System.Management.Automation.dll`) would be loaded from the Global
|
||||
Assembly Cache (GAC), not your output directory.
|
||||
If you just run `./powershell.exe`, you will get a `powershell` process,
|
||||
but all the interesting DLLs (such as `System.Management.Automation.dll`) would be loaded from the Global Assembly Cache (GAC),
|
||||
not your output directory.
|
||||
|
||||
Use `Start-DevPowerShell` helper function to workaround it with `$env:DEVPATH`
|
||||
|
||||
|
||||
Reference in new issue
Block a user