45 lines
1.8 KiB
Plaintext
Raw Blame History

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.

---
title: '開始使用'
---
你需要一些工具來編譯、建置、打包和調試你的 Yew 應用程式。在最開始,我們建議使用 [Trunk](https://trunkrs.dev/)。 Trunk 是用於 Rust 的 WASM Web 應用程式打包工具。
## 安裝 Rust
要安裝 Rust請按照[官方說明](https://www.rust-lang.org/tools/install)。
:::important
Yew 支援的最低 Rust 版本MSRV是 `1.84.0`。舊版將無法編譯。您可以使用 `rustup show`在「active toolchain」下或 `rustc --version` 檢查您的工具鏈版本。若要更新您的工具鏈,請執行 `rustup update`。
:::
## 安裝 WebAssembly 目標
Rust 可以為不同的「目標」(例如不同的處理器)編譯原始碼。用於基於瀏覽器的 WebAssembly 的編譯目標稱為 `wasm32-unknown-unknown`。以下命令將向您的開發環境新增 WebAssembly 目標。
```shell
rustup target add wasm32-unknown-unknown
```
## 安裝 Trunk
Trunk 是建議的管理部署和包裝的工具,並在整個文件和範例中使用。
```shell
# 需要注意的是,這可能需要一段時間來安裝,因為它會從頭開始編譯所有內容
# Trunk 也為許多主要的套件管理器提供了預先建置的二進位文件
# 有關更多詳細信息,請參見 https://trunkrs.dev/#install
cargo install --locked trunk
```
### 其他選項
除了 Trunk 之外,還有其他選項可用於打包 Yew 應用程式。您可能想嘗試以下選項之一:
- [`wasm-pack`](https://github.com/drager/wasm-pack/)
- [`wasm-run`](https://github.com/IMI-eRnD-Be/wasm-run)
- [`xtask-wasm`](https://github.com/rustminded/xtask-wasm/) (仍在早期開發階段)
## 下一步
設定好開發環境後,現在可以繼續閱讀文件。如果您喜歡透過動手實作來學習,我們建議您查看我們的[教學](../tutorial)。