Edit online

Ubuntu

3 Jan 2025
Read time: 2 minute(s)
Luban-Lite SDK 的开发可以在 Linux 系统中进行，Luban-Lite SDK 目前自动支持的 Linux 发行版为：
  • Ubuntu 14.04、16.04、18.04、20.04、22.04
  • CentOS 7.x、8.x

ArtInChip 推荐的 Linux 发行版为 Ubuntu 20.04 LTS（Long Term Support）版本，本节以此版本展示 Ubuntu 系统安装注意事项。如使用其他版本，需要安装软件包对应的依赖和版本。

系统安装注意事项

安装 Ubuntu 系统时，需注意以下事项：

  • 至少保留 10 GB 磁盘空间，用于保存 SDK 源码。

  • 若使用虚拟机，不建议将 SDK 放在虚拟机与实体机的共享目录。

注：
本节不涉及 Ubuntu 系统安装的详细步骤。关于详细安装流程，可查看安装 Ubuntu。

准备编译环境

Luban-Lite SDK 的开发环境中，还需要安装一些依赖包，所需关键工具的版本要求和说明如下所示：

  • Python2： 用于编译

  • SCons：自动化构建工具

  • Python3 + pycryptodomex： 用于打包和签名

依赖包的安装方法很多，本文以基于 apt 的在线安装方案为例。

  1. 资源库更新

    使用 apt 安装软件时，可能出现 http://cn.archive.ubuntu.com/ubuntu 无法访问或者访问速度较慢的情况，此时可使用境内镜像网站提供的安装包，例如 mirrors.aliyun.com。

    sudo gedit /etc/apt/sources.list   中  cn.archive.ubuntu.com 全部更换为 mirrors.aliyun.com
sudo apt-get update
  2. 安装 SCons

    Luban-Lite 选择 SCons 作为构建工具， 且同时支持对 Makefile 的调用。SCons 是一个以 Python 语言编码的自动化构建工具，是 Make 经过改进后的替代品，可跨平台使用。 

    sudo apt install SCons
  3. 安装 pycryptodomex

    pycryptodomex 是 Python 的一个加密库，可以通过 pip 安装 whl 文件， 或通过源码编译安装。SDK tools/env/local_pkgs/ 中内置了 pycryptodomex 源码。

    pycryptodomex 的两种安装方式都需要安装 pip 来提供相应的组件。Ubuntu20.04 默认安装 python3-pip。Pip 安装命令如下：

    sudo apt install pip
cd tools/env/local_pkgs/
tar xvf pycryptodomex-3.11.0.tar.gz
cd pycryptodomex-3.11.0
sudo python3 setup.py install

开始编译

进入 Luban-Lite 根目录， 使用 SCons 进行编译，并校验环境是否搭建成功。
注：
关于 SCons 命令的详细使用说明，可查看scons 命令参考指南。
  1. 执行下列命令查看所有配置信息：
    scons --list-def
  2. 执行下列命令应用具体配置，比如 0 号配置：
    scons --apply-def=0
  3. 执行下列命令进行编译：
    scons
OneStep 命令

OneStep 是 ArtInChip 对 SCons 工具二次封装的总称，是在基础命令上开发的一组更高效和方便的快捷命令， 以实现任意目录、一步即达的目的。

在 Ubuntu 终端中，进入 SDK 根目录后，使用 sourcetools/onestep.sh 命令即可查看所有常见命令。关于 OneStep 详细的使用说明，可查看 OneStep 命令参考指南。