开局第一步 [Dioxus 文档翻译]

susnm
205 阅读4分钟

开局第一步 [Dioxus 文档翻译]

开始使用 Dioxus 很快，一两分钟就能完成。

选择编辑器

选择一个你喜欢的编译器.

我推荐使用 VSCode 它可以使用我们开发的 VSCode 插件.

我们的编译工具 dx 是标准的, 可以配合所有的编辑器工作.

按照 Rust-Analyzer

Dioxus 和 * Rust-Analyzer LSP 插件* 集成的很好, 他提供了代码高亮,代码导航,折叠等功能.

你应该根据下面的按照指引按照你选择插件.

安装 Rust

请前往 Rust官网 按照Rust 编译器

我们强烈建议您完全浏览官方的 Rust 数据。但是，我们希望Dioxus应用程序可以作为一个很棒的第一个Rust项目。

我们已经非常小心地设计确保 Dioxus语法足够熟悉且易于理解，因此您在开始构建复杂的Dioxus应用程序之前，您不需要对异步, 生命周期或智能指针有深入的了解。

安装 cargo-binstall

Dioxus 使用预编译的二进制文件分发, 所以你可以使用 cargo-binstall 安装 dx, 而无需从源代码编译.

您可以使用以下命令安装 cargo-binstall

curl -L --proto '=https' --tlsv1.2 -sSf https://raw.githubusercontent.com/cargo-bins/cargo-binstall/main/install-from-binstall-release.sh | bash

或者:

# 使用 macOS 的 brew 包管理工具
brew install cargo-binstall

# 通过源代码编译
cargo install cargo-binstall

安装 Dioxus CLI

Dioxus 有两部分组成:

  • dioxus 库: Dioxus 的核心框架
  • dx 工具: 一个用来编译 Dioxus app 的命令行工具 如果您想使用 Dioxus 构建Web或移动应用程序，或者受益于热加载和 bunding等功能，则需要安装 dx 工具。您可以使用以下命令下载预构建的二进制文件：
cargo binstall dioxus-cli

或者你想从源代码构建:

cargo install dioxus-cli

📢 从源代码构建可能需要耗费一些时间, 我强烈建议你使用 cargo-binstall 进行安装 如果你在编译时遇到 OpenSSL 错误, 确保你已经安装了这些依赖

平台相关的依赖

大多数平台不需要额外的依赖, 但是如果你需要编译 desktop 平台, 你需要安装下面这些依赖.

MacOS

macOS 平台不需要额外的依赖! 但是如果你要编译 iOS app, 请阅读下面的 iOS 章节

Windows

Windows 应用程序依赖于WebView2 - 它应该安装在所有现代Windows发行版中的库。

如果您已经安装了 Edge，则 Dioxus 将正常工作。如果您没有WebView2，则可以通过Microsoft安装它。微软提供了3个选项：

  1. 一个微小的“evergreen”引导程序，可从Microsoft的CDN获取安装程序。
  2. 一个小型安装程序，可从Microsoft的CDN获取WebView2。
  3. 您的最终二进制用户中的WebView2的静态链接版本。

我们建议使用选项1。

Linux

WebView Linux应用需要WebKitGTK和xdotool。分发时，这些应该是 .rpm 或 .deb 中依赖关系树的一部分。

如果遇到问题，请确保安装了所有基础依赖。

对于Ubuntu，请确保安装所有内容：

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 \
  xdotool

对于其他的 Linux 平台, 请查看 Tauri 文档来确保安装有相同的依赖. 如果是 Fedor, 在 Tauri 文档指定依赖的基础上,确保安装下面的这个依赖:

sudo dnf install libxdo-devel

WSL

尽管可行，但在WSL中为Dioxus桌面设置开发环境可能很棘手。并非所有内容都已经弄清楚了，有些东西可能不起作用。

以下是我们用来通过WSL运行 Dioxus 的步骤：

  1. 将您的内核更新为最新版本，然后将WSL更新为版本2。
  2. 添加环境变量 export DISPLAY=:0  到 ~/.zshrc 文件
  3. 在此处找到Tauri的Linux依赖项。
  4. 对于文件对话框，您需要安装一个 fallback, 比如Zenity 在WSL上运行Dioxus桌面时，您可能会看到来自 LibeGL的警告。目前没有办法来消除这些警告，但是该应用程序仍然可以正常渲染。

iOS

编译iOS 需要1台安装有 Xcode 的 macOS 设备. 从下面的方式下载并安装 Xcode

安卓

Android 应用需要安装Android SDK和NDK。这可能是大量的设置，因此我们建议阅读有关Android开发的专用指南。

avatar
文章
阅读
粉丝