【共创稿事节】ArkGraphics 3D开发环境安装实战:从官网下载编辑器,到 DevEco Studio 离线装插件

先看结论

这次环境准备实际用到两个下载项:

  • ArkGraphics Editor 7.0.1.124 Beta for Windows(391 MB)
  • ArkGraphics Editor DevEco Plugin 7.0.1.124 Beta for Windows(4.8 MB)

编辑器是独立程序,插件是给 DevEco Studio 使用的 ZIP 包。两者都在华为开发者官网的 ArkGraphics Editor 下载页获取。DevEco Studio 的 Marketplace 搜索不到 ArkGraphics 并不代表环境缺少插件,正确方式是下载 ZIP 后使用 Install Plugin from Disk... 离线安装。

图中可以核对到版本号 7.0.1.124 Beta、发布日期 2026/08/28,以及两个独立下载入口。

一、这次要准备什么

项目 本次使用的内容
操作系统 Windows 64-bit
IDE DevEco Studio(已能正常打开项目)
编辑器 ArkGraphics Editor 7.0.1.124 Beta
IDE 插件 ArkGraphics Editor DevEco Plugin 7.0.1.124 Beta
工程 API HarmonyOS API 26,项目中使用 @kit.ArkGraphics3D
真机 HUAWEI Mate 60 Pro(用于后续 3D 场景验证)

先确保 DevEco Studio 能打开已有 HarmonyOS 项目,并记住下载文件保存的位置。编辑器安装包和插件压缩包不要混淆:前者需要运行安装程序,后者要在 DevEco Studio 的插件设置中导入。

二、从官网下载两个文件

  1. 打开华为开发者官网的 ArkGraphics Editor 下载页。
  2. 在版本列表中找到 ArkGraphics Editor 7.0.1.124 Beta。
  3. 点击第一项下载 Windows 编辑器安装包。
  4. 再点击第二项下载 ArkGraphics Editor DevEco Plugin 7.0.1.124 Beta for Windows。
  5. 下载完成后,得到一个约 391 MB 的 Editor 安装包和一个约 4.8 MB 的插件 ZIP 包。

这一步只认版本和文件名,不从 Marketplace 重新搜索。我们实际遇到的情况是 Marketplace 搜索 ArkGraphics 没有结果,切回官网的两个下载链接后流程正常。

三、安装 ArkGraphics Editor 主程序

  1. 双击 Editor 安装包。
  2. 按安装向导选择安装目录,保持默认组件即可。
  3. 安装结束后,从开始菜单启动 ArkGraphics Editor。
  4. 在欢迎页或关于页面核对版本为 7.0.1.124 Beta。

编辑器和 DevEco Studio 可以安装在不同目录。这里不需要把 ZIP 插件解压到编辑器目录,也不需要手动复制 DLL。

四、把 DevEco Plugin 装进 DevEco Studio

  1. 启动 DevEco Studio。
  2. 打开 File → Settings → Plugins。
  3. 点击插件页右上角的齿轮按钮。
  4. 选择 Install Plugin from Disk...。
  5. 选中官网下载的 ArkGraphics Editor DevEco Plugin 7.0.1.124 Beta ZIP 文件。
  6. 点击 OK 或 Apply,等待安装完成。
  7. 根据提示点击 Restart IDE,重启 DevEco Studio。

这里不要先解压 ZIP 再选择里面的文件;插件安装入口需要的是官网提供的 ZIP 包。若误打开了 Marketplace 页面,直接返回 Plugins 设置页,按上面的齿轮菜单安装即可。

五、重启后核对插件

重启 DevEco Studio 后再次进入 Settings → Plugins → Installed ,搜索 ArkGraphics。核对以下信息:

  • 插件名称包含 ArkGraphics Editor DevEco Plugin;
  • 版本号为 7.0.1.124 Beta;
  • 状态显示为已启用(Enabled)。

如果 Installed 列表中没有结果,先检查选择的是否是官网下载的 ZIP,而不是编辑器主程序安装包;其次检查 DevEco Studio 是否已经完成重启。

本机安装后可在 C:\Users\yutian\AppData\Roaming\Huawei\DevEcoStudio26.0\plugins\ArkGraphicsDevEcoPlugin\ 找到插件目录,目录内包含 ArkGraphicsIdeaPlugin.dll、PluginAGP3D.dll、PluginLumeScene.dll、arkgraphics_host.exe 等文件。插件文件已经落盘,说明离线安装生效;Installed 列表的条目名称与启用状态以 DevEco Studio 页面为准核对。

六、用项目快速验证 SDK

插件安装完成后,用已有测试项目做一次编译验证。项目的 build-profile.json5 使用 API 26,SDK 中可以找到 @kit.ArkGraphics3D 声明文件。最小导入示例:

复制代码
import { Scene, SceneResourceFactory } from '@kit.ArkGraphics3D';

async function checkArkGraphics3D(): Promise<void> {
  const scene: Scene = await Scene.load();
  const factory: SceneResourceFactory = scene.getResourceFactory();
  console.info(`ArkGraphics 3D SDK ready: ${factory !== undefined}`);
}

在 DevEco Studio 中执行一次 Build → Build Hap(s)/App(s)。只要项目能完成签名构建,并且编辑器插件能够打开对应的 ArkGraphics 资源工作流,环境准备就可以进入下一篇 3D 场景实战。

七、这次遇到的问题与处理结果

Marketplace 搜不到 ArkGraphics

现象 :在 DevEco Studio 的 Marketplace 输入 ArkGraphics,列表为空。

处理 :不继续在 Marketplace 里搜索,改为从官网同一版本页面下载 Editor 主程序和 DevEco Plugin ZIP,再通过 Install Plugin from Disk... 安装。Marketplace 没有搜索结果不影响官网离线安装流程。

把 Editor 和 Plugin 当成同一个文件

现象:只下载了 391 MB 的 Editor,DevEco Studio 里仍然没有插件。

处理:补下载 4.8 MB 的 DevEco Plugin ZIP。Editor 负责独立的 3D 编辑器,Plugin 负责 DevEco Studio 集成,两项需要分别安装。

八、环境准备完成后的结果

完成后,电脑上应同时具备:

  1. 可独立启动的 ArkGraphics Editor 7.0.1.124 Beta;
  2. DevEco Studio Installed 列表中的 ArkGraphics Editor DevEco Plugin 7.0.1.124 Beta;
  3. 能以 API 26 编译、并识别 @kit.ArkGraphics3D 的 HarmonyOS 测试项目。

后续 3D 实操会在这个环境上继续:先用编辑器准备模型和材质,再在 HarmonyOS 项目中加载场景、调整相机和灯光,最后用真机验证交互效果。

官方资料

相关推荐
二流小码农9 小时前
鸿蒙开发:router组件升级,彻底告别手动配置
android·ios·harmonyos
威哥爱编程17 小时前
模拟面试智能体开发实战 09:把面试官装进手机,鸿蒙端聊天界面用 SSE 流式输出让回复逐字滚出来
python·agent·harmonyos
威哥爱编程17 小时前
模拟面试智能体开发实战 10:配置写死在代码里还怎么换服务端,把设置和简历做成界面可配、可存
python·agent·harmonyos
Sirius_Ji1 天前
# 一份鸿蒙原生支持硬解的 ffmpeg 开发基座
harmonyos
贾伟康1 天前
HarmonyOS API 26 Navigation路由栈上限:stackSizeLimit、过载保护与容量观测
harmonyos·arkts·navigation·navpathstack·api26
江华森2 天前
把鸿蒙云手机调试的 5 个坑写成 Skill:12 项检查清单与报错决策树
harmonyos
木木子222 天前
用华为云码道构建校园导航应用「新生通」:从需求分析到工程落地
华为·华为云·harmonyos
贾伟康2 天前
HarmonyOS API 26 Navigation 自适应模式:mode、分栏切换与窗口断点治理
harmonyos·arkts·arkui·navigation·自适应布局
贾伟康2 天前
【转盘决定吧|07】HarmonyOS ArkTS 6.0.2.130 趣味题库:场景分类、随机选择与详情页解耦
harmonyos·arkts·路由·数据建模·arkui
贾伟康2 天前
【电路实验模拟|03】HarmonyOS ArkTS 交通灯实战:用定时状态切换红黄绿灯
harmonyos·arkts·canvas·arkui·交通灯