12

04. MS Windows Setup

nothingismagick edited this page 2020-05-08 20:13:49 +02:00

Table of Contents

• MS Windows Setup
• Dependencies
• System dependencies:
• Optional if you need npm
• Rustc and Cargo package manager
• Enable loopback
• Devtools
• Tauri bundler
• Next Step:

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

MS Windows Setup

This setup is only needed for development. Consumers of Tauri apps will not have to do any of this.

Dependencies

Tauri is a polyglot system, and as such requires a good deal of tooling.

System dependencies:

First you should download and install Visual Studio MSBuild Tools and C++ build tools.

This is a big download (over 1GB) and takes the most time, so go grab a ☕

Be sure you don't have the 2017 version of the build tools installed as well. There are reports of tauri build not working in such a configuration.

Next download the latest nvm-windows and install it for advanced nodejs version management.

Then run the following from an Administrative PowerShell and press Y when prompted:

# BE SURE YOU ARE IN AN ADMINISTRATIVE PowerShell!
nvm install 12.16.0
nvm use 12.16.0
Set-ExecutionPolicy Bypass -Scope Process -Force; iwr -useb get.scoop.sh | iex
scoop install yarn

This will install the most recent version of nodejs* with nvm, scoop, and yarn.

• Most recent nodejs as of this post Here you can find help for: scoop, nvm, yarn

Optional if you need npm

Following the steps above will leave you without a functioning npm installation unless running an administrative shell. If you need npm, you can simply execute the following command:

# DO NOT EXECUTE FROM ADMINISTRATIVE PowerShell!
yarn global add npm

Rustc and Cargo package manager

If you are running Windows 64-bit, download and run rustup‑init.exe and then follow the onscreen instructions.

If you are running Windows 32-bit, download and run rustup‑init.exe and then follow the onscreen instructions.

$ rustup update stable
$ rustup override set 1.40.0

Enable loopback

Microsoft disables the loopback interface - you need to whitelist it if you intend to use the dev-server:

Open an administrative console and enter:

CheckNetIsolation.exe LoopbackExempt -a -n="Microsoft.Win32WebViewHost_cw5n1h2txyewy"

There are reports that you have to restart your computer after running this command, so if it isn't working for you, try that!

Devtools

Next if you want to debug the front-end you will have to download Microsoft Edge Devtools from the Microsoft store.

This will allow you to attach to a running instance of you're Tauri project! If you need help take a look at the devtools-guide.

Tauri bundler

After you have installed Rust and the build toolchain it is wise to open a new shell before continuing.

Setup the bundler:

$ cargo install tauri-bundler --force

Next Step:

Tauri Integration