我们的本地构建在稳定的Rust工具链上运行。然而，Makepad在运行时生成的某些错误（尤其是那些源于我们的DSL的错误）在没有使用nightly Rust工具链的情况下不包含行信息。此外，我们的Web构建目前仅支持nightly。因此，我们建议您使用nightly Rust工具链来构建Makepad。

对于非标准构建目标（苹果iOS、苹果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安装（可能位于仓库之后）

cargo安装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

为cargo安装makepad子命令

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模拟器或通过使用adb命令连接到真实Android设备，确保只有一个设备正确连接，然后按照以下方式安装和运行

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的开发者模式，请参阅以下说明：启用开发者模式
设置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 模拟器