跳到主要内容

SDK 开发虚拟机搭建

本文帮助您搭建 Tina Linux SDK 的编译环境。如果您没有 Ubuntu 主机，可以通过虚拟机在 Windows/Mac 上运行 Ubuntu 系统，完成 SDK 编译。

本文提供两种搭建方式：

  • 方式一：自行安装 — 从零开始安装 VirtualBox 和 Ubuntu 虚拟机，适合想完全掌控环境的用户
  • 方式二：使用预配置虚拟机 — 直接导入官方提供的已配置好的 Ubuntu 虚拟机，适合新手快速上手
已有 Ubuntu 环境？

如果您已有 Ubuntu 主机环境，可直接跳转至 【SDK 编译环境配置】 文档安装编译依赖。

编译环境要求​

Tina Linux SDK 在 Ubuntu 系统上开发和测试，推荐使用 Ubuntu 作为编译环境。

支持的 Ubuntu 版本：14、16、18、20、22、24、26

其他 Linux 发行版由于未进行测试，且软件包管理器、软件版本和功能的差异，可能导致编译报错等问题。不推荐使用。

架构限制

仅支持 x86_64 (AMD64) 架构，不支持 ARM 架构（如 Apple Silicon Mac、ARM 笔记本等）。

原因：Tina SDK 中的预编译工具链（交叉编译器、打包工具等）仅提供 x86_64 版本，无法在 ARM 架构上运行。

如果您使用 ARM 架构设备，建议：

  • 使用云端 Linux 服务器（x86_64 架构）
  • 使用远程编译服务器

推荐的虚拟机配置：

配置项推荐值说明
内存≥ 12GB编译过程需要较大内存
虚拟硬盘≥ 100GBSDK 及编译产物占用较大空间
CPU 核心≥ 4核多核心可加快编译速度

方式一：自行安装虚拟机​

下载安装 VirtualBox​

VirtualBox 是一款免费开源的跨平台虚拟机软件，支持 Windows、Mac、Linux。

官网下载：https://www.virtualbox.org/

安装教程参考：VirtualBox 安装教程

安装 Ubuntu 虚拟机​

VirtualBox 安装 Ubuntu 的完整教程可参考：VirtualBox 安装 Ubuntu 环境

安装时的关键配置要点：

  1. 内存大小设置：建议大于 2GB
  2. 虚拟硬盘大小设置：建议至少设置 50GB（SDK 所需较大空间）
  3. 安装好 Ubuntu 虚拟机环境后，建议不要在线升级 Ubuntu 版本

配置增强功能​

安装增强功能可以获得以下便利：

  • 共享粘贴板 — 在 PC 和虚拟机之间复制粘贴文本
  • 共享文件夹 — 在主机创建文件夹，映射到虚拟机中访问
  • 更好的显示支持 — 自动调整虚拟机窗口大小

安装步骤​

  1. 启动虚拟机，进入 Ubuntu 系统
  2. 点击菜单栏 设备 → 安装增强功能
  3. 虚拟机光驱自动加载 VBoxGuestAdditions.iso
  4. 点击弹出的 Run 按钮
  5. 按提示完成安装，重启虚拟机

另一种方法：在 Linux 中手动挂载光驱安装，参考 挂载光驱教程

配置共享文件夹​

参考教程：VirtualBox 共享文件夹设置

注意

SDK 下载目录不要设置在共享文件夹中。如果共享文件夹挂载的是 Windows 系统，可能无法正常下载 Tina SDK 代码。

解决权限问题​

共享文件夹可能因权限问题无法访问，执行以下命令添加用户到 vboxsf 组：

sudo usermod -aG vboxsf $(whoami)

执行后需重启虚拟机生效。

方式二：使用预配置虚拟机​

如果您不想从零配置环境，可直接使用官方提供的已配置好的 Ubuntu 20.04 虚拟机。

获取虚拟机​

项目内容
下载地址Ubuntu20.04.ova（约6GB）
系统Ubuntu 20.04
用户名allwinner
密码Pass123456
密码说明

密码是 Pass123456，不是 123456。前面的 Pass 也是密码的一部分。

虚拟机已包含：

  • 编译 Tina Linux 所需的依赖包
  • 交叉编译工具链
  • apt 配置了清华源（软件下载更快）

虚拟机未包含（需自行配置）：

  • Tina Linux SDK（见后续文档）
  • repo 脚本
  • NPU 工具链

导入虚拟机​

  1. 安装 VirtualBox（推荐）或 VMWare WorkStation
  2. 双击下载的 Ubuntu20.04.ova 文件

双击打开 OVA 文件

  1. 在配置页面设置虚拟机参数（可调整内存、CPU核心数）

配置虚拟机参数

  1. 点击 导入，等待导入完成（虚拟机较大，可能需要几分钟）

开始导入

导入进度

  1. 导入完成后，点击 启动 运行虚拟机

启动虚拟机

配置增强功能​

导入后需配置增强功能以获得更好的使用体验。

  1. 启动虚拟机，输入密码 Pass123456 登录

登录系统

  1. 点击菜单 设备 → 安装增强功能

安装增强功能

  1. 点击弹出的 Run

运行安装

  1. 输入密码 Pass123456 确认

输入密码

  1. 安装完成后按回车关闭窗口

安装完成

  1. 重启虚拟机

重启虚拟机

配置便捷功能​

重启后，配置以下功能提高开发效率：

  1. 设置 共享粘贴板为双向

设置共享粘贴板

  1. 设置 拖放为双向

  2. 配置 共享文件夹（可选）

配置共享文件夹