Начало работы с Microsoft Graph Toolkit

  • Статья

Компоненты Microsoft Graph Toolkit можно легко добавить в веб-приложение, веб-часть SharePoint или вкладки Microsoft Teams. Компоненты основаны на веб-стандартах и могут использоваться как в простых проектах JavaScript, так и в популярных веб-платформах, таких как Reach, Angular и Vue.js.

Просмотрите это короткое видео, чтобы приступить к работе с набором средств.

Пошаговое руководство см. в модуле Начало работы с Microsoft Graph Toolkit .

Настройка клиента Microsoft 365

Чтобы использовать Microsoft Graph Toolkit для разработки приложения, необходим доступ к клиенту Microsoft 365. Если у вас ее нет, вы можете получить бесплатную подписку для разработчиков Microsoft 365, присоединившись к программе для разработчиков Microsoft 365. Дополнительные сведения о настройке подписки см. в разделе Настройка подписки разработчика Microsoft 365.

Настройка среды разработки

Для разработки с помощью набора средств необходимо следующее:

  • Текстовый редактор или интегрированная среда разработки. Вы можете использовать любой редактор или интегрированную среду разработки или установить и использовать Visual Studio Code бесплатно.
  • Современный веб-браузер, например Microsoft Edge, Google Chrome или Firefox.
  • Версия LTS Node.js, которую можно установить из nodejs.org.

Использование набора средств Microsoft Graph

Вы можете использовать Microsoft Graph Toolkit в приложении, ссылаясь на загрузчик напрямую (через unpkg) или установив npm пакет.

Чтобы использовать набор средств через 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 веб-компоненты, такие как Person, PeoplePickerи многое другое.

Поставщики

Поставщики доступны через один пакет и могут быть установлены по мере необходимости. Доступны следующие пакеты поставщиков:

  • @microsoft/mgt-msal-provider

    @microsoft/mgt-msal-provider содержит MsalProvider компонент и mgt-msal-provider . Поставщик MSAL использует msal.js для проверки подлинности в веб-приложениях и прогрессивных веб-приложения (PWA).

  • @microsoft/mgt-msal2-provider

    @microsoft/mgt-msal2-provider содержит Msal2Provider компонент и mgt-msal2-provider . Поставщик MSAL2 использует msal-browser для проверки подлинности в веб-приложениях и 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 содержит для проверки подлинности SharePointProvider в среде SharePoint.

  • @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 Framework, необходимую для использования Microsoft Graph Toolkit в SharePoint Framework решениях.

Дальнейшие действия

Теперь вы готовы приступить к разработке с помощью Microsoft Graph Toolkit! Помогут вам приступить к работе со следующими руководствами.