iOS调用Rust
-
上篇介绍了 Rust移动开发:Rust在Android端集成使用介绍, 这篇主要看下iOS上如何使用Rust,Rust可以给移动端开发提供跨平台,通用组件支持。
-
该篇适合对iOS、Rust了解,想知道如何整合调用和编译的,如果想要工程源码,可以评论或留言有解疑也可进行询问(更多最新文章也可关注微信公号: 良技漫谈)
一,开发环境:
-
确保xcode开发环境,推荐官方文档, 安装即可
-
rust开发环境
-
xcode及iOS调试设备
二,添加rust交叉编译
-
同android一样,可以添加支持ios的编译
rustup target add aarch64-apple-ios x86_64-apple-ios
-
初始化 cargo-lipo : 这个create可以编译rs为iOS需要的库
cargo install cargo-lipo
三,创建工程
-
这里的rs代码直接 (参考了mozilla的例子,只为测试验证集成过程)
-
创建iOS基本工程,并创建rust的库工程,可以创建lib,也可以直接rs工程。 (一套rust代码,提供多个平台,那一般可以创建lib库,这样rust工程来调试后,统一对外提供lib库代码,由lib库代码编译对应的so,或者.a文件)
cargo new Rust_iOS --lib
-
这里使用 Rust_iOS 作为为iOS工程提供的rust 库代码,通过 cargo-lipo 编译出.a的库文件,为ios工程进行调用。
rust代码添加
-
在lib.rs里添加下边代码
use std::ffi::{CStr, CString};
use std::os::raw::c_char;//#[no_mangle] 告诉编译器不要破坏函数名,确保函数名称被导入到 C 文件
//extern 告诉 Rust 编译器方法将要在 Rust 以外的地方调用,要确保其按照 C 的调用规则编译。
#[no_mangle]
pub extern "C" fn rust_greeting(to: *const c_char) -> *mut c_char {
let c_str = unsafe { CStr::from_ptr(to) };
let recipient = match c_str.to_str() {
Err(_) => "there",
Ok(string) => string,
};CString::new("Hello ".to_owned() + recipient) .unwrap() .into_raw()
}
#[no_mangle]
pub extern "C" fn rust_greeting_free(s: *mut c_char) {
unsafe {
if s.is_null() {
return;
}
CString::from_raw(s)
};
} -
• **greetings.h :**src下添加一个名为 greetings.h 的新文件,来定义一下 C 接口,iOS调用的Rust函数在这里定义
#include <stdint.h>
const char* rust_greeting(const char* to);
void rust_greeting_free(char *); -
Cargo.toml定义编译类型: staticlib 编译会生成 .a 文件(在 Linux 和 MacOS 上),或 .lib 文件(在 Windows 上)。
[lib]
name = "greetings"
crate-type = ["staticlib", "cdylib"] -
编译成静态库:
cargo lipo --release
构建产物位置在 target/下,通用 iOS 库的位置在 /target/universal/release/libRust_iOS.a
四,iOS工程引入Rust库:
导入 libRust_iOS.a 库:
-
创建demo ios 工程, 导入 libRust_iOS.a 库(从rust工程找到,直接拖进入工程target下general)
-
链接 libresolv.tbd。点击 Linked Frameworks 列表底部的 + 并在搜索框中键入 libresolv。选择 libresolv.tbd
bridging header创建:
-
创建之前先把之前定义在rust工程里的.h文件引入过来,这个.h文件是rust代码调用的声明入口(File\Add files to"iOSIntegratingRust" )
-
创建bridging header: File\New\File..。从提供的选项中选择 iOS Source Header File 并选择 Next。将文件命名为 Greetings-Bridging-Header.h 并选择 Create
-
引入greetings.h
#ifndef Greetings_Bridging_Header_h
#define Greetings_Bridging_Header_h
#import "greetings.h"
#endif
iOS Build Settings:
-
设置Objective-C Bridging Header链接要的.h文件, 工程 target 里打开 Build Settings 选项卡。将 Objective-C Bridging Header设置为$(PROJECT_DIR)/Greetings-Bridging-Header.h (要看自己.h所在的位置)
-
设置 Xcode 要链接 Rust 库的路径, Build Settings 中 Library Search Paths中设置 $(PROJECT_DIR)/../Rust_iOS/target/universal/release (要看自己库实际位置)
五,iOS代码调用:
-
从刚demo工程里新建一个 swift 文件,命名为 RustGreetings
import Foundation
class RustGreetings {
func sayHello(to: String) -> String {
let result = rust_greeting(to)
let swift_result = String(cString: result!)
rust_greeting_free(UnsafeMutablePointer(mutating: result))
return swift_result
}
} -
ViewController.swift里 添加代码验证调用
override func viewDidLoad() { super.viewDidLoad() // Do any additional setup after loading the view. let rustGreetings = RustGreetings() print("\(rustGreetings.sayHello(to: "world"))") }
PS: 也欢迎大家评论和交流~ 更多文章也可关注微信公号:良技漫谈