|
| 1 | +--- |
| 2 | +id: setup-windows |
| 3 | +title: "Setup for Windows" |
| 4 | +sidebar_label: Setup for Windows |
| 5 | +--- |
| 6 | + |
| 7 | +This setup is only needed for development. Consumers of Tauri apps will not have to do any of this. |
| 8 | + |
| 9 | +## Dependencies |
| 10 | +Tauri is a polyglot system, and as such requires a good deal of tooling. |
| 11 | + |
| 12 | +### System dependencies: |
| 13 | + |
| 14 | +First you should [download](https://aka.ms/buildtools) and install Visual Studio MSBuild Tools and C++ build tools. |
| 15 | + |
| 16 | +> This is a big download (over 1GB) and takes the most time, so go grab a :coffee: |
| 17 | +
|
| 18 | + |
| 19 | +Next download the latest [nvm-windows](https://github.com/coreybutler/nvm-windows/releases) and install it for advanced nodejs version management. |
| 20 | + |
| 21 | +Then run the following from an Administrative PowerShell and press Y when prompted: |
| 22 | +```powershell |
| 23 | +# BE SURE YOU ARE IN AN ADMINISTRATIVE PowerShell! |
| 24 | +nvm install 12.16.0 |
| 25 | +nvm use 12.16.0 |
| 26 | +Set-ExecutionPolicy Bypass -Scope Process -Force; iwr -useb get.scoop.sh | iex |
| 27 | +scoop install yarn |
| 28 | +``` |
| 29 | +This will install the most recent version of nodejs* with nvm, scoop, and yarn. |
| 30 | +> * Most recent nodejs as of this post Here you can find help for: [scoop](https://scoop.sh/), [nvm](https://github.com/coreybutler/nvm-windows), [yarn](https://yarnpkg.com/) |
| 31 | +
|
| 32 | +##### Optional if you need npm |
| 33 | +> 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: |
| 34 | +```powershell |
| 35 | +# DO NOT EXECUTE FROM ADMINISTRATIVE PowerShell! |
| 36 | +yarn global add npm |
| 37 | +``` |
| 38 | + |
| 39 | +### Rustc and Cargo package manager |
| 40 | +If you are running Windows 64-bit, download and run [rustup‑init.exe](https://win.rustup.rs/x86_64) and then follow the onscreen instructions. |
| 41 | + |
| 42 | +If you are running Windows 32-bit, download and run [rustup‑init.exe](https://win.rustup.rs/i686) and then follow the onscreen instructions. |
| 43 | + |
| 44 | +``` |
| 45 | +$ rustup update stable |
| 46 | +$ rustup override set 1.40.0 |
| 47 | +``` |
| 48 | + |
| 49 | +### Enable loopback |
| 50 | +Microsoft disables the loopback interface - you need to whitelist it if you intend to use the dev-server: |
| 51 | + |
| 52 | +Open an administrative console and enter: |
| 53 | +``` |
| 54 | +CheckNetIsolation.exe LoopbackExempt -a -n="Microsoft.Win32WebViewHost_cw5n1h2txyewy" |
| 55 | +``` |
| 56 | +> There are reports that you have to restart your computer after running this command, so if it isn't working for you, try that! |
| 57 | +
|
| 58 | +### Devtools |
| 59 | +Next if you want to debug the front-end you will have to download [Microsoft Edge Devtools](https://www.microsoft.com/store/p/microsoft-edge-devtools-preview/9mzbfrmz0mnj) from the Microsoft store. |
| 60 | + |
| 61 | +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](https://docs.microsoft.com/en-us/microsoft-edge/devtools-guide). |
| 62 | + |
| 63 | + |
| 64 | +## Tauri bundler |
| 65 | +After you have installed Rust and the build toolchain it is wise to open a new shell before continuing. |
| 66 | + |
| 67 | +Setup the bundler: |
| 68 | + |
| 69 | +``` |
| 70 | +$ cargo install tauri-bundler --force |
| 71 | +``` |
0 commit comments