Microsoft Graph 工具包入门

  • 项目

可以轻松将 Microsoft Graph 工具包组件添加到 Web 应用程序、SharePoint Web 部件或 Microsoft Teams 选项卡。 这些组件基于 Web 标准，可用于普通 JavaScript 项目或常用 Web 框架（如 Reach、Angular 和 Vue.js）。

观看此简短视频以开始使用工具包。

有关分步教程，请参阅 Microsoft Graph 工具包入门 模块。

设置 Microsoft 365 租户

若要使用 Microsoft Graph 工具包开发应用，需要访问 Microsoft 365 租户。 如果没有，可以在通过 加入 Office 365 开发人员计划 获取免费的 Office 365 开发人员订阅。 有关如何配置订阅的详细信息，请参阅 设置 Microsoft 365 开发人员订阅。

设置开发环境

若要使用工具包进行开发，需要满足以下条件：

  • 文本编辑器或 IDE。 可以使用所选的编辑器或 IDE，也可以免费安装和使用Visual Studio Code。
  • 新式 Web 浏览器，如 Microsoft Edge、Google Chrome 或 Firefox。
  • Node.js的 LTS 版本，可从 nodejs.org 安装。

使用 Microsoft Graph 工具包

可以通过) 或安装npm包直接引用加载程序 (unpkg ，在应用程序中使用 Microsoft Graph 工具包。

若要通过 mgt-loader使用工具包，请将脚本中的引用添加到代码：

<script src="https://unpkg.com/@microsoft/mgt@2/dist/bundle/mgt-loader.js"></script>

<mgt-msal2-provider client-id="<YOUR_CLIENT_ID>"></mgt-msal2-provider>
<mgt-login></mgt-login>

NPM 包

Microsoft Graph 工具包由多个 NPM 包组成，允许你仅包含应用程序所需的代码。

@microsoft/mgt-element

@microsoft/mgt-element 是仅包含用于生成组件和提供程序基类的核心包。 此包公开生成自己的组件所需的所有必要类和接口，并导出用于生成自定义提供程序的 IProvider 接口和 SimpleProvider 类 。

@microsoft/mgt-components

该 @microsoft/mgt-components 包包含所有 Microsoft Graph 连接的 Web 组件，例如 Person、 PeoplePicker等。

提供程序

提供程序可通过单个包使用，并可根据需要进行安装。 以下提供程序包可用:

  • @microsoft/mgt-msal-provider

    @microsoft/mgt-msal-provider 包含 MsalProvider 和 mgt-msal-provider 组件。 MSAL 提供程序使用 msal.js 在 Web 应用和渐进式 Web 应用 (PWA) 中进行身份验证。

  • @microsoft/mgt-msal2-provider

    @microsoft/mgt-msal2-provider 包含 Msal2Provider 和 mgt-msal2-provider 组件。 MSAL2 提供程序使用 msal-browser 在 Web 应用和 PWA 中进行身份验证。

  • @microsoft/mgt-teams-provider

    @microsoft/mgt-teams-provider 包含 TeamsProvider 和 mgt-teams-provider 组件。 Microsoft Teams 提供程序在 Microsoft Teams 选项卡应用程序中启用身份验证。

  • @microsoft/mgt-teams-msal2-provider

    @microsoft/mgt-teams-msal2-provider 包含 TeamsMsal2Provider 和 mgt-teams-msal2-provider 组件。 Microsoft Teams MSAL2 提供程序在 Microsoft Teams 选项卡应用程序中启用身份验证。

  • @microsoft/mgt-sharepoint-provider

    @microsoft/mgt-sharepoint-provider 包含在 SharePoint 环境中进行身份验证的 SharePointProvider。

  • @microsoft/mgt-proxy-provider

    @microsoft/mgt-proxy-provider 包含 ProxyProvider 代理 Graph 通过后端服务调用的应用程序的 。

@microsoft/mgt

包@microsoft/mgt是包含上述所有包并重新导出的main包，以便可以通过可以安装的单个包获得它们。

@microsoft/mgt-react

包@microsoft/mgt-react包含所有自动生成的React组件，并依赖于包@microsoft/mgt。

@microsoft/mgt-spfx

@microsoft/mgt-spfx 包包含在 SharePoint 框架解决方案中使用Microsoft Graph工具包所需的 SharePoint 框架库。

后续步骤

现在，你已准备好开始使用 Microsoft Graph 工具包进行开发！ 以下指南可用于帮助你入门: