This guide supplements the Linux instructions, as building on OS X is almost identical.
.NET Core (and by transitivity, us) only supports OS X 10.11, per CoreFX issue #7731.
You will want Homebrew, the missing package manager for OS X.
Once installed, follow the same instructions to download and
install a self-hosted copy of PowerShell on your OS X machine,
and useStart-PSBootstrap
to install the dependencies.
The Start-PSBootstrap
function does the following:
- Uses
brew
to install CMake, OpenSSL, and GNU WGet - Links OpenSSL
- Uninstalls any prior versions of .NET CLI
- Downloads and installs the latest .NET CLI 1.0.0-preview2 SDK to
~/.dotnet
If you want to use dotnet
outside of Start-PSBuild
,
add ~/.dotnet
to your PATH
environment variable.
Due to a bug in NuGet, the dotnet restore
command will fail without the limit increased.
Run ulimit -n 2048
to fix this in your session;
add it your shell's profile to fix it permanently.
We cannot do this for you in the build module due to #847.
If you run dotnet restore
and get error like
PS /Users/vors/dev/PowerShell> dotnet restore
log : Restoring packages for /Users/vors/dev/PowerShell/src/TypeCatalogGen/project.json...
log : Restoring packages for /Users/vors/dev/PowerShell/src/TypeCatalogParser/project.json...
log : Restoring packages for /Users/vors/dev/PowerShell/test/PSReadLine/project.json...
log : Restoring packages for /Users/vors/dev/PowerShell/test/csharp/project.json...
error: Unable to load the service index for source http://www.myget.org/F/dotnet-core/api/v3/index.json.
error: The type initializer for 'Crypto' threw an exception.
error: The type initializer for 'CryptoInitializer' threw an exception.
error: Unable to load DLL 'System.Security.Cryptography.Native': The specified module could not be found.
error: (Exception from HRESULT: 0x8007007E)
Try the following
- Make sure you have latest openssl and re-link it
brew update
brew install openssl
brew link --force openssl
Instead of installing the Ubuntu package of PowerShell,
download the pkg
from our GitHub releases page using your browser, complete the wizard,
start a powershell
session, and use Start-PSBuild
from the module.
The output directory will be slightly different because your runtime identifier is different.
PowerShell will be at ./src/powershell-unix/bin/Linux/netcoreapp1.0/osx.10.11-x64/powershell
,
or osx.10.10
depending on your operating system version.
Note that configuration is still Linux
because it would be silly to make yet another separate configuration when it's used solely to work-around a CLI issue.