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

В ближайшие дни и недели мы выпустим дополнительные обновленные документы и видеоролики с инструкциями. Мы очень ждем ваших отзывов о необходимых ресурсах и темах.

Выпущено: 14 марта 2019 г.

Важно!

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

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

Обновление проектов с версии 1.7.1 до версии 1.8.0

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

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

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

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

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

2. Убедитесь в наличии записи в разделе devDependency файла package.json, которая ссылается на "@microsoft/sp-tslint-rules": "1.8.0".

3. Добавьте пакет @microsoft/rush-stack-compiler-x-x в качестве devDependency пакета package.json. Сведения о правильной версии для использования см. в разделе Поддержка TypeScript 2.7, 2.9 и 3.x (общая доступность).

4. Обновите файл tsconfig.json , чтобы расширить конфигурацию TypeScript для версии @microsoft/rush-stack-compiler-x-x. Для этого измените верхнюю часть файла указанным ниже образом.

   • Для @microsoft/rush-stack-compiler-2-7 верхняя часть файла tsconfig.json будет выглядеть так:

     {
        "extends": "./node_modules/@microsoft/rush-stack-compiler-2.7/includes/tsconfig-web.json",
        "compilerOptions": { // ommitted for brevity }
     }
     

   • Для @microsoft/rush-stack-compiler-3-3 верхняя часть файла tsconfig.json будет выглядеть так:

     {
        "extends": "./node_modules/@microsoft/rush-stack-compiler-3.3/includes/tsconfig-web.json",
        "compilerOptions": { // ommitted for brevity }
     }
     

5. Исправьте все новые и примечательные ошибки tslint, которые теперь вызываются в новом компиляторе. Для больших проектов это может занять некоторое время. Поведение компиляторов TypeScript по умолчанию становится более строгим, но ваш код станет лучше благодаря этому.

Совет

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

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

Разработка SPFx для вкладок Teams (общая доступность)

Решения вкладок Teams, использующие SPFx, теперь полностью поддерживаются. Добавьте TeamsTab к свойству supportedHosts в манифесте веб-части и разверните его в каталоге приложений. Там вы можете выбрать решение и нажать кнопку "Синхронизировать с Teams". Теперь веб-часть будет отображаться в Teams как приложение. Когда веб-часть размещается на вкладке Teams, у нее есть доступ к SDK Teams в контексте веб-части. Изменения по сравнению с бета-выпуском в версии 1.7:

• Начальная и будущая конфигурации обрабатываются с помощью области свойств
• Свойству canUpdateConfiguration манифеста можно присвоить значение false, чтобы отключить конфигурацию после начальной конфигурации
• Уменьшение действий JavaScript по размещению веб-части
• Функция "Синхронизировать с Teams" для автоматизации создания и отправки манифеста Teams
• Обновление teams-js до версии 1.4.1
• Языковой стандарт определяется текущим языковым стандартом Teams

Дополнительные сведения:

• Создание вкладок Microsoft Teams с помощью SharePoint Framework
• Создание вкладки Microsoft Teams с помощью SharePoint Framework — руководство
• Создание манифеста Microsoft Teams для веб-части вручную и его развертывание в Microsoft Teams

Страницы приложений (общая доступность)

Мы часто получаем запросы на добавление платформы одностраничных приложений в SPFx. Мы надеемся, что страницы приложений подойдут для большинства целей, связанных с одностраничными приложениями, благодаря предоставлению похожей модели разработки и пользовательского интерфейса. Страницы приложений — это новый макет современной страницы SharePoint, в котором одна веб-часть размещается на всей странице, что обеспечивает согласованность дизайна (навигация, заголовок, тема и т. д.). Добавление SharePointFullPage к свойству supportedHosts манифеста веб-части приведет к добавлению страницы приложения с параметром веб-части при создании новой страницы.

Веб-часть можно настроить (если свойству canUpdateConfiguration не присвоено значение false), но макет или содержимое страницы изменить нельзя. Создание страниц приложений конечным пользователем будет развернуто позже в этом месяце с новым интерфейсом создания страниц. Пока же доступна статическая страница (расположенная по адресу _layouts/15/appPageHost.aspx?componentId=yourComponentGuidHere), на которой будет размещаться любой компонент со страницы приложения. Эта страница разворачивается сейчас и должна быть доступна во время выпуска или на пару дней позже, в зависимости от вашего клиента.

Дополнительные сведения:

• Использование страниц приложений с одной веб-частью в SharePoint Online

Веб-части, изолированные в домене (общая доступность)

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

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

Дополнительные сведения:

• Изолированные веб-части

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

Теперь вы можете создавать библиотеки, на которые могут ссылаться другие компоненты SPFx. Их немного сложно использовать, поэтому мы опубликуем отдельный документ с их подробным описанием. Сложность состоит в том, что для использования библиотеки ее необходимо опубликовать в веб-канале npm (подойдет внутренняя среда).

Дополнительные сведения:

• Использование типа компонента библиотеки в SharePoint Framework
• Создание решений с типом компонента библиотеки в SharePoint Framework

Поддержка TypeScript 2.7, 2.9 и 3.x (общая доступность)

В этом выпуске мы провели работу по отделению версии TypeScript от используемой вами версии SPFx. Теперь вы можете указать версию TypeScript, которую хотите использовать отдельно от системы сборки. Вы можете использовать любой компилятор, указанный здесь: https://www.npmjs.com/search?q=%40microsoft%2Frush-stack-compiler.

Примечание.

Используемый вами компилятор должен быть отражен в файле tsconfig.json со ссылкой на "extends": "./node_modules/@microsoft/rush-stack-compiler-2.7/includes/tsconfig-web.json", которая соответствует версии rush-stack-compiler, которую вы включаете.

В последний момент мы заметили, что некоторые из последних версий пакетов @microsoft/rush-stack-compiler работают неправильно. Если вы обнаружите, что установка npm выдает предупреждения о зависимостях одноранговых узлов для TypeScript и сборка завершается сбоем с жалобами на отсутствие компилятора, используйте более раннюю версию пакета.

Следующие версии компилятора @microsoft/rush-stack-compiler следует использовать с соответствующей версией TypeScript.

• TypeScript версии 2.7
  • @microsoft/rush-stack-compiler-2.7@0.5.7
• TypeScript версии 2.9
  • @microsoft/rush-stack-compiler-2.9@0.6.8
• TypeScript версии 3.0
  • @microsoft/rush-stack-compiler-3.0@0.5.9
• TypeScript версии 3.3
  • @microsoft/rush-stack-compiler-3.3@0.1.6

Варианты тем веб-части на современных страницах SharePoint

Для современных страниц SharePoint недавно была выпущена функция для применения цветов фона раздела. Веб-части могут обновлять свои темы, чтобы отразить цвет фона, поверх которого отрисовывается веб-часть. Если свойству supportsThemeVariants в манифесте веб-части присвоить значение true, это отключит стандартное поведение, при котором всегда отрисовывается белый фон.

Затем веб-части могут использовать SPFx ThemeProvider для получения уведомлений об изменениях цвета фона.

Дополнительные сведения:

• Поддержка фона раздела

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

Удален код PropertyPane из @microsoft/sp-webpart-base

Мы перемещаем код области свойств в другой пакет (@microsoft/sp-property-pane), содержащий всю логику области свойств, которая ранее существовала в @microsoft/sp-webpart-base. Запущенные в настоящее время решения будут продолжать работать (мы будем перенаправлять вызовы соответствующим образом), но API общедоступной области свойств в базе @microsoft/sp-webpart-base являются устаревшими в SPFx версии 1.8 и будут удалены в выпуске SPFx версии 1.9.

В вашем коде просто нужно изменить импортируемый пакет. Они имеют одинаковые типы и подписи, но находятся в другом пакете. Это позволяет нам загружать код области свойств (и все его зависимые пакеты) только при необходимости.

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

Использование устаревшей версии Fabric CSS

С момента выпуска SPFx версии 1.0 мы добавили на страницу набор Fabric CSS. Хотя с тех пор мы изменили принцип работы Fabric CSS, мы продолжали добавлять старую версию Fabric CSS на страницу. Это привело к добавлению большого количества ненужных стилей CSS. Начиная с SPFx 1.8.0 решения больше не будут загружать старую версию Fabric CSS.

Если вашему решению по-прежнему требуется поведение из версий, предшествующих 1.8.0, добавьте ”loadLegacyFabricCss”: true в манифест компонента.

Если ваши стили работают неправильно после обновления до версии 1.8.0, возможно, потребуется переключить этот параметр.

Вместо этого решение может импортировать таблицу стилей Fabric.css:

import 'office-ui-fabric-react/dist/css/fabric.css';

Известные проблемы и ограничения

Новый пользовательский интерфейс для создания страниц приложений зависит от нового интерфейса Добавление страницы на современных страницах. Эта возможность разворачивается в настоящее время, но выпуск в вашем клиенте может отставать на несколько дней.

Как упоминалось в разделе поддержки TypeScript, некоторые из последних сборок компилятора @microsoft/rush-stack-compiler , которые мы используем, имеют проблемы. Более ранние версии работают без проблем. Мы опубликуем обновления и уведомления, когда эти проблемы будут устранены.

Обновленная размещенная у поставщика модель для размещения решений Microsoft Teams в SharePoint Online (с помощью SDK Teams) по-прежнему находится в предварительной версии.

Поддержка динамических данных для изолированных частей домена ограничена источником данных контекста страницы. Полная поддержка динамических данных через границу iFrame будет доступна в будущем обновлении.