SharePoint Framework версии 1.4.1: заметки о выпуске

Дата выпуска: 15 февраля 2018 г.

Важно!

На этой странице рассматриваются сведения, связанные с определенной версией выпуска SPFx. На этой странице не содержатся дополнительные предварительные требования SPFx, которые необходимо установить для разработки решений SPFx, включая Node.js, Yeoman и другие средства.

Дополнительные сведения об этих предварительных требованиях см. в статье Настройка среды разработки SharePoint Framework.

Обновление проектов с версии 1.4 до версии 1.4.1

1. В файле package.json проекта определите все пакеты SPFx версии 1.4. Для каждого пакета SPFx:

   1. Удалите существующий пакет версии 1.4:

      npm uninstall @microsoft/{spfx-package-name}@1.4
      

   2. Установите обновленный пакет версии 1.4.1:

      npm install @microsoft/{spfx-package-name}@1.4.1.0 --save --save-exact
      

Совет

В CLI для Microsoft 365 доступно удобное пошаговое руководство по обновлению ваших решений до последней версии SharePoint Framework.

Новые функции и возможности

Поддержки Node версии 8 (LTS) и NPM версии 5

Теперь в SPFx доступна поддержка Node.js версии 8 (LTS) и NPM версии 5.

Проблема, о которой сообщается здесь: https://github.com/SharePoint/sp-dev-docs/issues/1002

Мы также обновили статью Настройка среды разработки SharePoint Framework.

Новые API (предварительные версии для разработчиков)

Ниже перечислены новые предварительные версии API, доступные для использования в SharePoint Online. Они еще не рассчитаны на использование в рабочей среде.

@microsoft/sp-http

• Начальная бета-версия класса AadHttpClient
• Начальная бета-версия класса AadTokenProvider

@microsoft/sp-client-preview

• Начальная бета-версия класса MSGraphClient

Вы можете найти руководство по этим новым API в документации по разработке для Office SharePoint.

• Руководство. Использование Microsoft Graph в SharePoint Framework

AadHttpClient (предварительная версия для разработчиков)

AadHttpClient используется для отправки вызовов REST к приложению Azure AD, например стороннему веб-API, размещенному в Azure.

• Для взаимодействия с SharePoint используйте вместо него класс SPHttpClient.
• Для взаимодействия с Microsoft Graph используйте класс MSGraphClient.

Дополнительные сведения об этих новых API можно найти в документации по разработке для Office SharePoint.

• Подключение к API, защищенным службой Azure AD, в решениях SharePoint Framework

MSGraphClient (предварительная версия для разработчиков)

MSGraphClient используется для отправки вызовов REST к Microsoft Graph. Клиентская библиотека JavaScript для Microsoft Graph — это компактная оболочка API Microsoft Graph. С помощью этого класса разработчики могут начать отправлять вызовы REST к MSGraph без необходимости в инициализации клиентской библиотеки MSGraph.

Если требуется пользовательская конфигурация, необходимо предоставить функцию API MSGraphClient с этой конфигурацией для каждого запроса.

• Использование MSGraphClient для подключения к Microsoft Graph

Важно!

Обратите внимание, что этот API заменяет выпущенный ранее класс GraphHttpClient, который теперь считается нерекомендуемым.

AadTokenProvider

Это внутренний класс, используемый классами AadHttpClient и MSGraphClient для получения маркеров OAuth2 из Azure AD. Хотя сейчас этот класс отмечен как общедоступный, мы планируем сделать его внутренним. По этой причине решения должны использовать только классы AadHttpClient и MSGraphClient.

Изменения в этом выпуске

• Устранена проблема в генераторе, которая препятствовала активации новых версий пакетов SPFx.
• Симптомы. Вы развертываете новую версию пакетов SharePoint Framework и больше не видите свои веб-части в средстве выбора веб-частей.

  • № 775

  • Исправление. Чтобы полностью устранить эту проблему, необходимо выполнить указанные ниже действия в своих клиентах SharePoint Online.

    1. Удалите все экземпляры существующих решений SharePoint Framework на уровне сайта.
    2. Удалите решение SharePoint Framework из каталога приложений
    3. Отправьте новое решение SharePoint Framework, собранное с помощью версии 1.4.1, в каталог приложений.
    4. Заново установите решения SharePoint Framework на сайтах.

    Примечание.

    Эта проблема не возникает в решениях SharePoint Framework на уровне клиента и в надстройках SharePoint.

    Совет

    Возможно, вам следует воспользоваться API управления жизненным циклом приложений (ALM) для автоматизации этого важного процесса.

Упраздненные и удаленные элементы в этом выпуске

• API GraphHttpClient объявлен нерекомендуемым и заменен на новый класс MSGraphClient, появившийся в этом выпуске. Класс GraphHttpClient будет удален в будущем выпуске.