Rust App 开发基本设置

我们将在macOS上进行Rust App跨平台开发，以下的设置都是基于macOS。

Rust 安装

安装rustup

Rust 提供了友好的开发工具链，我们只需要先安装rustup，通过rustup便可完成Rust 语言开发环境的安装和配置。


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

安装rust-1.41

PayBy 需要兼容32位iOS系统，而Rust从1.42开始不再支持iOS 32位架构，所以我们选择安装1.41.0 版本。


> rustup install 1.41.0
> rustup default 1.41.0

安装完成后，可以检查当前生效的Rust编译器版本:


> rustc --version
rustc 1.41.0 (5e1a79984 2020-01-27)

安装Cargo

Cargo是Rust的包管理器，类似于Java的Maven,Gradle等。使用下面等命令安装：


> curl https://sh.rustup.rs -sSf | sh

App 编译目标平台设置

为了让Rust编译器编译出适合在Android和iOS上使用的库，需要添加相应的targets支持。rustup 能够帮我们搞定。另外还需要为不同平台添加相应的工具链支持。

Android 平台设置

添加targets




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

NDK 工具链

确保正确安装了 Android NDK tools，并且设置好了NDK_HOME系统环境变量。

有了正确的NDK_HOME后，我们只需要安装cargo-ndk, 就可以让Rust查找到正确的NDK链接器，并在Rust和Android NDK之间进行正确的转换，最终产出Android 平台上可用的NDK 库。

我们只需要使用Cargo 就可以方便安装 cargo-ndk:


> cargo install cargo-ndk --version 1.0.0

添加 iOS targets





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

iOS 工具链

为了生成iOS项目需要的头文件，需要安装 cbindgen:


> cargo install cbindgen --version 0.15.0

为了自动生成universal库文件，需要安装cargo-lipo:


> cargo install cargo-lipo --version 3.1.1

跨平台开发项目结构

我们的目标是，核心业务逻辑使用Rust编写，节约工作量，并保持业务逻辑的一致性；在核心业务逻辑之上，通过薄薄的一层绑定，适配到 iOS和Android。

所以我们的项目结构可以划分为：








payby_logic
         |
         |-- features
                  |-- feature_1
                  |-- feature_x
         |-- binding
                  |-- Android
                  |-- iOS

当然，各个核心逻辑是可以单独构成项目，通过Rust的crate机制集成。

构建脚本

为了方便构建，避免重复命令，分别编写 android_build.sh:


























#!/usr/bin/env bash
# set the version to use the library
min_ver=21
# verify before executing this that you have the proper targets installed
cargo ndk --target aarch64-linux-android --android-platform ${min_ver} -- build --release -p binding_payby_android
cargo ndk --target armv7-linux-androideabi --android-platform ${min_ver} -- build --release -p binding_payby_android
cargo ndk --target i686-linux-android --android-platform ${min_ver} -- build --release -p binding_payby_android
cargo ndk --target x86_64-linux-android --android-platform ${min_ver} -- build --release -p binding_payby_android

# moving libraries to the android project
jniLibs=./outputs/android
libName=libbinding_payby_android.so

rm -rf ${jniLibs}

mkdir -p ${jniLibs}
mkdir -p ${jniLibs}/arm64-v8a
mkdir -p ${jniLibs}/armeabi-v7a
mkdir -p ${jniLibs}/x86
mkdir -p ${jniLibs}/x86_64

cp target/aarch64-linux-android/release/${libName} ${jniLibs}/arm64-v8a/${libName}
cp target/armv7-linux-androideabi/release/${libName} ${jniLibs}/armeabi-v7a/${libName}
cp target/i686-linux-android/release/${libName} ${jniLibs}/x86/${libName}
cp target/x86_64-linux-android/release/${libName} ${jniLibs}/x86_64/${libName}

以及 ios_build.sh:
























#!/usr/bin/env bash
iosLibs=./outputs/ios
libName=libbinding_payby_ios

rm -fr ${iosLibs}
mkdir -p ${iosLibs}

# cbindgen create .h file
cbindgen --crate binding_payby_ios -o ${iosLibs}/${libName}.h
cargo lipo --all --release --targets=aarch64-apple-ios,x86_64-apple-ios,armv7-apple-ios,armv7s-apple-ios


mkdir -p ${iosLibs}/aarch64-apple-ios
mkdir -p ${iosLibs}/armv7-apple-ios
mkdir -p ${iosLibs}/armv7s-apple-ios
mkdir -p ${iosLibs}/x86_64-apple-ios
mkdir -p ${iosLibs}/universal

cp target/aarch64-apple-ios/release/${libName}.a ${iosLibs}/aarch64-apple-ios/${libName}.a
cp target/armv7-apple-ios/release/${libName}.a ${iosLibs}/armv7-apple-ios/${libName}.a
cp target/armv7s-apple-ios/release/${libName}.a ${iosLibs}/armv7s-apple-ios/${libName}.a
cp target/x86_64-apple-ios/release/${libName}.a ${iosLibs}/x86_64-apple-ios/${libName}.a
cp target/universal/release/${libName}.a ${iosLibs}/universal/${libName}.a

至此，Rust App 跨平台开发基本的设置就完成了，接下来我们就可以愉快地进行Rust开发了。