如何用cad-viewer从Google Drive和OneDrive直接打开DWG/DXF图纸:完整指南
如何用cad-viewer从Google Drive和OneDrive直接打开DWG/DXF图纸:完整指南
cad-viewer 是首个完全运行在浏览器中的 DXF/DWG 在线查看器与编辑器,无需任何后端服务。搭配官方的 Google Drive 插件(@mlightcad/cad-google-drive-plugin)和 OneDrive 插件(@mlightcad/cad-onedrive-plugin),你可以在不下载图纸的前提下,直接从 Google Drive 或 OneDrive 中选择并打开 DWG/DXF 图纸,完成查看、缩放、图层控制和距离测量。本文带你从零配置到两步打开云盘图纸。
从Google Drive和OneDrive打开DWG/DXF:功能概览
工程图纸越来越多地存放在云盘里。传统做法是"先下载到本地 → 再打开 CAD 软件",而 cad-viewer 的数据源插件把这条路彻底缩短为:
- 在打开菜单中 Sign in(登录) 对应的云盘账号
- 点击 Open from Google Drive / Open from OneDrive,弹出官方文件选择器
- 选中图纸,浏览器端立即解析并渲染
cad-viewer 采用模块化插件架构,云盘接入通过注册 AcApDataSource(数据源)实现——选择器、授权、下载、解析全部由插件驱动,打开菜单会根据登录状态自动重建。
💡 图纸文件在你的浏览器本地解析,不经过任何第三方服务器,隐私敏感的工作流也适用。
快速上手:安装cad-viewer云盘插件
安装插件包
在项目中安装对应的插件(可只装其一,也可以同时安装):
# Google Drive 数据源
pnpm add @mlightcad/cad-google-drive-plugin
# OneDrive 数据源
pnpm add @mlightcad/cad-onedrive-plugin @azure/msal-browser
两个插件的 peer 依赖均为 @mlightcad/cad-simple-viewer 和 @mlightcad/data-model。Google 相关 SDK(gapi、GIS、Picker)在运行时从 Google CDN 加载,不需要额外安装 npm 包。
配置 Google Cloud:开通 Drive 与 Picker 权限
- 在 Google Cloud Console 中创建一个项目
- 启用 Google Drive API 和 Google Picker API
- 创建 OAuth Web application 客户端,并添加已授权 JavaScript 源(如
http://localhost:5173) - 创建 API Key,并限制其仅用于 Drive + Picker 和你的域名
- 记录数字项目编号(Project number)——Picker 要求将其作为
appId传入 - OAuth 应用处于 Testing 状态时,记得添加 OAuth 测试用户
插件实际使用的权限范围是 drive.file、userinfo.email、userinfo.profile,其中 drive.file 只覆盖通过 Picker 或 Drive"Open with"打开的文件,权限面很小。
配置 Azure Entra ID:申请 OneDrive 权限
- 在 Microsoft Entra ID 中注册一个 Single-page application
- 添加与你页面匹配的重定向 URI(例如本地为
http://localhost:5173/)。注意:如果应用部署在子路径下,不能只填站点根域名 - 授予委托权限:
User.Read和Files.Read.All - 个人版 OneDrive 的选取器令牌还需覆盖
OneDrive.ReadOnly同意范围
注册插件:几行代码接入打开菜单
注册 Google Drive 插件
import { AcApDocManager } from '@mlightcad/cad-simple-viewer'
import { registerGoogleDrivePlugin } from '@mlightcad/cad-google-drive-plugin/register'
await registerGoogleDrivePlugin(AcApDocManager.instance.pluginManager, {
clientId: import.meta.env.VITE_GOOGLE_CLIENT_ID,
apiKey: import.meta.env.VITE_GOOGLE_API_KEY,
appId: import.meta.env.VITE_GOOGLE_APP_ID // 数字项目编号
})
三个配置项缺一不可,注册函数会在缺失时抛出明确的错误提示(见 register.ts)。
注册 OneDrive 插件
import { AcApDocManager } from '@mlightcad/cad-simple-viewer'
import { registerOneDrivePlugin } from '@mlightcad/cad-onedrive-plugin/register'
await registerOneDrivePlugin(AcApDocManager.instance.pluginManager, {
clientId: import.meta.env.VITE_MSAL_CLIENT_ID,
tenantId: import.meta.env.VITE_MSAL_TENANT_ID || 'common',
redirectUri: import.meta.env.VITE_MSAL_REDIRECT_URI // 可选
})
OneDrive 侧只需要 clientId 必填,tenantId 默认 common 即可兼容个人与企业账号(见 register.ts)。
两个插件都会即时加载,因此打开菜单在应用启动时就列出云盘入口;而底层的 GIS/gapi 或 MSAL 脚本仍是按需懒加载,不影响首屏性能。
实际操作:两步打开云盘DWG/DXF图纸
注册完成后,cad-viewer 的 File → Open 菜单和 cad-simple-ui-plugin 的工具栏 Open 菜单会根据登录状态自动重建:
| 登录状态 | 菜单项 |
|---|---|
| 未登录 | Sign in to Google Drive / Sign in to OneDrive |
| 已登录 | Open from Google Drive / Open from OneDrive,Sign out |
操作流程非常简单:
- 点击 Sign in to Google Drive(或 OneDrive),在弹出窗口中完成授权
- 点击 Open from Google Drive(或 OneDrive),在文件选择器中浏览并选中
.dwg/.dxf文件 - 图纸直接在浏览器中渲染,即可平移、缩放、切换图层、测量距离
为什么必须是"两次点击"?
这是由浏览器的弹窗策略决定的:弹窗(popup)只在直接的用户手势中才被允许打开。Google Identity Services 的 requestAccessToken 和微软 File Picker v8 都需要弹窗,如果在同一个点击事件里 await 登录再打开选择器,第二个弹窗会被浏览器拦截。因此插件刻意拆分为"先登录、后打开"两个独立入口,两个插件的设计说明中都特别强调了这一点。
原理解析:为什么图纸能"免下载"打开
cad-viewer 采用清晰的三层架构:
- View Layer:
cad-viewer(完整 Vue 3 界面)与cad-simple-viewer(精简宿主) - Rendering Layer:
three-renderer、svg-renderer等渲染引擎 - Model Layer:
libredwg-converter(DWG 解析)、data-model、geometry-engine
云盘插件位于这一架构的"数据获取"环节:它只负责把选中文件取回内存,后续的 DWG/DXF 解析、几何处理、渲染全部在浏览器本地完成。这意味着:
- ✅ 无后端:不需要为你的云盘文件搭建服务器或中转 API
- ✅ 大文件友好:60+ FPS 的渲染优化让大型图纸也能流畅浏览
- ✅ 隐私可控:图纸不离开你的设备与云盘,仅按需下载打开
常见问题排查清单
| 症状 | 排查方向 |
|---|---|
| 打开菜单里没有云盘入口 | 插件未注册成功;检查 clientId / apiKey / appId 是否齐全,Google 三项缺一都会抛错 |
| Google 登录弹窗被拦截 | 确保"登录"和"打开"是两次独立点击;检查已授权 JavaScript 源是否与页面 URL 一致 |
| Picker 报错或选不到文件 | appId 必须填数字项目编号而非 client ID;确认已启用 Drive API 和 Picker API;Testing 状态下需添加测试用户 |
| OneDrive 授权失败 | 重定向 URI 必须与页面实际地址(含子路径)完全匹配;确认已授予 Files.Read.All |
| 环境变量缺失导致入口不显示 | 示例应用通过 VITE_GOOGLE_* / VITE_MSAL_* 环境变量判断是否注册插件,占位符值会被自动忽略 |
官方示例应用 cad-simple-viewer-example 演示了完整的按需注册逻辑:检测到有效环境变量才加载对应插件,具体实现可参考 googleDriveEnv.ts 与 onedriveEnv.ts。
核心文件与延伸阅读
- Google Drive 插件:packages/cad-google-drive-plugin/
- OneDrive 插件:packages/cad-onedrive-plugin/
- 插件文档:cad-google-drive-plugin README、cad-onedrive-plugin README
- 示例集成说明:cad-simple-viewer-example README
- 核心查看器:packages/cad-simple-viewer/
⚠️ 提示:云盘插件是可选能力,不配置任何凭据时,应用照常支持本地文件与 URL 打开图纸,功能互不影响。
配好两个插件后,你的浏览器 CAD 查看器就和云盘打通了——打开菜单里多点两下,图纸即刻出现在画布上。


