Merge pull request #1393 from PowerShell/jianyunt/docs

Updated the linux build doc
This commit is contained in:
Jianyun
2016-07-18 11:59:02 -07:00
committed by GitHub
+10 -6
View File
@@ -15,11 +15,12 @@ Git Setup
---------
Using Git requires it to be setup correctly; refer to the
[Working With the PowerShell Repository](../git/powershell-repository-101.md),
[README](../../README.md) and
[Contributing Guidelines](../../.github/CONTRIBUTING.md).
This guide assumes that you have recursively cloned the PowerShell
repository and `cd`ed into it.
**This guide assumes that you have recursively cloned the PowerShell
repository and `cd`ed into it.**
Toolchain Setup
---------------
@@ -28,7 +29,7 @@ We use the [.NET Command Line Interface][dotnet-cli] (`dotnet`) to
build the managed components, and [CMake][] to build the native
components. Install the following packages for the toolchain:
- `dotnet`: Must be installed from the `Start-PSBootstrap` module as described below.
- `dotnet`: Must be installed from the `Start-PSBootstrap` module as described below.
- `cmake`
- `make`
- `g++`
@@ -55,13 +56,15 @@ The `./tools/download.sh` script will also install the PowerShell package.
In Bash:
```sh
GITHUB_TOKEN=<replace with your token> ./tools/download.sh
GITHUB_TOKEN=<replace with your token>
./tools/download.sh
powershell
```
You should now be in a `powershell` console host that is installed
separately from any development copy you're about to build. Just
import our module, bootsrap the dependencies, and build!
import our module, bootstrap the dependencies, and build!
In PowerShell:
@@ -115,11 +118,12 @@ toolchain setup section above, you should have `powershell` installed.
Import-Module ./build.psm1
Start-PSBuild
```
Congratulations! If everything went right, PowerShell is now built.
The `Start-PSBuild` script will output the location of the executable:
`./src/powershell/bin/Linux/netcoreapp1.0/ubuntu.14.04-x64/powershell`.
You should now be running the `powershell` that is what you just built if your run the above executable.
You can run our cross-platform Pester tests with `Start-PSPester`, and
our xUnit tests with `Start-PSxUnit`.