了解 Salesforce Multi-Framework（01 Get to Know Salesforce Multi-Framework）
本单元认识 Salesforce Multi-Framework。我们先探讨它是什么、为什么重要，再深入让「React 跑在 Salesforce 上」成为现实的两块拼图——部署应用的 UI Bundle、连接数据的 Data SDK——最后纵览你能构建什么。
完成本单元后，你将能够：
- 描述 Salesforce Multi-Framework 是什么、它解决的问题；
- 解释 React 应用如何作为 UI Bundle 部署到 Salesforce 组织；
- 描述 Data SDK 如何把 React 应用连接到 Salesforce 数据；
- 列出用 Multi-Framework 能构建的一些东西。
注意：Multi-Framework 目前支持 React（后续会加入更多框架），处于 Beta 阶段，在 scratch org 和 sandbox 中可用。
发现 Salesforce Multi-Framework（Discover Salesforce Multi-Framework）
你是否曾希望用 React 构建 Salesforce 应用？有了 Salesforce Multi-Framework，现在可以了。你可以构建丰富、交互式的 React 应用——员工工具、客户门户、仪表盘、向导——并直接部署到你的 Salesforce 组织，用户在桌面端的 App Launcher 或 Salesforce 移动应用里打开它们，就像打开任何其它 Salesforce 应用一样。
Multi-Framework 给你完整的 React 生态：你喜欢的组件库、样式框架、路由方案和 npm 包，都运行在 Agentforce 360 平台上。Salesforce 负责认证、数据访问和部署基础设施，你只需专注构建出色的体验。
UI Bundle（一）：为框架应用打造的元数据类型（The UI Bundle (1): A Metadata Type）
一个 React 应用是如何跑到你的 Salesforce 组织里的？答案是 UI bundle——一种专为现代框架应用打造的元数据类型。
你的开发工作流保持熟悉：用 Vite 和 TypeScript 在本地开发 React 应用，就和你开发任何 React 项目一样；准备好后用 Salesforce CLI 构建并部署。UI bundle 位于你标准的 Salesforce DX 项目结构里，紧挨着 Apex 类、自定义对象和权限集——所以版本控制、CI/CD、团队协作都照常工作。
UI Bundle（二）：简单的部署流程（The UI Bundle (2): A Simple Deployment Flow）
部署流程很简单：
- 在本地构建 React 应用；
- 打包为 UI bundle；
- 让 Salesforce 托管应用。
你不需要外部托管、iframe 嵌入或单独的认证流程。把构建产物和元数据部署到 Salesforce，它就工作了——用户从 App Launcher 访问应用，就和访问任何其它 Salesforce 应用一样。
Data SDK（一）：访问 Salesforce 数据的统一接口（The Data SDK (1): One Interface）
真正的魔法在于 React 应用如何与 Salesforce 数据交互。Data SDK 给组件提供一个访问 Salesforce 数据的统一接口：
- 针对 UI API 运行 GraphQL 查询和变更（mutations）；
- 调用 Apex REST 端点；
- 使用 Connect API；
- 全程无需手动管理认证。
无论应用要做什么，都用同一种方式访问数据，让你的数据访问代码干净一致。
Data SDK（二）：运行时感知的访问（The Data SDK (2): Runtime-Aware Access）
Data SDK 特别之处在于它是运行时感知（runtime-aware）的：无论你的应用是通过 App Launcher 访问的内部员工工具，还是 Experience Cloud 站点上客户面向的门户，你写的是同样的数据访问代码——SDK 检测运行时上下文并处理其余部分。
如果你用过 Lightning Web Components 里的 @wire(getRecord)，这个概念很熟悉：你查询的是同一个底层 UI API 数据层。区别在于，不是响应式 wire adapter，而是用 useEffect 和 useState 这些标准 React 模式，通过 Data SDK 命令式地读写记录。
你能构建什么（What You Can Build）
Multi-Framework 让你用 React 及其庞大的开源生态构建完全自定义的应用，选择适合项目的组件库、样式框架和路由方案，Salesforce 负责认证、数据访问和部署基础设施这些硬骨头：
- 员工面向应用——超越标准 Lightning 页面，构建复杂多步骤工作流、丰富的数据可视化、以及用开源包实现的高度交互界面；
- 客户门户——创建有品牌感的客户面向体验，用任意 React UI 库匹配你的品牌，同时 Salesforce 处理认证和数据。
用 Multi-Framework 做更多（Do More with Multi-Framework）
你的 Multi-Framework 应用还有这些额外能力：
- 用 GraphQL 查询和变更读写组织数据；
- 从组件里用 fetch 调用 Apex REST 端点和 Connect API；
- 用 SLDS、Tailwind CSS、shadcn/ui 或任何你喜欢的 CSS 方案做样式；
- 把 Agentforce Conversation Client 加入应用，引入 AI 对话。
了解了 Multi-Framework 的能力后，去查看资源，开始在 Salesforce 上构建你的第一个 React 应用吧。