mirror of https://github.com/AppFlowy-IO/AppFlowy.git synced 2024-08-30 18:12:39 +00:00

History

Sean Riley Hawkins 69e3aed6b5 Android vscode workflow (#912 ) * fix: fix linux build * Merge pull request #599 from AppFlowy-IO/refactor/grid_decode_cell_data Refactor/grid decode cell data * feat: ⭐ configured android vscode workflow * chore: clean up android vscode * fix: fixed typo * chore: remove unused code Co-authored-by: Nathan.fooo <86001920+appflowy@users.noreply.github.com> Co-authored-by: Lucas.Xu <lucas.xu@appflowy.io>		2022-09-01 12:27:09 +08:00
..
app	Android vscode workflow (#912 )	2022-09-01 12:27:09 +08:00
gradle/wrapper	Android vscode workflow (#912 )	2022-09-01 12:27:09 +08:00
.gitignore	add frontend folder	2021-11-20 09:34:43 +08:00
build.gradle	Android vscode workflow (#912 )	2022-09-01 12:27:09 +08:00
gradle.properties	Android vscode workflow (#912 )	2022-09-01 12:27:09 +08:00
README.md	Android vscode workflow (#912 )	2022-09-01 12:27:09 +08:00
settings.gradle	Android vscode workflow (#912 )	2022-09-01 12:27:09 +08:00

README.md

Description

This is a guide on how to build the rust SDK for AppFlowy on android. Compiling the sdk is easy it just needs a few tweaks. When compiling for android we need the following pre-requisites:

Android NDK Tools. (v24 has been tested).
Cargo NDK. (@latest version).

Getting the tools

Install cargo-ndk bash cargo install cargo-ndk.
Download Android NDK version 24.
When downloading Android NDK you can get the compressed version as a standalone from the site. Or you can download it through Android Studio.
After downloading the two you need to set the environment variables. For Windows that's a seperate process. On MacOs and Linux the process is similar.
The variables needed are '$ANDROID_NDK_HOME', this will point to where the NDK is located.

Cargo Config File This code needs to be written in ~/.cargo/config, this helps cargo know where to locate the android tools(linker and archiver). NB Keep in mind just replace 'user' with your own user name. Or just point it to the location of where you put the NDK.

[target.aarch64-linux-android]
ar = "/home/user/Android/Sdk/ndk/24.0.8215888/toolchains/llvm/prebuilt/linux-x86_64/bin/llvm-ar"
linker = "/home/user/Android/Sdk/ndk/24.0.8215888/toolchains/llvm/prebuilt/linux-x86_64/bin/aarch64-linux-android29-clang"

[target.armv7-linux-androideabi]
ar = "/home/user/Android/Sdk/ndk/24.0.8215888/toolchains/llvm/prebuilt/linux-x86_64/bin/llvm-ar"
linker = "/home/user/Android/Sdk/ndk/24.0.8215888/toolchains/llvm/prebuilt/linux-x86_64/bin/armv7a-linux-androideabi29-clang"

[target.i686-linux-android]
ar = "/home/user/Android/Sdk/ndk/24.0.8215888/toolchains/llvm/prebuilt/linux-x86_64/bin/llvm-ar"
linker = "/home/user/Android/Sdk/ndk/24.0.8215888/toolchains/llvm/prebuilt/linux-x86_64/bin/i686-linux-android29-clang"

[target.x86_64-linux-android]
ar = "/home/user/Android/Sdk/ndk/24.0.8215888/toolchains/llvm/prebuilt/linux-x86_64/bin/llvm-ar"
linker = "/home/user/Android/Sdk/ndk/24.0.8215888/toolchains/llvm/prebuilt/linux-x86_64/bin/x86_64-linux-android29-clang"

Clang Fix In order to get clang to work properly with version 24 you need to create this file. libgcc.a, then add this one line.

INPUT(-lunwind)

Folder path: 'Android/Sdk/ndk/24.0.8215888/toolchains/llvm/prebuilt/linux-x86_64/lib64/clang/14.0.1/lib/linux'. After that you have to copy this file into three different folders namely aarch64, arm, i386 and x86_64. We have to do this so we Android NDK can find clang on our system, if we used NDK 22 we wouldnt have to do this process. Though using NDK v22 will not give us alot of features to work with. This github issue explains the reason why we are doing this.

Android NDK

After installing the NDK tools for android you should export the PATH to your config file (.vimrc, .zshrc, .profile, .bashrc file), That way it can be found.

export PATH=/home/sean/Android/Sdk/ndk/24.0.8215888