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

Статья
03/21/2023

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

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

Важно!

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

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

Обновление проектов с версии 1.11.0 до версии 1.12.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 динамически сформирует его.
- Дополнительные сведения см. в статье Варианты развертывания решений SharePoint Framework для Microsoft Teams.
В класс веб-части 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.
Для всех проектов:
- Обновление версии TypeScript по умолчанию до 3.7 (через @microsoft/rush-stack-compiler-3.7 версии 0.2.3)
- Обновление используемой версии Gulp до версии 4.0.2
  
  Дополнительные сведения см. в разделе Сведения о версиях & Gulp Node.js версии 12+
Для проектов, в которых используется 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.

Поделиться через