Rust-iOS-Android 项目教程

项目介绍

Rust-iOS-Android 是一个开源项目，旨在帮助开发者使用 Rust 语言编写跨平台的移动应用。该项目允许开发者在一个共享的 Rust 核心库中编写逻辑代码，然后在 iOS 和 Android 平台上分别使用原生代码构建用户界面。这种方法不仅减少了代码重复，还利用了 Rust 的高性能和安全性，同时保持了原生应用的用户体验。

项目快速启动

安装 Rust

首先，确保你已经安装了 Rust 和 Cargo。如果没有安装，可以通过以下命令进行安装：

curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh

安装 Android 和 iOS 开发工具

Android

1. 安装 Android Studio 和 Android NDK。
2. 设置环境变量 NDK_HOME，指向 NDK 的安装路径。例如：

export NDK_HOME=$HOME/Library/Android/sdk/ndk/21.3.6528147

3. 安装 cargo-ndk：

cargo install cargo-ndk

4. 添加 Rust 目标平台：

rustup target add aarch64-linux-android armv7-linux-androideabi x86_64-linux-android i686-linux-android

iOS

1. 安装 Xcode。
2. 安装 rust-bitcode：

wget https://github.com/getditto/rust-bitcode/releases/download/v1.46.0/rust-ios-arm64-1.46.0.zip
unzip rust-ios-arm64-1.46.0.zip
cd rust-ios-arm64-1.46.0
./install.sh

创建项目

1. 克隆项目仓库：

git clone https://github.com/kennytm/rust-ios-android.git
cd rust-ios-android

2. 初始化项目：

cargo mobile init

3. 运行项目：

• 在 Android 设备上运行：

cargo android run

• 在 iOS 设备上运行：

cargo apple run

应用案例和最佳实践

应用案例

Rust-iOS-Android 项目已经被用于多个实际应用中，例如：

• CoEpi: 一个用于流行病接触追踪的移动应用，支持 Android 和 iOS 平台。
• Xi Editor: 一个多平台的文本编辑器，支持 macOS、GTK、Electron 和 Windows 等平台。

最佳实践

1. 代码复用: 尽量在 Rust 核心库中编写业务逻辑，减少平台特定的代码量。
2. 性能优化: 利用 Rust 的高性能特性，优化关键路径的代码。
3. 并发处理: 在 Rust 核心库中使用阻塞 API，在平台特定的代码中添加并发处理，简化 FFI/JNI 接口。

典型生态项目

WASM-Rust-d3

一个使用 Rust 核心库获取数据并在前端使用 d3.js 展示图表的示例项目。

yew-d3-example

类似于 WASM-Rust-d3，但使用了 Yew 框架来构建前端应用。

cargo-mobile2

一个简化 Rust 在移动平台上开发的工具，自动生成 Xcode 和 Android Studio 项目文件，并支持在设备上构建和运行应用。

通过这些生态项目，开发者可以更方便地使用 Rust 进行跨平台开发，并利用 Rust 的高性能和安全性优势。