联系方式

Rik Arends: @rikarends 在推特，https://fosstodon.org/@rikarends#

Eddy Bruel: @ejpbruel 在推特

Sebastian Michailidis: @SebMichailidis 在推特

Makepad 的 Discord 频道： https://discord.gg/adqBRq7Ece

关于 makepad 的最新讨论： https://www.youtube.com/watch?v=rC4FCS-oMpg

Makepad

概述

这是一个 Makepad 的仓库，Makepad 是一种在 Rust 中构建 UI 的新方法，适用于原生和网页。

Makepad 由 Makepad 框架和 Makepad 工作室组成。

Makepad 框架是我们的 UI 框架。它由多个 crate 组成，但顶级 crate 是 makepad-widgets。有关 Makepad 框架的进一步说明，请参阅该 crate 的 README。

Makepad 工作室是我们使用 Makepad 框架构建的 IDE 原型。它仍在积极开发中，但我们的最终目标是创建一个 IDE，允许在运行时更改应用程序的设计。Makepad 工作室的主要 crate 是 makepad-studio。有关更多信息，请参阅该 crate 的 README。

演示链接

makepad-example-fractal-zoom

makepad-example-ironfish

makepad-example-simple

先决条件

要构建 Makepad 的 crate，您首先需要安装 Rust。 https://www.rust-lang.net.cn/tools/install

我们的本地构建适用于稳定的 Rust 工具链。然而，Makepad 在运行时生成的某些错误（尤其是那些源于我们的 DSL 的错误）除非您使用夜间 Rust 工具链，否则不包含行信息。此外，我们的网络构建目前仅适用于夜间。因此，我们建议您使用夜间 Rust 工具链来构建 Makepad。

对于非标准构建目标（苹果 iOS、苹果 tvOS、Android、wasm），我们有一个名为 'cargo-makepad' 的构建工具，您需要安装它。

从仓库中安装它

cargo安装 --路径=./tools/cargo_makepad

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

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

或者从 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

安装 makepad 子命令 for 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，过程稍微复杂一些。涉及的步骤包括

1. 启用您的 iPhone 的开发者模式，请参阅此处说明：启用开发者模式
2. 设置 Apple 开发者账户
3. 在 XCode 中设置一个空的项目模板
   1. 文件 -> 新建 -> 项目以创建一个新的 "App"
   2. 将产品名称设置为 makepad-example-simple（在 --app 中使用）
   3. 将组织标识符设置为您的选择值，在此示例中，我们将使用 my.test（在后面的 --org 中使用）
   4. 设置项目签名和功能以选择正确的团队帐户
4. 在 XCode 中，构建/运行此项目以在模拟器和设备上安装和运行应用
5. 一旦模拟器和设备上安装并正确运行了“骨架”应用，则它就准备好让 Makepad 安装其应用。

Makepad 安装

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

--org

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

my.test

--app

应用程序或项目的名称。这与上面设置的初始骨架应用中使用的 Product Name 相同。在这种情况下

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