我们的本地构建适用于稳定的 Rust 工具链。然而，如果使用的是 nightly Rust 工具链，Makepad 在运行时产生的某些错误（特别是那些源于我们的 DSL 的错误）可能不包含行信息。此外，我们的 Web 构建 currently 只能在 nightly 下工作。因此，我们建议您使用 nightly Rust 工具链来构建 Makepad。

对于非标准构建目标（apple ios、apple tvos、android、wasm），我们有一个名为 'cargo-makepad' 的构建工具，您需要安装它。

从仓库中安装

cargoinstall --path=./tools/cargo_makepad

或者从 cargo 安装（可能位于仓库之后）

cargoinstall cargo-makepad

现在这个工具可以用来为每个平台安装所需的工具链

cargomakepad wasm install-toolchain

cargomakepad apple ios install-toolchain

cargomakepad apple tvos install-toolchain

cargomakepad android --abi=all install-toolchain

运行 Makepad Studio

Makepad Studio 允许您轻松构建和查看示例，并且它内部使用 cargo-makepad，因此请确保按照上面所示安装 cargo-makepad。

cargo运行 -pmakepad-studio --release

或者从 cargo 安装（可能位于仓库之后）

cargoinstall makepad-studio

如果您构建了 wasm 应用程序，您可以在以下位置打开它：

http://127.0.0.1:8010

构建和运行命令

Makepad 是一个用 Rust 编写的跨平台 UI 框架。它正在积极开发中，但已经可以用于构建快速原型和简单（甚至复杂）的 UI 应用程序。

Makepad 的一个关键特性是它能够在多个平台上简单且快速地构建和运行应用程序，包括 MacOS、Windows、Linux、Android、iOS 和 WebAssembly。

以下是关于如何在不同的平台上构建和运行 Makepad 应用程序的当前/最新说明。

假设

我们将假设以下内容：应用程序名称： makepad-example-simple

它可以更改为 Makepad 示例文件夹中的任何现有示例应用程序。

构建和运行说明

请按照以下步骤 1 的命令进行初始设置 Makepad 构建和运行环境。在步骤 2 之后，您可以选择您感兴趣的任何或多个平台进行构建。

1. 设置 Makepad

将 projects 替换为您自己的目录名称。

cd ~/projects

克隆 Makepad 仓库

git clone https://github.com/makepad/makepad.git

或者

git clone [email protected]:makepad/makepad.git

切换到最新的 'rik' 分支（可选）

cd ~/projects/makepad
git branch rik

安装 makepad 子命令用于 cargo

cd ~/projects/makepad
cargo install --path ./tools/cargo_makepad

安装平台工具链

rustup toolchain install nightly

2. 进入示例文件夹（可选）

cd ~/projects/makepad/examples
ls -l

该目录中的所有示例都以 makepad-example- 前缀加上目录名称作为应用程序名称。

3. MacOS/PC

在桌面上运行是尝试示例应用程序的最快方式。

cd ~/projects/makepad/examples/simple
cargo run

或者

cd ~/projects/makepad
cargo run -p makepad-example-simple

现在应该有一个桌面应用程序窗口正在运行（可能需要在 MacOS 的 Dock 上单击图标以显示它）

4. Android 构建

安装 Android 工具链（首次安装）

cargo makepad android install-toolchain

在 Android 设备或 Android 模拟器上安装应用程序

打开 Android 模拟器或连接到真实 Android 设备，使用 adb 命令确保只有一个设备连接正确，然后按照以下方式安装和运行：

cd ~/projects/makepad
cargo makepad android run -p makepad-example-simple --release

应用程序将被安装在模拟器或设备上并启动。

5. iOS设置与安装

安装iOS工具链（首次安装）

xcode-select --install
cargo makepad apple ios install-toolchain

在Apple设备或iOS模拟器上安装应用程序

iOS设置

对于iOS，过程稍微复杂一些。涉及的步骤包括

启用您的iPhone的开发者模式，请参阅以下说明：[启用开发者模式](https://www.delasign.com/blog/how-to-turn-on-developer-mode-on-an-iphone/)
设置一个Apple开发者账户
在XCode中设置一个空的骨架项目
1. 文件 -> 新建 -> 项目，创建一个新的"应用程序"项目
2. 将产品名称设置为 makepad-example-simple （在后面的--app中使用）
3. 将组织标识符设置为您选择的值，在此示例中我们将使用 my.test （在后面的--org中使用）
4. 设置项目签名和功能以选择正确的团队账户
在XCode中构建/运行此项目，以在模拟器和设备上安装和运行应用程序
一旦模拟器和设备安装并正确运行了“骨架”应用程序，则可以准备Makepad安装其应用程序。

Makepad安装

我们将运行以下命令：cargo makepad apple ios，类似于上面的Android构建，但需要填写2到6个附加参数

--org

组织标识符的前几个部分。通常形式为com.somecompany或org.orgname等。这是设置上述初始骨架应用程序时使用的相同值。在此示例中

my.test

--app

应用程序或项目的名称。这与设置初始骨架应用程序时使用的相同产品名称。在这种情况下

makepad-example-simple

安装iOS模拟器上的应用程序

cd ~/projects/makepad
cargo makepad apple ios \
  --org=my.test \
  --app=makepad-example-simple \
  run-sim -p makepad-example-simple --release

安装iOS设备上的应用程序

对于在真实设备上安装，过程更为复杂，因为可能存在多个配置文件和签名标识以及目标设备。因此，Makepad提供了一个列出命令来显示所有本地配置文件、签名标识和连接的设备，这些可以作为后续命令参数的值的。

例如，首先运行以下命令

cd ~/projects/makepad
cargo makepad apple list

此命令将打印出当前系统上所有配置文件、签名标识和设备标识的列表。用户必须决定并选择他/她需要为每种类型使用的标识。

一旦决定，运行以下命令并填写从输出中选择的 唯一的起始字符。

cargo makepad apple ios \
 --profile=unique-starting-hex-string-of-provisioning-profiles \
 --cert=UNIQUE_STARTING_HEX_STRING-of-signing-certificates \
 --device-identifier=UNIQUE-STARTING-HEX-STRING-of-devices \
 --org=my.test \
 --app=makepad-example-simple \
 run-device -p makepad-example-simple –release

应用程序将被安装在模拟器或真实设备上。（请确保设备已连接并解锁）

6. WASM构建

以WASM构建运行Makepad应用程序就像一个单独的命令一样简单。脚本将自动生成必要的index.html和其他文件，并在8010端口启动本地Web服务器。运行以下命令后，只需在浏览器中打开http://127.0.0.1:8010/，应用程序即可加载和运行。

安装WASM工具链（首次安装）

cargo makepad wasm install-toolchain

将应用程序作为WASM二进制文件安装到浏览器中

cargo makepad wasm run -p makepad-example-simple --release

Makepad命令快速参考

Cargo工具安装

这些是在最初至少需要运行一次以设置Makepad开发环境的命令。它们也应该偶尔运行或当cargo_makepad脚本有更新时运行。

rustup update
rustup install nightly
rustup toolchain install nightly

cd ~/projects/makepad
cargo install --path ./tools/cargo_makepad
cargo makepad android install-toolchain
cargo makepad apple ios install-toolchain
cargo makepad apple tv install-toolchain
cargo makepad wasm install-toolchain

Android

将应用程序安装到iOS模拟器的命令。

cargo makepad android run -p makepad-example-simple --release

cargo makepad android run -p makepad-example-fractal-zoom --release

cargo makepad android run -p makepad-example-ironfish --release

cargo makepad android run -p makepad-example-news-feed --release

iOS模拟器

将应用程序安装到iOS模拟器的命令。

cargo makepad apple ios --org=my.test --app=makepad-example-simple run-sim -p makepad-example-simple --release

cargo makepad apple ios --org=my.test --app=makepad-example-fractal-zoom run-sim -p makepad-example-fractal-zoom --release

cargo makepad apple ios --org=my.test --app=makepad-example-ironfish run-sim -p makepad-example-ironfish --release

cargo makepad apple ios --org=my.test --app=makepad-example-news-feed run-sim -p makepad-example-news-feed --release

iOS设备

将应用程序安装到物理iOS设备的命令。

请参阅上面的第5步以获取更多详细说明。

cargo makepad apple ios --org=my.test --profile=ABC --cert=DEF --device=MyiPhone --app=makepad-example-simple run-device -p makepad-example-simple --release

cargo makepad apple ios --org=my.test --profile=ABC --cert=DEF --device=MyiPhone --app=makepad-example-fractal-zoom run-device -p makepad-example-fractal-zoom --release

cargo makepad apple ios --org=my.test --profile=ABC --cert=DEF --device=MyiPhone --app=makepad-example-ironfish -run-device -p makepad-example-ironfish --release

cargo makepad apple ios --org=my.test --profile=ABC --cert=DEF --device=MyiPhone --app=makepad-example-news-feed run-device -p makepad-example-news-feed --release

Cargo检查构建

用于检查所有Makepad支持的平台编译是否通过的命令：（将使用100% CPU并可能导致设备挂起，仅在高性能系统上尝试）

cargo makepad check install-toolchain
cargo makepad check all

依赖项

约2.7-10MB
约71K SLoC