使用预构建的系统部署

提示

请注意，本文只为Windows x64平台提供预购建的虚拟机镜像。若您使用的是Linux或MacOS，您需要手动安装开发环境，请阅读系统要求。

本文旨在介绍使用预构建的系统来部署XMOS XTC 15（XMOS Toolchain）工具以简化用户的搭建过程。这些预构建系统文件提供了包含预安装的Ubuntu系统、已配置的XMOS开发环境以及图形IDE的完整环境。

我们提供这些预构建系统的目的是为了让用户能够迅速搭建XTC工具的编译环境，减少设置和配置的时间，并且确保环境的一致性。使用这些预构建系统，用户可以立即开始使用XTC工具进行开发，无需手动安装和配置各种软件和工具。

然而，如果用户希望使用其他方式搭建XMOS XTC工具的编译环境，我们也提供了详细的文档以供参考。您可以参考系统要求开始的文档进行配置。

版本特性比较

下表对比了预构建的XMOS XTC工具不同版本的特性：

虚拟机容器	图形界面	XMOS开发环境预配置	IDE支持	预构建大小（压缩包）	性能
VirtualBox	有	是	内置	~5.9GB	不错
VMware	有	是	内置	~4.5GB	好
WSL2	无	是	需要主机安装	~2.3GB	最好

请根据实际需求选择适合的版本进行部署。

部署步骤

VMware 或 VirtualBox

以下是使用预构建系统部署XMOS XTC工具的一般步骤：

下载合适版本的虚拟机系统文件，根据需要选择VMware 或 VirtualBox版本。
- VMware-ubuntu-22.04
- VirtualBox-ubuntu-22.04（文件较大，下载多个分页压缩包）
安装对应的虚拟机客户端（如VirtualBox或VMware Player/Workstation）。
- VMware Workstation Pro 17；激活方式
- Oracle VM VirtualBox
解压虚拟机文件，并导入虚拟机系统文件到虚拟机客户端中（仅适用于VirtualBox和VMware版本）。
- 对于VMware，点击打开虚拟机，打开 Ubuntu 22.04 pawpaw.vmx 即可
- 对于VirtualBox，解压虚拟机镜像时，需要选中7z.001与7z.002文件，右键用7z解压。
  
  然后在VirtualBox中点击注册，打开 Ubuntu 22.04 pawpaw.vbox 即可
启动虚拟机，在Ubuntu系统中运行XMOS开发环境。默认情况下，开机会启动VSCode，并打开XMOS-SDK-zh_CN

虚拟机账户密码
pawpaw 123
root 123
（可选）打开图形IDE进行开发，IDE为便携版本的VScode，打开终端输入：
```
~/VSCode-linux-x64/code
```
（可选）您可以更改虚拟机的配置，以获得更好的内存与性能。默认的配置为4core@4GB RAM。

虚拟机账户	密码
pawpaw	123
root	123

WSL2

wsl2的安装需要您的操作系统版本在Windows 10 1903版本以上（包含Windows 11），并支持虚拟化。我们在此提供简单的安装步骤，所有命令均在Powershell(使用管理员权限)中运行：

安装WSL并开启Windows功能

wsl --install
dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart
dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart
wsl --set-default-version 2

重启系统
下载并安装适用于 x64 计算机的 WSL2 Linux 内核更新包
更新WSL
```
wsl --update
```
下载并安装我们提供的WSL2预构建系统压缩包：Ubuntu-22.04-pawpaw-WSL.tar，将 C:\$YourWorkspace 改成存放ubuntu系统的路径，.\Ubuntu-22.04-pawpaw-WSL.tar为镜像压缩包的路径：
```
wsl --import Ubuntu-22.04-pawpaw C:\$YourWorkspace .\Ubuntu-22.04-pawpaw-WSL.tar
wsl --set-default Ubuntu-22.04-pawpaw
```
验证你的安装：
```
wsl

PS C:\Users\yourname> wsl
root@localhost:/mnt/c/Users/yourname#
```
提示
注意，对于导入的WSL2系统，Windows默认会将Root用户作为登录的默认用户，您可以通过修改注册表来更改默认用户
- 使用 regedit 打开注册表编辑器（通过“运行”打开）
- 找到 HKEY_CURRENT_USER\Software\Microsoft\Windows\CurrentVersion\Lxss 键
- 检查每个子键的 DistributionName 值，找到你的WSL2系统的名称，在这里应该是 Ubuntu-22.04-pawpaw
- 找到你的WSL2系统的 DefaultUid 键，将其值改为你想要的用户的UID，对于我们为你默认创建的pawpaw用户，UID为1000
- 重启WSL2系统 wsl --shutdown
（可选）在Windows中下载并使用我们提供的便携版VSCode编辑器，该编辑器已针对XMOS开发环境配置：
- 打开Code.exe
- 点击VSCode左下角远程主机连接到WSL
- 打开文件夹
- 打开目录 /home/pawpaw/projects/XMOS-SDK-zh_CN/
  
  账户密码
  pawpaw 123
  root 123
在WSL2环境下，WSL会自动调度所需的内存与核心，以获得最好的性能。

账户	密码
pawpaw	123
root	123

下一步

关于如何将XTAG调试器连接到虚拟机，请查阅安装指南#在虚拟机中使用XTAG。

FAQ

Q：ubuntu虚拟机网络失去连接

A：通常是因为NetworkManger缓存导致的问题，手动重启并删除缓存即可解决：
```
sudo service NetworkManager stop 
 
sudo rm /var/lib/NetworkManager/NetworkManager.state 
 
sudo service NetworkManager start
```

版本特性比较​

部署步骤​

VMware 或 VirtualBox​

WSL2​

下一步​

FAQ​

版本特性比较

部署步骤

VMware 或 VirtualBox

WSL2

下一步

FAQ