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

  • Статья

В этом выпуске представлено новое событие свойства & в API веб-частей для обнаружения ширины отрисовки (и изменений), улучшена поддержка решений Microsoft Teams и обновлены поддерживаемые версии Node.js.

Дата выпуска: 28 апреля 2021 г.

Важно!

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

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

Обновление проектов с версии 1.11.0 до версии 1.12.1

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

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

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

    2. Установите обновленный пакет версии 1.12 {version-release}:

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

Совет

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

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

  • Кнопка Синхронизация с Teams в каталоге приложений клиента будет использовать определенный в решении манифест Teams, если он есть, чтобы создать и опубликовать пакет приложения Teams в Microsoft Teams. Если файл манифеста приложения отсутствует, SharePoint динамически сформирует его.
  • В класс веб-части SPFx добавлен новый API, чтобы определять ширину отрисованной веб-части и обрабатывать событие в случае изменения ширины.
  • Разворачивание уведомлений списков для работы как со списками, так и с библиотеками документов.
  • Предварительная поддержка приложений для собраний Microsoft Teams с использованием SharePoint Framework. Полная поддержка будет доступна после исправления для регрессии на стороне сервера.

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

  • Добавлена поддержка Node.js версии 12.13.x & v14.15.x
    • Дополнительные сведения см. в статье Настройка среды разработки SharePoint Framework.
    • Настоятельно рекомендуется использовать Gulp-CLI. Наша прежняя рекомендация состояла в том, чтобы глобально установить Gulp версии 3 или версии 4, но команда Gulp рекомендовала установить глобально только Gulp CLI. Интерфейс CLI Gulp позволяет одновременно работать с проектами, использующими Gulp версии 3, и другими, использующими Gulp версии 4.
  • Для всех проектов:
  • Для проектов, в которых используется React:
    • Обновление пакетов NPM React (react&react-dom) до версии 16.9.0.
    • Обновление пакета NPM Office UI Fabric React / пользовательский интерфейс Microsoft Fluent (office-ui-fabric-react) до версии 7.156.0.
  • Расположение по умолчанию для ресурсов, используемых в развертываниях, изменено с ./temp/deploy на ./releases/assets. Для проектов, созданных до SPFx версии 1.12.1, следует обновить свойство workingDir файла ./config/deploy-azure-storage.json, используя новое расположение: "workingDir": "./release/assets/". Дополнительные сведения см. в статье Развертывание клиентской веб-части SharePoint в сети CDN Azure: настройка сведений об учетной записи службы хранилища Azure.

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

  • Gulp версии 3 не поддерживается (при глобальной или локальной установке) при использовании Node.js версии 12 или более поздних версий.

  • Локальная среда Workbench упраздняется: это последний выпуск, в котором будет поддерживаться локальная среда Workbench.

  • Это последний выпуск, в состав которого будет входить единый генератор, работающий для локальной среде и для SharePoint Online. Вы по-прежнему сможете создавать проекты для локальной среды: для этого нужно будет использовать более старый генератор.

  • Задача gulp serve теперь не рекомендуется к использованию и переименована в serve-deprecated. Для решения этой проблемы gulpfile.js в новых проектах SPFx версии 1.12.1 был изменен: добавлен псевдоним serve для переименованной задачи serve-deprecated. Однако при обновлении проекта до SPFx 1.12.1 необходимо изменить файл gulpfile.js, чтобы задача gulp serve продолжала работать.

    При обновлении проектов SPFx до 1.12.1 добавьте следующее перед строкой build.initialize(require('gulp'));:

    var getTasks = build.rig.getTasks;
build.rig.getTasks = function () {
  var result = getTasks.call(build.rig);

  result.set('serve', result.get('serve-deprecated'));

  return result;
};

Версии & Gulp Node.js версии 12+

Gulp версии 3 не поддерживается в Node.js версии 12 или более поздних версий (см. gulpjs/gulp/#2324).

Это не изменение SPFx. Эти сведения приводятся здесь, чтобы привлечь внимание к этому изменению, поскольку в этом выпуске SPFx добавлена поддержка Node.js версии 12.