A Tutorial for Building Maple for ARM and Compiling C Codes
last updated: 2020-10-13
A General Guidance of Building Maple for ARM and Running C Examples
Here is a step by step tutorial for building the Maple for the ARM release and running real C examples, which will print some ASCII texts. We did this demo in the environment below:
    Operating System:       Ubuntu 18.04.5 LTS
    Kernel:                 4.15.0
    GCC:                    7.5.0



Clone the repository from the gitee to your local environment.
 git clone https://gitee.com/openarkcompiler-incubator/mapleall.git
 cd mapleall



Set up tools for testing.
 cd tools/
 ./setup_tools.sh



Initialize the environment for building the Maple for ARM with the release version.
 cd ..
 source envsetup.sh arm release



Now, can we make and install the Maple, and all maple excutables can be found in the $MAPLE_ROOT/bin directory. Let MAPLE_ROOT be the top directory of the mapleall repository
 make
 make install



Run the two examples for fun.
First, we will use ast2mpl as C Frontend to print the ASCII text.
 cd examples/C
 ./maple_with_ast2mpl.sh

The output is as below:
 cd /home/lin/mapleall/examples/C/use_ast2mp
 ========================================================================
 ================== Use ast2mpl as C Frontend ===========================
 ========================================================================
 INC=/usr/bin/../lib/gcc/x86_64-linux-gnu/7.5.0
 /home/lin/mapleall/bin/ast2mpl printHuawei.c -I /usr/bin/../lib/gcc/x86_64-linux-gnu/7.5.0/include
 /home/lin/mapleall/bin/arm64-clang-release/maple -exe=me,mplcg -option="-O2 --quiet:-quiet" printHuawei.mpl
 /usr/bin/aarch64-linux-gnu-gcc -o printHuawei.out printHuawei.s -lm
 qemu-aarch64 -L /usr/aarch64-linux-gnu/ printHuawei.out

 HHHHHH         HHHHHH    HHHHHH         HHHHHH           HHHHH        HHHHHH        HHHHHH        HHHHHH       HHHHHHHHHHHHHH     HHHHHH
 HHHHHH         HHHHHH    HHHHHH         HHHHHH          HHHHHHH        HHHHHH      HHHHHHHH      HHHHHH       HHHHHHHHHHHHHHH     HHHHHH
 HHHHHH         HHHHHH    HHHHHH         HHHHHH         HHHHHHHHH       HHHHHH      HHHHHHHH      HHHHHH      HHHHHHHHHHHHHHHH     HHHHHH
 HHHHHH         HHHHHH    HHHHHH         HHHHHH         HHHHHHHHH       HHHHHH     HHHHHHHHH      HHHHHH     HHHHHHHHHHHHHHHHH     HHHHHH
 HHHHHH         HHHHHH    HHHHHH         HHHHHH        HHHHHHHHHHH       HHHHH     HHHHHHHHHH     HHHHH     HHHHHHH                HHHHHH
 HHHHHH         HHHHHH    HHHHHH         HHHHHH        HHHHHHHHHHH       HHHHHH    HHHHHHHHHH    HHHHHH     HHHHHH                 HHHHHH
 HHHHHH         HHHHHH    HHHHHH         HHHHHH       HHHHHH HHHHHH      HHHHHH   HHHHHHHHHHH    HHHHHH    HHHHHH                  HHHHHH
 HHHHHHHHHHHHHHHHHHHHH    HHHHHH         HHHHHH       HHHHHH HHHHHH       HHHHH   HHHHH HHHHHH   HHHHH     HHHHHHHHHHHHHHHHHHH     HHHHHH
 HHHHHHHHHHHHHHHHHHHHH    HHHHHH         HHHHHH      HHHHHH   HHHHHH      HHHHHH  HHHHH  HHHHH  HHHHHH     HHHHHHHHHHHHHHHHHHH     HHHHHH
 HHHHHHHHHHHHHHHHHHHHH    HHHHHH         HHHHHH      HHHHHH   HHHHHH      HHHHHH HHHHHH  HHHHHH HHHHH      HHHHHHHHHHHHHHHHHHH     HHHHHH
 HHHHHHHHHHHHHHHHHHHHH    HHHHHH         HHHHHH     HHHHHH     HHHHHH     HHHHHH HHHHH   HHHHHH HHHHH      HHHHHHHHHHHHHHHHHHH     HHHHHH
 HHHHHH         HHHHHH    HHHHHH         HHHHHH     HHHHHHHHHHHHHHHHH      HHHHH HHHHH    HHHHH HHHHH      HHHHHH                  HHHHHH
 HHHHHH         HHHHHH    HHHHHH         HHHHHH    HHHHHHHHHHHHHHHHHHH     HHHHHHHHHHH    HHHHHHHHHHH      HHHHHH                  HHHHHH
 HHHHHH         HHHHHH    HHHHHH         HHHHHH    HHHHHHHHHHHHHHHHHHH     HHHHHHHHHH      HHHHHHHHHH      HHHHHHH                 HHHHHH
 HHHHHH         HHHHHH    HHHHHH         HHHHHH   HHHHHHHHHHHHHHHHHHHHH     HHHHHHHHH      HHHHHHHHH        HHHHHH                 HHHHHH
 HHHHHH         HHHHHH     HHHHHH       HHHHHH    HHHHHH         HHHHHH     HHHHHHHHH      HHHHHHHHH        HHHHHHHH               HHHHHH
 HHHHHH         HHHHHH     HHHHHHHHHHHHHHHHHHH   HHHHHH           HHHHHH    HHHHHHHH        HHHHHHHH         HHHHHHHHHHHHHHHHH     HHHHHH
 HHHHHH         HHHHHH      HHHHHHHHHHHHHHHHH    HHHHHH           HHHHHH    HHHHHHHH        HHHHHHHH          HHHHHHHHHHHHHHHH     HHHHHH
 HHHHHH         HHHHHH       HHHHHHHHHHHHHHH    HHHHHH             HHHHHH    HHHHHHH        HHHHHHH             HHHHHHHHHHHHHH     HHHHHH
 HHHHHH         HHHHHH         HHHHHHHHHHH      HHHHHH             HHHHHH    HHHHHH          HHHHHH               HHHHHHHHHHHH     HHHHHH

Then, we can use opencc/whirl2mpl as C Frontend to print the same text.
 ./maple_with_whirl2mpl.sh

Here is the output:
 cd /home/lin/mapleall/examples/C/use_whirl2mpl
 ========================================================================
 ============= Use opencc/whirl2mpl as C Frontend =======================
 ========================================================================
 /home/lin/mapleall/tools/open64ark/bin/opencc -O0 -fe -keep -show -std=gnu99 printHuawei.c
 /home/lin/mapleall/tools/open64ark/bin/whirl2mpl printHuawei.B
 /home/lin/mapleall/bin/arm64-clang-release/maple -exe=me,mplcg -option="-O2 --quiet:-quiet" printHuawei.mpl
 /usr/bin/aarch64-linux-gnu-gcc -o printHuawei.out printHuawei.s -lm
 qemu-aarch64 -L /usr/aarch64-linux-gnu/ printHuawei.out

 HHHHHH         HHHHHH    HHHHHH         HHHHHH           HHHHH        HHHHHH        HHHHHH        HHHHHH       HHHHHHHHHHHHHH     HHHHHH
 HHHHHH         HHHHHH    HHHHHH         HHHHHH          HHHHHHH        HHHHHH      HHHHHHHH      HHHHHH       HHHHHHHHHHHHHHH     HHHHHH
 HHHHHH         HHHHHH    HHHHHH         HHHHHH         HHHHHHHHH       HHHHHH      HHHHHHHH      HHHHHH      HHHHHHHHHHHHHHHH     HHHHHH
 HHHHHH         HHHHHH    HHHHHH         HHHHHH         HHHHHHHHH       HHHHHH     HHHHHHHHH      HHHHHH     HHHHHHHHHHHHHHHHH     HHHHHH
 HHHHHH         HHHHHH    HHHHHH         HHHHHH        HHHHHHHHHHH       HHHHH     HHHHHHHHHH     HHHHH     HHHHHHH                HHHHHH
 HHHHHH         HHHHHH    HHHHHH         HHHHHH        HHHHHHHHHHH       HHHHHH    HHHHHHHHHH    HHHHHH     HHHHHH                 HHHHHH
 HHHHHH         HHHHHH    HHHHHH         HHHHHH       HHHHHH HHHHHH      HHHHHH   HHHHHHHHHHH    HHHHHH    HHHHHH                  HHHHHH
 HHHHHHHHHHHHHHHHHHHHH    HHHHHH         HHHHHH       HHHHHH HHHHHH       HHHHH   HHHHH HHHHHH   HHHHH     HHHHHHHHHHHHHHHHHHH     HHHHHH
 HHHHHHHHHHHHHHHHHHHHH    HHHHHH         HHHHHH      HHHHHH   HHHHHH      HHHHHH  HHHHH  HHHHH  HHHHHH     HHHHHHHHHHHHHHHHHHH     HHHHHH
 HHHHHHHHHHHHHHHHHHHHH    HHHHHH         HHHHHH      HHHHHH   HHHHHH      HHHHHH HHHHHH  HHHHHH HHHHH      HHHHHHHHHHHHHHHHHHH     HHHHHH
 HHHHHHHHHHHHHHHHHHHHH    HHHHHH         HHHHHH     HHHHHH     HHHHHH     HHHHHH HHHHH   HHHHHH HHHHH      HHHHHHHHHHHHHHHHHHH     HHHHHH
 HHHHHH         HHHHHH    HHHHHH         HHHHHH     HHHHHHHHHHHHHHHHH      HHHHH HHHHH    HHHHH HHHHH      HHHHHH                  HHHHHH
 HHHHHH         HHHHHH    HHHHHH         HHHHHH    HHHHHHHHHHHHHHHHHHH     HHHHHHHHHHH    HHHHHHHHHHH      HHHHHH                  HHHHHH
 HHHHHH         HHHHHH    HHHHHH         HHHHHH    HHHHHHHHHHHHHHHHHHH     HHHHHHHHHH      HHHHHHHHHH      HHHHHHH                 HHHHHH
 HHHHHH         HHHHHH    HHHHHH         HHHHHH   HHHHHHHHHHHHHHHHHHHHH     HHHHHHHHH      HHHHHHHHH        HHHHHH                 HHHHHH
 HHHHHH         HHHHHH     HHHHHH       HHHHHH    HHHHHH         HHHHHH     HHHHHHHHH      HHHHHHHHH        HHHHHHHH               HHHHHH
 HHHHHH         HHHHHH     HHHHHHHHHHHHHHHHHHH   HHHHHH           HHHHHH    HHHHHHHH        HHHHHHHH         HHHHHHHHHHHHHHHHH     HHHHHH
 HHHHHH         HHHHHH      HHHHHHHHHHHHHHHHH    HHHHHH           HHHHHH    HHHHHHHH        HHHHHHHH          HHHHHHHHHHHHHHHH     HHHHHH
 HHHHHH         HHHHHH       HHHHHHHHHHHHHHH    HHHHHH             HHHHHH    HHHHHHH        HHHHHHH             HHHHHHHHHHHHHH     HHHHHH
 HHHHHH         HHHHHH         HHHHHHHHHHH      HHHHHH             HHHHHH    HHHHHH          HHHHHH               HHHHHHHHHHHH     HHHHHH




FAQ and Errors


The make complains the clang package as below:
 /bin/sh: 1: clang: not found
 ninja: build stopped: subcommand failed

[Solution]
 sudo apt install -y clang



if the system misses the elf library, you will get error below:
 /usr/bin/ld: cannot find -lelf
 clang: error: linker command failed with exit code 1 (use -v to see invocation)

[Solution]
 sudo apt install -y libelf-dev libssl-dev



The build lools for aarch64-linux-gnu-gcc which requires the ARM cross compiling toolchain.
 ./maple_with_ast2mpl.sh: line 44: /usr/bin/aarch64-linux-gnu-gcc: No such file or directory

[Solution]
 sudo apt install -y gcc-7-aarch64-linux-gnu
 sudo ln -s /usr/bin/aarch64-linux-gnu-gcc-7 /usr/bin/aarch64-linux-gnu-gcc



If the execution of example complains the missing command qemu-aarch64 as below, we need install the QEMU for ARM.
 ./maple_with_ast2mpl.sh: line 48: qemu-aarch64: command not found

[Solution]
 sudo apt install -y qemu-system-arm qemu-efi-aarch64 qemu-utils qemu-user



If the execution complains any one of the following errors, please check the content of the file printHuawei.out:
 Error while loading printHuawei.out: Exec format error
 Error while loading printHuawei.out: Permission denied

[Suggested Diagnosis]
 less printHuawei.out
 ls /usr/bin/aarch64-linux-gnu-gcc -l

[Possible Cause]
The /usr/bin/aarch64-linux-gnu-gcc could be linked to a wrong compiler, such as  /usr/bin/aarch64-linux-gnu-cpp-7. The correct compiler could be any of gcc compiler in your system, such as /usr/bin/aarch64-linux-gnu-gcc-7
[Solution]
 sudo ln -s /usr/bin/aarch64-linux-gnu-gcc-7 /usr/bin/aarch64-linux-gnu-gcc



Repository

https://gitee.com/openarkcompiler-incubator/mapleall

方舟编译器 runtime 参考实现 pacific 发布了 0.1 版本，支持运行基于方舟编译器的 Hello World 程序。
pacific 并不是华为官方实现，而是 PLCT 实验室的培训项目。PLCT 即“程序语言与编译技术实验室”，隶属于中国科学院软件研究所智能软件研究中心。
发布公告介绍，pacific 开发团队使用 QEMU 提供 AArch64 架构支持，将方舟编译器的 Java 环境巧妙地用 GNU/Linux 的方式仿制了这套可以跑 Hello World 程序的 Toy Runtime。
据了解，pacific 是目前业内首个方舟编译器 runtime 实现，“实现了从 0 到 1 的一个跨越”。
pacific 编译与运行方法
1、目前默认在 Ubuntu 18.04 环境下编译运行；
2、依赖于 aarch64-gun-toolchain，可以通过“sudo apt-get install gcc-8-aarch64-linux-gnu”命令安装；
3、依赖于 qemu-aarch64，可以通过源码中 pacific/script/ 下的 build-qemu-aarch64.sh 编译 qemu-aarch64；
4、使用命令行“make”，编译 pacific；
5、使用命令行“make sample”，运行 Hello World 例子，成功运行后如下图所示：
此外，可以通过调整，在 Ubuntu 16.04 环境下编译运行 pacific：
1、使用命令行“sudo apt-get install gcc-aarch64-linux-gnu”，安装 aarch64-gun-toolchain 依赖；
2、将 Makefile 之中的CROSS_AARCH64_GCC = aarch64-linux-gnu-gcc-8
修改为：CROSS_AARCH64_GCC = aarch64-linux-gnu-gcc
3、将 src/pacific.c 中 591 行的for (int idx = 0; idx 
修改为：int idx;  for (idx = 0; idx < num; idx++) {
4、其它步骤与 Ubuntu 18.04 环境的操作相同。
详情查看发布公告(阅读原文可查看跳转链接)：
https://zhuanlan.zhihu.com/p/88143491

华为方舟编译器
华为方舟编译器开源了

华为方舟编译器开源了
方舟编译器的使用教程。
有没有简单的使用方舟编译器，成功编译Android的app的教学，求链接

文章目录
环境配置
WSL2
在Windows上安装wsl2
装入依赖库
源码下载
安装Clang编译器并完成配置
安装Ninja、GN并完成配置
编译方舟编译器
编译HelloWorld
基础库准备
示例代码快速编译


Tips：本教程参照的是方舟编译器环境配置和开发者指南。这里是一些坑的总结【加粗注明】。

环境配置
Ubuntu系统、Clang编译器、Ninja、GN
WSL2
如果你不想使用虚拟机或者Linux系统，可以选择在Windows上安装wsl2。
在Windows上安装wsl2
按照微软官方教程进行安装。之后的操作和在Ubuntu上的相同
装入依赖库
使用命令：
sudo apt-get -y install openjdk-8-jdk git-core build-essential zlib1g-dev libc6-dev-i386 g++-multilib gcc-multilib linux-libc-dev:i386
sudo apt-get -y install gcc-5-aarch64-linux-gnu g++-5-aarch64-linux-gnu

这部分可能会出现Unable to locate package ***的问题，这是apt更新源的问题。主要出现在openjdk-8-jdk和linux-libc-dev:i386上。解决方法如下：
sudo add-apt-repository ppa:openjdk-r/ppa
sudo dpkg --add-architecture i386
sudo apt-get update
sudo apt-get upgrade

然后再运行上面的安装命令。
源码下载
需要注意码云上面方舟编译器已经更换了仓库地址。
git clone https://gitee.com/openarkcompiler/OpenArkCompiler.git

安装Clang编译器并完成配置
到https://releases.llvm.org/download.html#8.0.0下载对应版本的压缩包并放到openarkcompiler/tools/目录下。
打开openarkcompiler/build/config.gni文件，将GN_C_COMPILER、GN_CXX_COMPILER和GN_AR_COMPILER三个变量配置为Clang编译器所在路径。
GN_C_COMPILER = "${MAPLE_ROOT}/tools/clang+llvm-8.0.0-x86_64-linux-gnu-ubuntu-18.04/bin/clang"
GN_CXX_COMPILER = "${MAPLE_ROOT}/tools/clang+llvm-8.0.0-x86_64-linux-gnu-ubuntu-18.04/bin/clang++"
GN_AR_COMPILER = "${MAPLE_ROOT}/tools/clang+llvm-8.0.0-x86_64-linux-gnu-ubuntu-18.04/bin/llvm-ar"

打开文件后请先查看16行是否已经自动添加，如果已经添加请检查是否是自己使用的版本。其中${MAPLE_ROOT}为openarkcompiler源码根目录。这个根目录可能需要自己设定。如下情况是没有设定时的报错：

MAPLE_ROOT在文件OpenArkCompiler/build/config/BUILDCONFIG.gn的第20行。
安装Ninja、GN并完成配置
Ninja下载地址：https://github.com/ninja-build/ninja/releases
GN下载地址：https://gitee.com/xlnb/gn_binary/blob/master/gn 点击下载可能会出现乱码，右键从链接另存为文件即可。
将它们的可执行文件放置到openarkcompiler/tools下，然后修改这两个文件为可执行：
cd openarkcompiler/tools
chmod 775 gn
chmod 775 ninja

打开openarkcompiler/Makefile文件，将GN和NINJA两个变量配置为GN和Ninja可执行程序所在路径：
GN := ${MAPLE_ROOT}/tools/gn
NINJA := ${MAPLE_ROOT}/tools/ninja

打开文件后请先查看22行是否已经自动添加，如果已添加请检查是否是自己的路径。
编译方舟编译器
在OpenArkCompiler下运行此命令：
source build/envsetup.sh # 初始化环境，将OpenArkCompiler工具链路径
make # 编译OpenArkCompiler的Release版本

编译后不要关闭终端。编译完成成功截图：

编译HelloWorld
当前编译方舟编译器Sample应用需要使用到Java基础库，我们以Android系统提供的Java基础库为例，展示Sample样例的编译过程。
基础库准备
下载java-core.jar包到OpenArkCompiler/libjava-core，地址：https://gitee.com/mirrors/java-core/ 。
运行命令：
cd libjava-core
jbc2mpl -injar java-core.jar -out libjava-core

成功后OpenArkCompiler/libjava-core中会出现文件：

示例代码快速编译
这里以OpenArkCompiler/samples/helloworld为例。在根目录运行以下命令：
cd samples/helloworld/
make

运行成功截图：
   参考文档:

环境配置

开发者指南