SharePoint Framework версии 1.6: заметки о выпуске
Этот выпуск включает две основные возможности.
- Окончательный выпуск функции веб-API, впервые представленной в версии 1.4.1.
- Поддержка настройки расширений на уровне клиента без необходимости в активации и настройке каждого сайта.
Дата выпуска: 5 сентября 2018 г.
Важно!
На этой странице рассматриваются сведения, связанные с определенной версией выпуска SPFx. На этой странице не содержатся дополнительные предварительные требования SPFx, которые необходимо установить для разработки решений SPFx, включая Node.js, Yeoman и другие средства.
Дополнительные сведения об этих предварительных требованиях см. в статье Настройка среды разработки SharePoint Framework.
- В файле package.json проекта определите все пакеты SPFx версии 1.5.1. Для каждого пакета SPFx:
Удалите существующий пакет версии 1.5.1:
npm uninstall @microsoft/{spfx-package-name}@1.5.1
Установите обновленный пакет версии 1.6:
npm install @microsoft/{spfx-package-name}@1.6.0 --save --save-exact
Совет
В CLI для Microsoft 365 доступно удобное пошаговое руководство по обновлению ваших решений до последней версии SharePoint Framework.
В общедоступную версию функции веб-API внесено несколько изменений. Доступ к ресурсам, защищенным с помощью AAD, осуществляется через стороннее приложение AAD и субъект-службу. Приложение создается в первый раз, когда администратор клиента утверждает область разрешений, и создается без каких-либо разрешений. Таким образом, любое подключение к данным (через Microsoft Graph или вызов конечной точки, использующей AAD для получения разрешений) необходимо разрешать в явном виде.
Важно!
Все разрешения, предоставленные до выпуска версии 1.6.0, необходимо предоставить заново, так как мы изменили используемое приложение AAD.
- Используйте класс
MSGraphClient
. Он существует в контексте компонента (веб-части или расширения). В целях повышения производительности полный код загружается по запросу, поэтому доступ к нему осуществляется через обещание. - Перестаньте использовать класс
GraphHttpClient
(если еще не перестали). Ориентировочно в следующем месяце мы полностью удалим его из кода. Все решения, использующие этот класс, перестанут работать. - По аналогии с
MSGraphClient
существует общий классAadHttpClient
вне контекста для вызова конечных точек, защищенных с помощью AAD, а также класс AadTokenProvider, который можно использовать для получения маркеров проверки подлинности вручную.
Теперь вы можете создавать конфигурации расширений на уровне клиента. Самый простой способ (для разработчика) выполнить развертывание на уровне клиента — изменить файл \SharePoint\ClientInstance.xml (созданный вместе с новым решением версии 1.6.0). При этом создается запись в новом списке из каталога приложений (“Расширения на уровне клиента”). Вы также можете изменить список напрямую как владелец каталога приложений.
Мы стараемся упразднить некоторые оболочки распространенных средств сборки. Первыми из них станут этапы компилятора tslint и ts. В связи с этими изменениями старый код не будет компилироваться без некоторых изменений.
- Во-первых, в корне исходного каталога должен быть файл *.ts (по умолчанию мы создаем файл в папке \src с именем index.ts, который пуст).
- Во-вторых, изменились расположение файла tslint.json (с папки \config на корневой каталог проекта) и его формат. Теперь это просто стандартный файл tslint.json. Проще всего создать новый проект и скопировать из него файл tslint.json.
- В-третьих, найдите файл tsconfig.json из корневой папки нового проекта, созданного на этапе 2, и скопируйте его в корневой каталог исходного проекта. Если вы внесли изменения в файл tsconfig.json, необходимо объединить их.
В пакете @microsoft/sp-dialog обнаружены некоторые классы, помеченные как бета-версия. Мы заменили их на общедоступные версии.
Примечание
Это последний выпуск, в котором средства сборки поддерживают Node.js версии 6.