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 系统
- 安装 Ubuntu (>= 14.04) 64位系统。
- 安装编译必须的软件包:
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. 下载源码
编译环境配置完成,接下来就可以下载源代码了。