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

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

  • Статья

Добро пожаловать в общедоступную версию SPFx 1.0. Это было отличное и увлекательное путешествие, которое будет продолжено. Это только первый выпуск. Ожидайте постоянный поток улучшений и функций.

Выпущено: 22 февраля 2017 г.

Важно!

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

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

Обновление проектов с предварительных версий до версии 1.0.0

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

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

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

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

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

Совет

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

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

Вы можете получить обновленные пакеты npm и использовать их в локальной среде Workbench. Это не должно вызывать никаких проблем. Однако развертывание кода на серверах будет выполняться поэтапно в течение нескольких дней. Примерно на следующей неделе его должны получить 100 % ферм. Мы делаем это, чтобы отслеживать развертывание и убедиться в отсутствии проблем.

Теперь я смогу использовать SPFX и клиентские веб-части?

На это влияют два разных фактора. Первый — это доступность кода на всех фермах, а второй — включение возможности для конкретного клиента.

Подобно тому, как код разворачивается в фермах, эта возможность будет разворачиваться для клиентов. Мы начнем с тех же клиентов первого выпуска (не пользователей, клиентов), у которых уже есть SPFX. В течение пары недель развертывание должно быть выполнено для всех клиентов.

Вы узнаете, что возможность достигла конкретного клиента, когда при отправке пакета в каталог приложений появится оповещение о его действительности. Даже клиенты, которые не могут отправлять пакеты, по-прежнему могут попробовать SPFx. Они лишь будут ограничены локальной и размещенной средой Workbench (расположение: _layouts/15/workbench.aspx).

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

  • В фактическом коде SharePoint Framework есть лишь несколько изменений. Основная часть нашей работы между версией RC0 общедоступной версией была посвящена обеспечению стабильности и подготовке к будущим изменениям. Наша явная цель состоит в том, чтобы части, которые вы создаете сегодня, продолжали работать в течение многих лет. Однако исправления основной службы по-прежнему доставляются без проблем. Мы не загружаем 7 разных дополнительных версий и исправлений кода платформы и т. д. Для некоторых компонентов по-прежнему требуется работа в этой области. Мы доберемся до них.
  • Самое большое изменение кода заключается в том, что мы внедрили флаг строгой проверки NULL в SPFX, то есть вы также можете включить этот флаг в своих проектах. Это немного изменило API, что будет заметно, только если вы сами включаете строгую проверку NULL.
  • Другие заметные изменения находятся в стандартном коде, который создается при запуске генератора Yeoman. 1.0.0 — это версия пакетов. Теперь мы ссылаемся на @types/* с использованием строгой версии (больше нет ошибок lodash).
  • Предусмотрена поддержка XML (вместе с обновлением). Это можно использовать для подготовки необходимых полей, типов контента и списков для веб-части в режиме с "повышенными" правами. Мы подготовим публикации об этом для описания подробностей.
  • Мы завершили формат сериализации на классических страницах. Удалите и снова добавьте свои веб-части. Мы будем поддерживать старый формат сериализации в течение короткого времени, после чего он перестанет работать.
  • require('./config/docs.config.html'); теперь возвращает объект в формате общедоступной версии, а не в виде строки RC0

Известные проблемы

Мы временно удалили office-ui-fabric-react из шаблона react, пока не сможем преобразовать пакет в форму, готовую к будущим изменениям. Ожидается, что это займет пару недель.