如何用cad-viewer从Google Drive和OneDrive直接打开DWG/DXF图纸:完整指南

原创2026-10-15 10:28:191,744 阅读
文章标签:前端图形学3D渲染

如何用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 的数据源插件把这条路彻底缩短为:

  1. 在打开菜单中 Sign in(登录) 对应的云盘账号
  2. 点击 Open from Google Drive / Open from OneDrive,弹出官方文件选择器
  3. 选中图纸,浏览器端立即解析并渲染

cad-viewer 采用模块化插件架构,云盘接入通过注册 AcApDataSource(数据源)实现——选择器、授权、下载、解析全部由插件驱动,打开菜单会根据登录状态自动重建。

cad-viewer 浏览器中打开的 DWG 建筑图纸预览,左侧为图层面板

💡 图纸文件在你的浏览器本地解析,不经过任何第三方服务器,隐私敏感的工作流也适用。

快速上手:安装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 权限

  1. 在 Google Cloud Console 中创建一个项目
  2. 启用 Google Drive API 和 Google Picker API
  3. 创建 OAuth Web application 客户端,并添加已授权 JavaScript 源(如 http://localhost:5173)
  4. 创建 API Key,并限制其仅用于 Drive + Picker 和你的域名
  5. 记录数字项目编号(Project number)——Picker 要求将其作为 appId 传入
  6. OAuth 应用处于 Testing 状态时,记得添加 OAuth 测试用户

插件实际使用的权限范围是 drive.file、userinfo.email、userinfo.profile,其中 drive.file 只覆盖通过 Picker 或 Drive"Open with"打开的文件,权限面很小。

配置 Azure Entra ID:申请 OneDrive 权限

  1. 在 Microsoft Entra ID 中注册一个 Single-page application
  2. 添加与你页面匹配的重定向 URI(例如本地为 http://localhost:5173/)。注意:如果应用部署在子路径下,不能只填站点根域名
  3. 授予委托权限:User.Read 和 Files.Read.All
  4. 个人版 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

操作流程非常简单:

  1. 点击 Sign in to Google Drive(或 OneDrive),在弹出窗口中完成授权
  2. 点击 Open from Google Drive(或 OneDrive),在文件选择器中浏览并选中 .dwg / .dxf 文件
  3. 图纸直接在浏览器中渲染,即可平移、缩放、切换图层、测量距离

cad-viewer 在浏览器中打开图纸的交互演示

为什么必须是"两次点击"?

这是由浏览器的弹窗策略决定的:弹窗(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

cad-viewer 分层架构图:View、Rendering、Model 三层与数据源插件协作

云盘插件位于这一架构的"数据获取"环节:它只负责把选中文件取回内存,后续的 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。

核心文件与延伸阅读

⚠️ 提示:云盘插件是可选能力,不配置任何凭据时,应用照常支持本地文件与 URL 打开图纸,功能互不影响。

配好两个插件后,你的浏览器 CAD 查看器就和云盘打通了——打开菜单里多点两下,图纸即刻出现在画布上。

登录后查看全文
cad-viewer