RuyiSDK Eclipse 插件安装与使用笔记

General
1

一、背景

之前已经完成了 RuyiSDK 的初次安装与使用，ruyi 本体是通过 pip 方式安装的，也已经体验过 VS Code 插件。本次主要想继续测试 RuyiSDK 的 Eclipse 插件，并记录一个从零接触 Eclipse 的新手视角安装与使用过程。

本次目标：

1. 在 WSL Linux 图形环境中安装并启动 Eclipse

2.安装 RuyiSDK Eclipse 插件，并验证是否能够完成一个最小 Hello World 示例

二、实测环境

主机环境

  • Windows

  • WSL2

  • Linux 图形界面可正常使用

前置状态

  • 已安装 ruyi

  • ruyi version 可正常输出版本信息

  • DISPLAY / WAYLAND_DISPLAY 正常，说明 WSL GUI 通路正常

本次 Eclipse 插件相关流程参考了 RuyiSDK 官方 IDE 文档与 Hello World 示例文档。官方示例流程中，推荐通过 Eclipse / RuyiSDK IDE 创建项目、创建 venv、再执行 Apply to Project 和构建运行。

411176d6a40cde99d2e2a8a265b8b4c3
411176d6a40cde99d2e2a8a265b8b4c31375×534 15.5 KB

三、对 Eclipse 的理解

在这次实测前，我本人没有接触过 Eclipse。实际体验下来，可以先把它理解为：

一个本地 IDE 平台，本身提供基础开发界面，再通过插件扩展功能。

这次测试中的 RuyiSDK Eclipse 插件，本质上就是安装在 Eclipse IDE 里的插件，而不是独立软件。RuyiSDK 官方文档和插件发布页都说明了这一点。

四、安装 Eclipse

1. 没有继续使用 Eclipse Installer

一开始尝试通过 Eclipse Installer 在线下载安装，但下载速度非常慢，而且 Installer 后续还需要继续联网拉取组件，整体体验不太稳定。

因此后续改为：

  • 直接下载 Eclipse IDE for Embedded C/C++ Developers

  • 选择 Linux x86_64 版本

  • 在 WSL 中解压运行

908a5a82d72c577d560c239d3f9def25
908a5a82d72c577d560c239d3f9def252346×1222 91.5 KB

2. 本次使用的 Eclipse 包

下载的是：

eclipse-embedcpp-2026-03-R-linux-gtk-x86_64.tar.gz

这个包比普通 C/C++ Developers 版更适合嵌入式/RISC-V 场景。官方 packages 页也给出了该版本。

3. 启动方式

在 WSL 中解压后，进入 Eclipse 目录执行：

cd ~/Downloads/eclipse
./eclipse &

首次启动时选择 workspace，例如：

/home/selene/workspace/eclipse-ruyi

五、安装 RuyiSDK Eclipse 插件

1. 在线安装遇到的问题

一开始尝试通过：

Help -> Eclipse Marketplace...

搜索 ruyisdk 安装插件。

可以搜索到插件，也能看到安装确认页面，但在真正拉取仓库内容时失败，报错大致为：

Unable to read repository ...
Network is unreachable

进一步在终端中测试 ruyisdk.github.io 的 content.xml 时，也存在连接被重置/无法访问的问题，因此判断这一步不是 Eclipse 本身的操作错误，而是当前 WSL 网络环境访问插件仓库存在问题。

bb03094db1c5b68375f696f169b624c1
bb03094db1c5b68375f696f169b624c12346×1222 113 KB

2. 改用离线安装

后续改为使用 GitHub Releases 页面提供的离线安装包：

ruyisdk-eclipse-plugins-0.1.3.zip

3. 离线安装步骤

在 Eclipse 中依次点击：

Help -> Install New Software...
Add...
Archive...

然后选择：

ruyisdk-eclipse-plugins-0.1.3.zip

接着一路 Next / Finish 完成安装。

安装完成并重启后，顶部菜单成功出现：

RuyiSDK

插件本体已经安装成功。

六、安装过程中遇到的问题与排查

问题 1：缺少内嵌浏览器依赖，Ruyi Installation 无法打开

插件安装后，点击 RuyiSDK -> Ruyi Installation 时，报错信息大意为：

No more handles because there is no underlying browser available.
Please ensure that WebKit with its GTK bindings is installed.

这说明 Eclipse 的 SWT 内嵌浏览器依赖没装好，需要补 WebKitGTK。Eclipse 官方帮助里也明确提到，在 Linux 上缺少 WebKitGTK 时会出现类似问题。

解决方法

由于本机源显示为 Ubuntu noble（24.04），最终安装的包是：

sudo apt install -y libwebkit2gtk-4.1-0

安装完成后重启 Eclipse，Ruyi Installation 页面相关问题消失。

问题 2：Ruyi Venv 视图能打开，但创建的 venv 不显示

插件安装并修复 WebKitGTK 后，RuyiSDK -> Venv (Virtual Environments) 可以正常打开，底部出现 Ruyi Venv 视图。

官方 IDE 示例中，创建 venv 后，该 venv 应出现在 Ruyi Venv 表格中，然后再继续 Apply to Project。

但本次实测中出现了以下现象：

  • venv 创建向导可以正常打开

  • 项目也可以正常创建

  • venv 目录在磁盘上实际已经生成

  • 但是 Ruyi Venv 表格始终为空

  • 因此 Apply to Project 按钮一直是灰的，GUI 工作流无法继续

查到插件仓库中也存在关于 venv 检测/项目绑定问题的公开 issue

33d9bb9cd1d23a4b4576cc66faa86410
33d9bb9cd1d23a4b4576cc66faa864102880×1824 205 KB

七、创建测试项目

虽然 GUI 绑定 venv 的流程没有完全打通，但 Eclipse 中创建项目是可以成功的。

创建步骤

依次点击：

File -> New -> C/C++ Project

选择：

Classic C++ Project
Executable -> Hello World RISC-V C++ Project
Toolchains -> RISC-V Cross GCC

在 Basic Settings 页面中：

  • Hello world greeting 保持默认

  • Source 保持 src

  • Linker other options 保持空白

后续配置页保持默认继续，最终成功生成项目：

hello-riscv

左侧 Project Explorer 中能看到项目，src/main.cpp 也能正常生成。

八、临时绕过方案：使用命令行创建并激活 .venv

由于 Eclipse GUI 中 Ruyi Venv 表格没有正常显示虚拟环境，后续改用命令行完成 venv 创建与运行验证。

1. 进入项目目录

cd /home/selene/workspace/eclipse-ruyi/hello-riscv

2. 创建 .venv

如果只创建工具链，不带 emulator，那么后续会出现 ruyi-qemu: command not found。因此最终采用的命令是：

ruyi venv -t gnu-plct-xthead -e qemu-user-riscv-xthead sipeed-lpi4a .venv

命令逻辑与官方文档一致：

  • toolchain：gnu-plct-xthead

  • emulator：qemu-user-riscv-xthead

  • profile：sipeed-lpi4a

3. 激活环境

source ./.venv/bin/ruyi-activate

4. 检查工具链是否生效

riscv64-plctxthead-linux-gnu-gcc --version
riscv64-plctxthead-linux-gnu-g++ --version

版本信息可以正常输出，说明 .venv 已经工作正常。

九、Hello World 编译与运行验证

1. 编译

riscv64-plctxthead-linux-gnu-g++ -static src/main.cpp -o hello-riscv

2. 检查生成文件

file hello-riscv

输出中可以确认它是一个 RISC-V ELF 可执行文件。

3. 运行

ruyi-qemu ./hello-riscv

最终成功输出：

Hello RISC-V World!

这一步说明虽然 Eclipse GUI 没有完整走通 Apply to Project，但 RuyiSDK 的工具链、QEMU、项目源码、venv 机制本身都是正常可用的。

a4f29aa0fe8e49d33ea0e2e5774b9f65
a4f29aa0fe8e49d33ea0e2e5774b9f652880×1824 229 KB

十、结论

成功:

  • Eclipse Embedded C/C++ IDE 安装成功

  • RuyiSDK Eclipse 插件安装成功

  • 顶部 RuyiSDK 菜单可见

  • Ruyi Venv 视图可打开

  • Hello World RISC-V C++ Project 可创建

  • 通过命令行创建 .venv 成功

  • 激活 .venv 后工具链和 ruyi-qemu 可正常使用

  • Hello RISC-V World! 成功运行

未成功：

  • Eclipse GUI 中 Ruyi Venv 表格未能显示已创建的虚拟环境

  • 因此官方 GUI 工作流中的：

    • Apply to Project

    • GUI 内直接构建与运行
      暂未完成验证

判断

RuyiSDK Eclipse 插件已经成功安装，部分功能可正常打开和使用；

核心工具链与 QEMU 运行链路已通过命令行验证成功。

但在当前 WSL 环境下，Eclipse GUI 中的 venv 识别/绑定仍存在问题，导致图形化工作流未完全打通。

十一、感受建议

只是想尽快体验 RuyiSDK 的编译运行能力建议：

  • Eclipse 主要用于体验插件界面与项目模板

  • venv 创建、激活、运行验证优先用命令行补充完成

这样成功率更高，也更容易定位问题。

后续体验

  • Ruyi Venv 视图自动识别项目目录下 .venv

  • Apply to Project 正常可用

  • Eclipse 索引器自动关联 venv 中的交叉编译器，减少 riscv-none-elf-gcc/g++ 找不到路径的误报

以上问题是否可以解决或优化

1 个赞