tauri/docs/usage/development/integration.md
nothingismagick 463fd00d06
fix(csp): add wss and tauri to conf template (#1974)
* fix(csp): add wss and tauri to conf template

* add change file, update examples/docs

Co-authored-by: Lucas Nogueira <lucas@tauri.studio>
2021-06-15 13:37:24 -03:00

3.2 KiB

title sidebar_label
Tauri Integration Tauri Integration (1/4)

import Alert from '@theme/Alert' import Command from '@theme/Command' import Link from '@docusaurus/Link'

You must have completed all the steps required for setting up the development environment on your machine. If you haven't done this yet, please see the setup page for your operating system.

1. Install Tauri CLI Package as a Dev Dependency:

cd project-folder

# Not required if you already have a package.json:
# yarn init
# OR
# npm init

yarn add -D @tauri-apps/cli
# OR
npm install -D @tauri-apps/cli
You can install Tauri as both a local and a global dependency, but we recommend installing it locally.

If you decide to use Tauri as a local package with npm (not yarn), you will have to define a custom script to your package.json:

{
  // This content is just a sample
  "scripts": {
    "tauri": "tauri"
  }
}

2. Initialize Tauri in Your App

This command will place a new folder in your current working directory, src-tauri.

└── src-tauri
    ├── .gitignore
    ├── Cargo.toml
    ├── rustfmt.toml
    ├── tauri.conf.json
    ├── icons
    │   ├── 128x128.png
    │   ├── 128x128@2x.png
    │   ├── 32x32.png
    │   ├── Square107x107Logo.png
    │   ├── Square142x142Logo.png
    │   ├── Square150x150Logo.png
    │   ├── Square284x284Logo.png
    │   ├── Square30x30Logo.png
    │   ├── Square310x310Logo.png
    │   ├── Square44x44Logo.png
    │   ├── Square71x71Logo.png
    │   ├── Square89x89Logo.png
    │   ├── StoreLogo.png
    │   ├── icon.icns
    │   ├── icon.ico
    │   └── icon.png
    └── src
        ├── build.rs
        ├── cmd.rs
        └── main.rs

3. Check tauri info to Make Sure Everything Is Set up Properly:

Which should return something like:

Operating System - Darwin(16.7.0) - darwin/x64

Node.js environment
  Node.js - 12.16.3
  @tauri-apps/cli - 1.0.0-beta.2
  @tauri-apps/api - 1.0.0-beta.1

Global packages
  npm - 6.14.4
  yarn - 1.22.4

Rust environment
  rustc - 1.52.1
  cargo - 1.52.0

App directory structure
/node_modules
/src-tauri
/src
/public

App
  tauri.rs - 1.0.0-beta.1
  build-type - bundle
  CSP - default-src blob: data: filesystem: ws: wss: http: https: tauri: 'unsafe-eval' 'unsafe-inline' 'self' img-src: 'self'
  distDir - ../public
  devPath - ../public
  framework - Svelte
  bundler - Rollup

This information can be very helpful when triaging problems.

Patterns

We've also defined prebuilt configurations called "Patterns". They may help you to customize Tauri to fit your needs. See more about patterns.

Vue CLI Plugin Tauri

If you are using Vue CLI, it is recommended to use the official CLI plugin.