Rust on Mobile 项目：iOS平台Rust开发环境搭建指南

前言

随着Rust语言在系统编程领域的崛起，越来越多的开发者希望将Rust应用到移动开发领域。本文将详细介绍如何在iOS平台上搭建Rust开发环境，并创建一个简单的"Hello World"应用程序。

环境准备

Rust工具链安装

首先需要安装Rust工具链，建议使用nightly版本以获得最新特性：

curl https://sh.rustup.rs -sSf | sh
rustup update
rustup install nightly
rustup default nightly

必要组件安装

为获得更好的开发体验，建议安装以下组件：

rustup component add \
    rls-preview \      # Rust语言服务器
    rust-analysis \    # RLS辅助工具
    rust-src \        # 标准库源代码
    rustfmt-preview   # 代码格式化工具

iOS目标平台支持

需要添加iOS平台的目标工具链：

rustup target add \
    aarch64-apple-ios \
    armv7-apple-ios \
    armv7s-apple-ios \
    x86_64-apple-ios \
    i386-apple-ios

辅助工具安装

安装cbindgen工具，用于自动生成Rust与Objective-C/C++的FFI绑定：

cargo install cbindgen

项目结构设计

合理的项目结构对于跨平台开发至关重要，建议采用以下目录结构：

项目根目录/
├── ios/          # iOS原生项目代码
├── rust/         # Rust代码
│   ├── app-lib/   # 核心业务逻辑
│   ├── app-bindings/ # FFI绑定层
│   └── app-bin/    # 本地测试可执行文件

创建工作区

在项目根目录创建Cargo.toml文件，配置工作区：

[workspace]
members = [
    "rust/app-lib",
    "rust/app-bindings",
    "rust/app-bin"
]

Rust模块开发

核心库(app-lib)

app-lib包含应用的主要逻辑，lib.rs示例：

pub fn main_rs() -> std::os::raw::c_int {
    println!("Hello iOS!");
    0
}

绑定层(app-bindings)

app-bindings负责处理Rust与Objective-C的交互：

use std::{panic::{self, UnwindSafe}, process};

#[no_mangle]
pub extern "C" fn main_rs() -> std::os::raw::c_int {
    stop_unwind(app_lib::main_rs)
}

fn stop_unwind<F: FnOnce() -> T + UnwindSafe, T>(f: F) -> T {
    match panic::catch_unwind(f) {
        Ok(t) => t,
        Err(_) => {
            eprintln!("Attempt to Unwind out of rust code");
            process::abort()
        }
    }
}

本地测试(app-bin)

app-bin提供本地测试能力：

fn main() {
    assert_eq!(app_lib::main_rs(), 0);
}

Xcode项目配置

基本设置

1. 创建Single View App项目，语言选择Objective-C
2. 启用Legacy Build System（Xcode10需要）
3. 保留main.mm和Info.plist，其余文件可删除

集成Rust代码

1. 将rust目录以"Create Folder References"方式添加到Xcode项目
2. 创建符号链接简化架构管理：

mkdir target-symlinks
cd target-symlinks
ln -s ../target/aarch64-apple-ios arm64
ln -s ../target/armv7s-apple-ios armv7s
ln -s ../target/armv7-apple-ios armv7
ln -s ../target/x86_64-apple-ios x86_64
ln -s ../target/i386-apple-ios i386

构建系统集成

1. 创建cbindgen外部构建目标，生成FFI头文件
2. 创建cargo外部构建目标，编译Rust代码
3. 配置Library Search Paths指向符号链接目录
4. 链接app_bindings.a静态库

调试与测试

本地测试

cargo run -p app-bin

iOS设备测试

1. 在main.mm中调用Rust函数：

#include "bindings.h"

int main(int argc, char * argv[]) {
    return ffi::main_rs();
}

2. 配置Xcode断点调试Rust代码

常见问题解决

1. 链接错误：可能需要添加Security.framework
2. 架构不匹配：检查符号链接是否正确
3. FFI问题：确保cbindgen配置正确

结语

通过本文的步骤，开发者可以成功在iOS平台上搭建Rust开发环境，并实现Rust与Objective-C的互操作。这种架构既保留了Rust的性能和安全性优势，又能利用iOS原生开发的各种特性，为移动开发提供了新的可能性。

随着Rust在移动领域的不断发展，这种混合开发模式将越来越成熟，为开发者带来更多便利。建议开发者持续关注Rust在移动平台的最新进展，及时更新工具链和开发实践。