必要事項

Tauri でプロジェクトを始めるためには、まずいくつかの依存関係をインストールする必要があります。

1. OS 別依存関係のインストール
2. Rust のインストール
3. モバイル関連の設定 （モバイル・アプリを開発する場合にのみ必要）

OS 別依存関係のインストール

アプリ開発に使用するオペレーティング・システム（OS）により、各々のリンクに従ってください。

• Linux (特定のディストリビューションについては下記を参照)
• macOS Catalina (10.15) 以降
• Windows 7 以降

Linux

Tauri は、Linux 上での開発にさまざまなシステム依存関係を必要とします。システム依存関係はディストリビューションによって異なるかもしれませんが、セットアップの役に立つように、以下にいくつかの一般的なディストリビューションを記載しました。

Debian

sudo apt update
sudo apt install libwebkit2gtk-4.1-dev \
  build-essential \
  curl \
  wget \
  file \
  libxdo-dev \
  libssl-dev \
  libayatana-appindicator3-dev \
  librsvg2-dev

Arch

sudo pacman -Syu
sudo pacman -S --needed \
  webkit2gtk-4.1 \
  base-devel \
  curl \
  wget \
  file \
  openssl \
  appmenu-gtk-module \
  libappindicator-gtk3 \
  librsvg

Fedora

sudo dnf check-update
sudo dnf install webkit2gtk4.1-devel \
  openssl-devel \
  curl \
  wget \
  file \
  libappindicator-gtk3-devel \
  librsvg2-devel
sudo dnf group install "c-development"

Gentoo

sudo emerge --ask \
  net-libs/webkit-gtk:4.1 \
  dev-libs/libappindicator \
  net-misc/curl \
  net-misc/wget \
  sys-apps/file

openSUSE

sudo zypper up
sudo zypper in webkit2gtk3-devel \
  libopenssl-devel \
  curl \
  wget \
  file \
  libappindicator3-1 \
  librsvg-devel
sudo zypper in -t pattern devel_basis

Alpine

sudo apk add \
  build-base \
  webkit2gtk \
  curl \
  wget \
  file \
  openssl \
  libayatana-appindicator-dev \
  librsvg

NixOS

ノート

この処理では、Rust と Node.js および「cargo-tauri」コマンドライン・インターフェース（CLI） のインストールも同時に行なわれますので、以下の作業ステップを省略できます。

Using nix-shell:

let
  pkgs = import <nixpkgs> { };
in
pkgs.mkShell {
  nativeBuildInputs = with pkgs; [
    pkg-config
    gobject-introspection
    cargo
    cargo-tauri
    nodejs
  ];

  buildInputs = with pkgs;[
    at-spi2-atk
    atkmm
    cairo
    gdk-pixbuf
    glib
    gtk3
    harfbuzz
    librsvg
    libsoup_3
    pango
    webkitgtk_4_1
    openssl
  ];
}

もし、使用しているディストリビューションが上記に含まれていない場合には、GitHub の Awesome Tauri のページを参照して、ガイドマニュアルが作成されていないかどうか確認してみてください。

次のステップ： Rust のインストール

macOS

Tauri は Xcode とさまざまな macOS および iOS の開発関連の依存関係を利用します。

次のサイトのいずれかから Xcode をダウンロードしてインストールします。

• Mac App Store
• Apple Developer website.

インストール後には、必ず Xcode を起動してセットアップを完了させてください。

デスクトップ・アプリのみを開発する場合は、ここをクリック

もしデスクトップ・アプリのみを開発する予定で、iOS 用アプリを作成しないのであれば、上記の「Xcode」の代わりに、「Xcode コマンドライン・ツール」をインストールすることもできます。

xcode-select --install

次のステップ： Rust のインストール

Windows

Windows での開発には、Tauri は Microsoft の C++ Build Tools と Microsoft Edge WebView2 の両方が必要になります。

次の作業ステップに従って　必要な依存関係をインストールしてください。

Microsoft C++ Build Tools

1. Microsoft C++ Build Tools インストーラーをダウンロードして開き、インストールを開始します。
2. インストール時に、「Desktop development with C++」オプションにチェックを入れてください。

次のステップ： WebView2 のインストール.

WebView2 のインストール

ヒント

Windows 10（バージョン 1803）以降の Windows では、WebView 2 が既にインストール済みです。開発に使用するシステムのバージョンがこれらであれば、このステップを飛ばして、直接 Rust をインストール に進んでください。

Tauri は、Windows 上にコンテンツをレンダリングするために Microsoft Edge WebView2 を使用します。

Microsoft の Webview2 ダウンロード・サイト Download the WebView2 Runtime セクションから「Evergreen Boostrapper」ファイルをダウンロードし、インストールしてください。

次のステップ： Rust のインストール

Rust のインストール

Tauri は Rust で作られており、開発にも Rust が必要です。Rust のインストールには、次のいずれかの方法を使用します。その他のインストール方法については、https://www.rust-lang.org/tools/install を参照してください。

Linux と macOS

以下のコマンドを用いて、Rust のバージョン管理ルーツ「 rustup 」経由でインストールします：

curl --proto '=https' --tlsv1.2 https://sh.rustup.rs -sSf | sh

安全性のためのヒント

この bash スクリプトは確認済で、目的どおりの動作をします。とはいえ、スクリプトを盲目的に「curl-bash」コマンドで実行するよりも、常にスクリプトの内容を使用前に確認することが賢明です。

スクリプトの平文ファイルはこちらです： rustup.sh

Windows

rustup をインストールするには、Rust のサイト https://www.rust-lang.org/ja/tools/install を参照してください。

あるいは、PowerShell で以下のようにコマンドを入力することで、winget を使用して rustup をインストールすることもできます：

winget install --id Rustlang.Rustup

MSVC toolchain がデフォルト

Tauri と trunk のようなツールを完全に利用するためには、インストーラーのダイアログで「MSVC Rust ツールチェーン」で default host triple が選択されていることを確認してください。使用しているコンピュータ・システムに応じて、x86_64-pc-windows-msvc、i686-pc-windows-msvc、または aarch64-pc-windows-msvc のいずれかになります。

すでに Rust をインストール済みの場合には、次のコマンドを実行して、正しい「ツールチェーン」がインストールされているか確認してください：

rustup default stable-msvc

変更を有効にするために、必ずターミナル (場合によってはシステム本体) を再起動してください。

次のステップ：　Android および iOS 向けの開発を行なう場合は モバイル関連の設定 を、あるいは、JavaScript を使用する場合は Node のインストール を実行してください。それ以外の場合は、次章 プロジェクトの作成 に進んでください。

Node.js

JavaScript ecosystem

JavaScript をフロントエンドに使用する場合にのみ必要な準備処理です。

1. Node.js website を開いて LTS 版（長期サポート版）をダウンロードし、インストールしてください。

2. 以下のコマンドを実行して、 Node が正常にインストールされたかどうかを確認します。

node -v
# v20.10.0
npm -v
# 10.2.3

ターミナルを再起動して、新しくインストールしたプログラムが認識されているか確かめてください。場合によっては、コンピュータを再起動する必要があるかもしれません。

「npm」が Node.js のデフォルト・パッケージ・マネージャーですが、「pnpm」や「yarn」といった別のパッケージ・マネージャーを使うこともできます。こうしたパッケージ・マネージャーを有効化するには、ターミナルにて corepack enable を実行してください。この処理ステップは、「npm」以外のパッケージ・マネージャーを使いたい場合にのみに必要な、任意項目です。

次のステップ： モバイル関連の設定 または プロジェクトの作成 です。

モバイル関連の設定

Android や iOS 向けのアプリ開発を行なう場合には、インストールが必要な追加の依存関係モジュールがいくつかあります：

• Android
• iOS

Android

1. Android Developers website から Android Studio をダウンロードしてインストールします。
2. JAVA_HOME 環境変数を設定します：

Linux

export JAVA_HOME=/opt/android-studio/jbr

macOS

export JAVA_HOME="/Applications/Android Studio.app/Contents/jbr/Contents/Home"

Windows

[System.Environment]::SetEnvironmentVariable("JAVA_HOME", "C:\Program Files\Android\Android Studio\jbr", "User")

3. 「Android Studio」の「SDK Manager」を使って、以下をインストールします：

• Android SDK Platform
• Android SDK Platform-Tools
• NDK (Side by side)
• Android SDK Build-Tools
• Android SDK Command-line Tools

SDK マネージャーで「パッケージの詳細を表示」を選択すると、古いバージョンのパッケージをインストールできるようになります。古いバージョンは必要な場合にのみインストールしてください。互換性の問題やセキュリティ上のリスクが発生する可能性があります。

4. ANDROID_HOME と NDK_HOME の環境変数を設定します。

Linux

export ANDROID_HOME="$HOME/Android/Sdk"
export NDK_HOME="$ANDROID_HOME/ndk/$(ls -1 $ANDROID_HOME/ndk)"

macOS

export ANDROID_HOME="$HOME/Library/Android/sdk"
export NDK_HOME="$ANDROID_HOME/ndk/$(ls -1 $ANDROID_HOME/ndk)"

Windows

[System.Environment]::SetEnvironmentVariable("ANDROID_HOME", "$env:LocalAppData\Android\Sdk", "User")
$VERSION = Get-ChildItem -Name "$env:LocalAppData\Android\Sdk\ndk"
[System.Environment]::SetEnvironmentVariable("NDK_HOME", "$env:LocalAppData\Android\Sdk\ndk\$VERSION", "User")

ヒント

PowerShell は、再起動またはログアウトするまで、新しい環境変数の設定が有効になりませんが、 現在のセッションを更新することはできます：

[System.Environment]::GetEnvironmentVariables("User").GetEnumerator() | % { Set-Item -Path "Env:\$($_.key)" -Value $_.value }

5. rustup で Android を「ターゲット」に追加します：

rustup target add aarch64-linux-android armv7-linux-androideabi i686-linux-android x86_64-linux-android

次のステップ： iOS 用の設定 または プロジェクトの作成。

iOS

macOS のみ

iOS 開発の依存関係では Xcode が必要で、macOS 上でのみ利用可能です。上記 macOS 関連の依存関係設定の説明 部分にあるとおり、「Xcode コマンド・ライン・ツール」ではなく、「Xcode」そのものがインストールされていることを確認してください。

1. ターミナルから rustup を用いて、iOS を「ターゲット」に追加します：

rustup target add aarch64-apple-ios x86_64-apple-ios aarch64-apple-ios-sim

2. macOS 用パッケージ・マネージャー Homebrew をインストールします：

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

3. Homebrew を用いて、iOS 用ライブラリ管理ツール Cocoapods をインストールします：

brew install cocoapods

次のステップ： プロジェクトの作成.

問題が発生したら

インストール中に何か問題が発生したら、「トラブルシューティングに関する項目」を参照するか、「Tauri コミュニティー」に問い合わせてみてください。

Next Steps

すべての必要事項をインストールし終えましたので、これで はじめての Tauri プログラム を作成する準備が整いました！

【※ この日本語版は、「Nov 17, 2024 英語版」に基づいています】

Doc-JP 2.00.00