搭建编译环境

• 1.1. 搭建编译环境
• 1.2. 选择代码分支配置
• 1.3. 设置 Linux 编译环境
• 1.3.1. 64-bit Ubuntu 系统
• 1.3.2. Docker
• 1.3.3. 在容器中运行Docker镜像
• 1.3.4. 配置USB使用权限
• 1.3.5. 下载源码

1.1. 搭建编译环境

这里介绍如何设置本地工作环境来编译 RokidOS 开源项目。目前只支持 Linux OS。

1.2. 选择代码分支配置

如果您需要使用最新的开发中的 RokidOS 代码，您可以选择 rokidbase.xml 来编译目前最新的代码，我们的对外代码服务器，在每天凌晨4点会同步到对外访问服务器上。

如果您需要使用经过发布测试的 RokidOS 代码，请您选择我们对外发布列表中，指定有效的 REL 版本的 manifest 配置文件。

1.3. 设置 Linux 编译环境

RokidOS 提供2种编译环境: 64-bit Ubuntu 系统 和 Docker

1.3.1. 64-bit Ubuntu 系统

1. 安装 Ubuntu (>= 14.04) 64位系统。
2. 安装编译必须的软件包：

        sudo apt-get install git-core gnupg cscope ctags libz-dev libexpat-dev \
          python language-pack-en texinfo \
          build-essential g++ git bison flex unzip \
          libssl-dev libxml-simple-perl libxml-sax-perl libxml2-dev libxml2-utils xsltproc \
          wget bc ccache curl libc6-dev-i386 lib32ncurses5-dev lib32z-dev
   

注意：buildroot 编译 cmake 过程中，如果 OpenSSL 为1.1.0会出现报错，建议各位开发者使用1.0.1f的 OpenSSL 版本。

1.3.2. Docker

为了统一编译环境，现提供Docker镜像，用户可直接获取Docker镜像进行编译

添加Docker国内镜像

因Docker国外源速度缓慢，建议用户添加Docker国内镜像加速。网址如下

https://www.docker-cn.com/registry-mirror

拉取RokidOS编译镜像

docker pull siokagami/rokidos-linux-make:v0.3.0

1.3.3. 在容器中运行Docker镜像

 docker run -it -v {宿主中代码的绝对路径}:/home/rokidos siokagami/rokidos-linux-make:v0.3.0

进入容器中，执行编译指令

cd /home/rokidos
source rokid_br_external/build/setenv.sh
lunch

根据硬件选择编译环境。具体见编译章节。

1.3.4. 配置USB使用权限

为了方便开发者开发过程中对设备软件进行更新或系统配置，我们在 RokidOS 系统上移植了Android的adb服务，为保障您能正常使用 adb 连接到设备，请您按照USB 设备识别配置中介绍的方法来配置您的系统，让 Ubuntu 能正确识别RokidOS 的开发板。

1.3.5. 下载源码

编译环境配置完成，接下来就可以下载源代码了。