前阵子帮一个做嵌入式测试的团队迁移开发环境他们把旧工具链换成 Arm Development Studio 的时候光是安装加激活就折腾了两三天。换到另一台 Linux 机器又踩了一遍完全不同的坑。这大概是很多准备从 DS-5 或者开源 GCC 工具链切换过来的团队都会遇到的问题Arm Development Studio 功能确实全面但它的跨平台安装、许可证激活和工具链配置往往缺一份能照着一步到底的完整说明。这篇文章我就把在 Windows 和 Linux 两台机器上从下载、安装、激活到跑通一次完整编译的整个过程都写出来顺便把中间容易卡住的地方标记清楚给后面准备自己动手装的人做个参考。这篇文章适合这么几类人看一是刚从 DS-5 或 IAR/Keil 迁移过来的嵌入式工程师二是要负责给团队统一部署开发环境的技术负责人三是只想用 Arm Compiler 6 做命令行交叉编译、不打算开图形界面的同学。我会尽量把原理和操作分开讲不想看原理的人可以直接照着操作步骤走。1. 安装前真正要花时间做的事版本、许可证与系统门槛很多人习惯把安装包下载下来直接双击开始装但 Arm Development Studio 这个工具不太一样。它的安装过程本身不难难的是安装之前的版本选择和许可证模式理解。这两个事情没搞清楚后面大概率会在激活环节或者跑编译的时候被卡住。1.1 版本和组件别下载错Arm Development Studio 的前身是 DS-5现在迭代到大概是 2024.x 版本Arm 官网的开发者专区可以直接下载。官网下载页面通常会给两个平台的主安装包Windows 64 位和 Linux 64 位。这里有一个容易误会的点虽然叫跨平台但 Arm Development Studio 一般没有原生 macOS 版本如果你团队里有同事用的是 Mac要么用虚拟机要么就老老实实在服务器上装 Linux 版远程使用。下载之前还要搞清楚套件里包含哪些核心组件避免装完发现少东西。一个完整的 Arm Development Studio 大致包括下列内容Arm Compiler 6Arm 官方的 C/C 编译工具链这是最核心的东西。Arm Debugger调试器支持通过 DSTREAM、ULINK 等调试探针连接目标板。Arm Streamline性能分析工具主要用于优化 CPU 和 GPU 利用率的场景。Fixed Virtual PlatformsFVP虚拟仿真平台不需要真实硬件就能跑软件。Arm Mobile Studio面向移动设备的图形和性能分析工具套件。下载的时候建议直接去 Arm 官网的 developer.arm.com 下载中心用 Arm 账户登录后选择对应版本。不要从第三方下载站找资源那些渠道要么捆绑了旧版本要么文件不完整安装到一半报错很难排查。1.2 许可证模式先弄明白后面能省很多事许可证是 Arm Development Studio 安装流程里最容易出问题的一环。它的许可证不是简单的一个注册码而是分好几种模式。常见的三种值得提前理解许可证类型绑定方式典型使用场景评估许可证Evaluation绑定到 Arm 账号有天数限制个人评估、试用节点锁定许可证Node-locked绑定一台机器的 Host IDMAC 地址等固定工作站的个人开发浮动许可证Floating部署在许可证服务器上按并发数共享团队共享、流水线构建我见过不少人直接在 IDE 里看到报错就去改环境变量改了半天才发现自己拿的是浮动许可证却用节点锁定的激活方式去处理路径完全错了。所以第一步一定是确认你拿到的许可证类型再决定下面的操作方式。官方通常在你购买产品或申请试用后会发一封包含 License ID 或 license 文件下载链接的邮件先找到这封邮件后面激活会轻松很多。1.3 系统级前置条件Windows 和 Linux 各看什么在动手安装之前先检查一下系统环境。Arm Development Studio 比较吃资源而且对系统版本有一定要求这里列一个保守的底线配置磁盘空间至少预留 10 GB 以上。内存建议 16 GB8 GB 也能跑但打开大工程加上调试会话会明显卡顿。CPUx86_64 架构的 Intel/AMD 处理器没有硬性要求。Windows 这边官方一般要求 64 位 Windows 10/11安装前建议把系统更新到较新的版本顺便装好 Visual C Redistributable x64。很多 IDE 启动闪退的问题其实不是 Arm Development Studio 的问题而是 Windows 缺了这组运行库。Linux 这边的检查项就不一样了。发行版推荐 Ubuntu 20.04/22.04 LTS 或 RHEL 8/9本质上不要用太激进的新版本因为开发套件对 glibc 和图形库的版本非常敏感。装到 Ubuntu 24.04 这类比较新的发行版上如果官方还没有做过适配经常会出现 GUI 起不来或者某个动态库找不到的情况。下面章节里我会把依赖库的坑单独展开说。2. Windows 安装全流程从安装包到第一次启动Arm Development Studio 在 Windows 上的安装算是比较省心的毕竟有安装向导。但我实际装过几次之后发现省心不代表没坑主要的坑集中在下载文件的选择、安装路径规划和组件取舍上。2.1 下载与准备管理员权限和目录规划下载完成后你会得到一个类似 DS2024.x-win64.exe 的安装程序。安装的时候务必右键选择“以管理员身份运行”。这个步骤看起来多余但如果不做后面安装服务组件或者写注册表的时候可能会静默失败整个安装过程显示成功实际跑起来却各种异常。安装路径规划上我的建议是别放在默认的 C:\Program Files\Arm 之外带空格的目录里也不要用中文目录。虽然新版工具对路径空格兼容得不错但后续如果要在命令行里拼交叉编译的路径带空格的目录始终是个隐患。我一般习惯装在 D:\Arm\DS2024.0 或 C:\Arm\DS2024.0 这种简洁路径下后面写脚本、设置环境变量都省事。值得一提的是安装向导中途会让你勾选要安装的组件。如果是给生产环境用建议全选尤其是 FVP 虚拟仿真平台很多后期验证脚本会依赖它。如果只是单纯想用命令行编译器不打算打开图形界面那可以只保留 Arm Compiler 6其余组件统统不勾安装体积能缩小不少。2.2 安装过程中的组件取舍与勾选项安装向导里还有两个容易忽略的勾选项。第一个是 “Add shortcuts to PATH” 或者自动配置环境变量之类的选项注意看清楚有些版本会给 IDE 的启动器加 PATH但不会给 armclang 加 PATH这两个不是一个东西。第二个是自动更新选项离线环境或者受限网络环境下最好关掉自动更新否则每次启动IDE都会卡在检查更新上非常影响体验。整个安装过程大概需要 10 到 20 分钟取决于磁盘速度和组件数量。安装完成后开始菜单里会出现两组常用的入口一个是 Arm Development Studio IDE 主程序另一个是 Arm License Manager 许可证管理器。这两个入口后面都会用到。安装完成后先用命令验证一下编译器是否能够正常工作。打开命令行进入安装目录下的编译器子目录一般路径是cd C:\Arm\DS2024.0\sw\ARMCompiler6.x\bin armclang --version如果能看到版本信息说明安装成功。如果提示找不到命令要么不是这个子目录要么需要把路径加到 PATH 环境变量里。2.3 第一次启动前的环境确认第一次启动 IDE 前我建议先顺手把 ARM_LICENSE_PATH 或者 ARMLMD_LICENSE_FILE 环境变量确认一下也可以在激活完成后再做这里先提个醒。第一次启动 Arm Development Studio 时它会让你选择一个 workspace 目录。这个目录用于存放工程元数据和配置不要选在临时目录或者安装目录里最好放在独立的数据盘。我见过有人把 workspace 放在管理员临时目录下重启系统后配置全丢重新配了一下午。Windows 上还有个高频问题IDE 启动后卡死在欢迎页。这多半是 Windows 显示缩放比例和 Eclipse 框架不兼容或者显卡驱动太老。遇到这种情况可以右键快捷方式 → 属性 → 兼容性 → 更改高 DPI 设置把“替代高 DPI 缩放行为”设置为“应用程序”。这个修法不保证对每个版本都有用但在几个 2023/2024 版本上实测有效。3. Linux 安装全流程依赖问题才是真正的分水岭如果说 Windows 安装是轻松模式Linux 安装就是标准难度模式。难的不是解压和运行而是系统依赖库。很多人在 Linux 上装完却起不了 IDE十有八九是缺了图形库或者系统库。3.1 发行版选择和系统库依赖Arm Development Studio 的 Linux 版本做得比较“国企风”它会针对特定发行版提供不同的安装包格式。常见的格式有.tar.gz通用的绿色解压包不依赖包管理器。.rpm适用于 RHEL、CentOS、Rocky Linux。.deb适用于 Ubuntu、Debian。下载时尽量选对应发行版的格式。如果用的是 Ubuntu直接下载 .deb 格式当然方便但更稳妥的是下载 .tar.gz 通用包因为通用包会把你需要的组件打包得更完整不太依赖系统的软件源。依赖库方面容易踩坑的几个库名如下libncurses5 / libncurses5-dev老版本编译器工具链可能会依赖。libxtst6Eclipse 图形界面的输入事件依赖。libxrender1、libxext6图形渲染相关。libgtk2.0-0 或 libgtk-3-0新版工具可能要求 GTK3。Ubuntu 22.04 上可以用一行命令装基础依赖sudo apt update sudo apt install -y libncurses5 libncurses5-dev libxtst6 libxrender1 libxext6 lsb-core如果 apt 提示 libncurses5 找不到说明你的 Ubuntu 版本太新软件源里已经没有这个老包了。一个常见的办法是把老版本的 deb 包下载下来手动安装或者切换到 Ubuntu 20.04 的软件源安装后锁定版本。这里要提醒一句不要随便在网上找一个编译好的 .so 文件丢进系统目录架构不匹配或者 glibc 版本不匹配会让系统程序崩溃风险非常大。3.2 解压安装与目录权限管理以 .tar.gz 为例我通常这样安装sudo mkdir -p /opt/arm sudo tar xzf DS2024.x-linux64.tar.gz -C /opt/arm cd /opt/arm ls -l解压后你可能会看到一个 install.sh 或 版本名 目录。有些版本需要手动执行安装脚本来完成字体安装、菜单创建等收尾工作有些版本则不需要直接运行目录下的可执行文件即可。建议执行一下安装脚本它会提示你还缺哪些系统库比你手动启动 IDE 看报错要直观得多。关于目录权限一个关键建议是不要用 root 直接运行 IDE也不要把安装目录的所有者改成自己的个人账户。比较合理的做法是sudo chown -R root:root /opt/arm sudo usermod -aG armuser 你的用户名 # 如果安装脚本创建了专用用户组IDE 运行时只需要写自己的 workspace 和配置目录不需要写安装目录。用 root 运行 IDE 会在后续调试时遇到权限相关的诡异问题尤其是调试器访问 USB 设备的时候。3.3 让命令行工具链全局可用的配置方法安装完成后我还习惯把命令行工具链配置到全局 PATH 里这样不管在哪个目录下都可以直接调用 armclang、armlink、armdbg 等命令。先找到实际的工具链目录find /opt/arm -name bin -type d通常编译器的 bin 目录长这样/opt/arm/DS2024.0/sw/ARMCompiler6.x/bin。把它追加到 ~/.bashrc 或 ~/.zshrc 里export PATH/opt/arm/DS2024.0/sw/ARMCompiler6.x/bin:$PATH除此之外许可证相关的环境变量也需要设置。把你准备好的 license 文件路径写进去比如export ARMLMD_LICENSE_FILE/opt/arm/licenses/arm_license.dat如果不设置这个变量IDE 启动时会提示找不到许可证虽然也能进图形界面但一旦编译就会立即报许可错误。我建议在安装激活章节看完后再一起配免得配错路径来回折腾。4. 许可证激活官方流程一步步操作许可证激活是整个流程里最容易被卡住的环节。好消息是Arm 官方给的激活机制已经比前几年成熟不少照着官方流程走基本不会有大问题。下面我会按最常见的三种许可证方案分别说明操作路径。4.1 方案选择评估版、节点锁定版还是浮动版先做选择题。如果是个人学习评估你应该在 Arm 官网上申请评估许可证。官网会给一个 License ID这个 ID 相当于一把初始化钥匙。拿到后在 IDE 或者 License Manager 里输入该 ID工具会自动连接 Arm 的许可证服务完成激活。评估版通常有 30 天有效期到期后需要续期或者购买正式版。如果是团队采购的浮动许可证流程会稍微复杂一点。你们公司一般会有一台许可证服务器部署了 Arm License Server。你不需要在自己机器上保存 .lic 文件只需要知道服务器的 IP 地址和端口。举例来说许可证服务器的地址可能需要填成 27000192.168.1.10 这样的格式其中 27000 是默认的端口段起始值具体以负责许可证服务器的同事提供的地址为准。激活时把 ARMLMD_LICENSE_FILE 设置为这个网络地址或者通过图形界面的“Floating License”选项填入。如果是节点锁定许可证那你要做的是把本机 Host ID 提供给 Arm 官方许可系统由官方生成一个绑定到你机器的 .lic 文件。Host ID 怎么查打开 Arm License Manager界面上一般会直接显示。不同操作系统显示方式略有不同但本质上工具会读取机器的网络接口 MAC 地址并生成一个标准的许可证主机标识。这个动作一定在做形成 license 文件的机器上操作别在别人的电脑上查了 Host ID 然后填到自己账号里生成的 .lic 文件拿到自己的机器上往往会因为 Host ID 不匹配而无效。4.2 用 Arm License Manager 完成激活拿到 License ID 或 .lic 文件后启动 Arm License Manager。界面上一般会有 “Add License” 或 “Activate” 按钮。选 .lic 文件方式时文件路径中不要有中文或特殊字符许可证文件里包含的主机标识会自动和当前机器比对。成功导入后列表里会出现一条新的许可证记录状态显示为有效Valid。选 License ID 方式时工具会向 Arm 的许可证服务发起请求。这个过程中本机必须能正常访问 Arm 官网的许可证服务接口如果是在内网受限环境这一步常常超时。遇到超时可以改用 .lic 文件方式让负责授权的同事在官网生成好文件再发过来。还有一种比较常见的情况是团队使用浮动许可证License Manager 里填写的是 server:port 格式。这部分完全依赖网络连通性本地无需保存 license 文件。需要注意的是浮动许可证会占用并发名额用完记得释放否则同事那边会提示没有可用席位。所以一般不建议在调试机器上长期挂着浮动许可证不退出。4.3 激活是否生效的三层验证激活完成后不要急着庆祝做三层验证再收工。第一层验证是许可证管理器状态。打开 Arm License Manager确认许可证记录的状态是有效且不是过期状态。如果显示无效把 ARMLMD_LICENSE_FILE 的路径检查一遍。第二层验证是命令行编译。写个最简单的 C 文件int main(void) { return 0; }然后执行armclang --targetaarch64-none-elf -c test.c -o test.o如果能成功生成 test.o说明编译器已经正常通过许可证校验。这一步能同时验证工具链路径、目标平台选择、许可证识别三件事。第三层验证是图形界面里新建工程编译。启动 Arm Development Studio新建一个简单工程选择你目标开发板对应的平台执行构建。如果这一步能跑通说明 IDE 配置、工程模板和许可证在图形界面里也都正常。经验之谈三层验证里最实用的就是第二层。因为很多图形界面问题不影响命令行工具链而所有自动化构建脚本最终都是走命令行命令行能过说明核心功能是可用的。5. 安装激活后必然碰到的几个报错装完之后几乎没有人能完全避开报错。我把几个高频问题的排查链路写下来遇到的时候照着走一遍比盲目重装要快得多。5.1 IDE 起不来、闪退先看两处日志Linux 下双击启动脚本没有任何反应是最常见的问题。这时候先不要急着重装打开终端手动启动 IDE通常会把缺失库的错误直接打印到终端里。比如看到类似 libXtst.so.6 cannot open shared object file那就说明缺 libxtst6 包补装即可。如果手动启动时终端没有输出但进程就是起不来看一下这两个日志目录~/.ds/ 或 ~/.arm/ 下的配置文件目录IDE 工作空间下的 .metadata/.log 文件用 tail 命令查看最后几十行通常会记录到启动过程的哪个阶段崩溃。我遇到过的情况里最多的是图形库冲突。有的 Linux 发行版自带 Wayland而 Arm Development Studio 基于 Eclipse 框架在 Wayland 会话下的兼容性不如 X11。解决办法是启动前切换会话为 Xorg或者设置环境变量强制使用 X11 后端。5.2 编译器找不到和许可证识别失败命令行执行 armclang 提示 command not found这个最简单纯粹是 PATH 没配好。确认一下 bin 目录路径是否正确即可。另一种常见现象是 armclang 在但一执行就报许可证错误。这种报错信息会分两类。一类是 “Cannot locate license”这表示工具不知道去哪里找许可证文件检查 ARMLMD_LICENSE_FILE 的值另一类是 “License has expired” 或 “License invalid host”这表示工具找到了 license 但校验不通过要么是 license 过期要么是 Host ID 和 .lic 文件里写的不一致。如果确认了许可证文件没问题但工具依旧报错可以试一下在命令行里显式指定许可证文件ARM_LICENSE_PATH/path/to/license.dat armclang --version很多版本优先读取 ARM_LICENSE_PATH 而不是 ARMLMD_LICENSE_FILE两个变量名不一样这点非常坑。最彻底的办法是把两个都配到环境变量里内容指向同一个文件。5.3 调试器连不上目标板从接线到权限调试器连接失败的问题往往比前两类更让人头大因为它的变量很多调试探针、目标板、驱动、权限、工程配置任何一个环节出问题最终表现都是连接失败。我的排查顺序是固定的从物理层往上层走确认调试探针和目标板的 JTAG/SWD 线序正确SWD 模式下至少确认 SWDIO、SWCLK、GND 三根线接通。确认目标板上电。这个听起来废话但我真遇到过因为板上电源灯被线挡住没看见白白排查了半小时的情况。确认 PC 识别到了调试探针。Windows 下看设备管理器是否有未知设备Linux 下用 lsusb 查询。确认 debug 配置里选择的调试器型号正确SWD 还是 JTAG 模式与硬件实际接线一致。确认权限。Linux 下访问 DSTREAM/ULINK 需要 usb 设备权限用户最好加入 plugdev 或 dialout 组然后重新登录会话。最后才去怀疑工程配置里的芯片型号、访问端口地址等参数。另外还有一个容易被忽视的场景FVP 虚拟仿真平台的调试和真实开发板的调试配置不是同一个工程模板。如果你只是装了 FVP却拿开发板的 debug configuration 去连接自然会失败。反过来在 FVP 上跑软件验证用的也是单独的启动脚本两者不要混用。最后分享一个我自己养成的习惯。每次装完 Arm Development Studio我都会先把命令行编译验证跑通再打开图形界面。这个顺序保证了你手头始终有一条不依赖 GUI 的可用工具链。后面不管 IDE 怎么折腾、workspace 怎么换需要快速构建的时候一条命令就能解决问题。顺便说一句如果你整个团队都要用这个工具建议把 license 文件放在一个固定的共享目录由专门的人统一维护比每人各自管理一份环境变量配置要省心得多。
