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

Статья
03/21/2023

Ключевые изменения заключаются в введении новой модели plusbeta, а также во множестве других улучшений и дополнительных возможностей.

Выпуск: 5 июля 2018 г.

Важно!

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

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

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

Укажите все пакеты SPFx версии 1.4.1 в файле проектаpackage.json. Для каждого пакета SPFx:
1. Удалите существующий пакет версии 1.4.1:
```
npm uninstall @microsoft/{spfx-package-name}@1.4.1
```
2. Установите обновленный пакет версии 1.5:
```
npm install @microsoft/{spfx-package-name}@1.5.0 --save --save-exact
```
Установите следующие пакеты объявлений типа TypeScript:
```
npm install **\@types/webpack-env@1.13.1
npm install **\@types/es6-promise@0.0.33
```

Добавьте следующие записи в types массив в файле tsconfig.json:

{
  // omitted for brevity
  "types": [
    // omitted for brevity
    "webpack-env",
    "es6-promise"
  ]
  // omitted for brevity
}

Совет

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

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

Доставка в сравнении с API бета-версии: теперь это отдельные пакеты

Начиная с выпуска версии 1.5.0 пакеты будут содержать только окончательные общедоступные API в файлах *.d.ts . Все API бета-версии удаляются, и вам потребуется явно выбрать пакеты, которые содержат API бета-версии. Чтобы использовать эти API бета-версии, необходимо использовать версии пакетов 1.5.0-plusbeta. Существует только одна версия @microsoft/generator-sharepoint, и она может создавать как бета-, так и не бета-решения.

Вы можете создавать решения, которые используют API бета-версий, одним или двумя способами. Вы можете запустить генератор yeoman и добавить в командную строку флажок --plusbeta, в результате чего будет создан файл package.json, уже содержащий версии -plusbeta, либо вы можете обновить ссылки в package.json, чтобы использовать версию -plusbeta.

Это отличается от вашего стандартного подхода по причине того, что хотя в бета-версии случайным образом и имеются целые пакеты, однако для некоторых API бета-версии стандартным является их присутствие в существующих пакетах доставки. Также не всегда обязательным является и то, что это бета-версия следующего выпуска, поскольку возможность может оставаться в предварительной версии для нескольких выпусков.

Использование ознакомительных возможностей SharePoint Framework

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

Основную часть этого выпуска составляет предварительная версия динамических данных для разработчиков. Вы можете считать это современным подходом к возможности соединения веб-частей на классических страницах.

Конечная цель возможности будет состоять в том, чтобы обеспечить повышенную динамичность свойств для разработчиков и пользователей, а также привязку к свойствам в других веб-частях (например, в карточке пользователя, которая управляется текущим выбранным документом в веб-части библиотеки документов), состоянию страницы (карточка пользователя отображает автора) или даже к контексту страницы (карточка пользователя отображает текущего пользователя).

Эта предварительная версия для разработчиков в основном сосредоточена на базовой модели данных. Никакие основные веб-части в настоящий момент не отображают свойства. У нас есть образец объекта контекста страницы, а также черновой (для разработчиков) элемент управления области свойств, в котором можно указать путь к динамическому свойству, к которому вы хотите привязать свойство веб-части.

Мы продолжаем работать над возможностями конечного пользователя, однако мы пожелали, чтобы ими пока могли воспользоваться разработчики. Учебные материалы и примеры можно найти в следующих статьях:

Поддержка дополнительных диспетчеров пакетов (Yarn & PNPM)

Генератор Yeoman и средства сборки теперь поддерживают диспетчеры пакетов PNPM и Yarn, а также npm.

Для использования выберите параметр командной строки --package-manager в генераторе и укажите npm, **pnpm или yarn.

Например:

yo @microsoft/sharepoint --package-manager pnpm

Генератор Yeoman для SharePoint Framework

Поддержка настраиваемых генераторов Yeoman

Мы доработали генератор в соответствии с рекомендациями. Это позволит вам использовать наш генератор для собственных пользовательских генераторов. В сообществе разработчиков SharePoint (PnP) мы создадим новую инициативу с открытым исходным кодом, чтобы предлагать новые поддерживаемые платформы, такие как Angular Elements и Vue.js.

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

Многие обновления платформы не требуют обновления для пакетов npm. Например, мы удалили всплывающее окно проверки подлинности в первоначальном выпуске кода предварительной версии для разработчиков Web API, но изменение развертывается в платформу, размещенную в службе, поэтому для разработчиков никакие изменения не требуются.

Были выполнены некоторые обновления, которые явно запрашивают обновления для пакетов.

Добавлены сведения о AAD в PageContext (aadInfo)
Исправлены ошибки sp-dialog и других пакетов, которые некорректно работали в рабочей области
Добавлено 10 дополнительных правил tslint из tslint-microsoft-config для обнаружения распространенных уязвимостей системы безопасности
Исправлена проблема, связанная с решением пакета, при которой предупреждения приводили к сбою сборки

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