Упражнение: настройка среды разработки SharePoint Framework
- 15 мин
В этом упражнении вы настроите в локальной среде разработчика о все необходимое для создания компонентов SharePoint Framework.
Установка редактора кода
Для редактирования файлов кода потребуется текстовый редактор. В текстовом редакторе нет требований.
В остальной части этого упражнении и в большинстве примеров, которые вы найдете в Корпорации Майкрософт, используйте Visual Studio Code.
Установите Node.js.
Средства, используемые при компиляции, отладке и упаковке проектов SharePoint Framework, созданы с использованием Node.js — среды выполнения, которая позволяет JavaScript работать локально, а не в браузере. Итак, первый шаг — установка среды выполнения Node.js перед установкой необходимых средств.
Примечание.
Node.js доступен в двух разных выпусках: выпуск с долгосрочной поддержкой (также известный как LTS) является наиболее стабильной версией, которая рекомендуется для большинства пользователей, в то время как текущая версия содержит последние функции.
Перед установкой Node.js необходимо убедиться, что вы еще не установили его. Откройте командную подсказку или терминал (в зависимости от платформы разработчика) и выполните следующую команду:
node -v
Если возвращается номер версии, значит у вас уже есть Node.js. Версии Node.js, которые можно использовать, зависят от сред, на которые вы будете ориентироваться.
При создании проектов для SharePoint Server 2016 необходимо использовать SharePoint Framework версии 1.1.0 из-за зависимостей версии на стороне сервера. Это означает, что нужно установить Node.js версии 6.x. Дополнительные сведения о разработке SharePoint Framework с помощью SharePoint Server 2016 см. в разделах разработка SharePoint Framework с помощью пакета дополнительных компонентов SharePoint Server 2016 с пакетом дополнительных компонентов 2 и SharePoint Framework разработка для SharePoint Server 2016 с пакетом дополнительных компонентов 2 сведения о том, как устранить проблему управления версиями с одной из зависимостей Yeoman.
Если вы создаете проекты для SharePoint Server 2019, необходимо использовать SharePoint Framework версии 1.4.1 из-за зависимостей версий на стороне сервера. Это означает, что нужно установить Node.js версии 6.x или 8.x. Дополнительные сведения о разработке SharePoint Framework с помощью SharePoint Server 2019 см. в разделах разработка SharePoint Framework с помощью SharePoint Server 2019 и Окончательное руководство для разработчиков: SharePoint Framework для SharePoint Server 2019.
Если вы создаете проекты для SharePoint Server по подписке с обновлением 23H1, необходимо использовать SharePoint Framework версии 1.5.1 из-за зависимостей версий на стороне сервера. Это означает, что нужно установить Node.js версии 6.x или 8.x. Дополнительные сведения о разработке SharePoint Framework с помощью SharePoint 2019 см. в разделах разработка SharePoint Framework с помощью SharePoint Server 2019 и Окончательное руководство для разработчиков: SharePoint Framework для SharePoint Server SE.
Если вы создаете проекты для SharePoint Online, рекомендуется установить последнюю версию Node.js версии 22.x LTS.
Если у вас уже есть версия Node.js, совместимая со средами, на которые вы будете нацеливаться, переходите к следующему разделу.
Откройте браузер и перейдите на сайт Node.js Foundation: https://www.nodejs.org.
Текущая версия LTS может быть несовместима с текущей версией SharePoint Framework, поэтому вы перейдете на сайт, чтобы скачать соответствующий установщик.
Выберите Загрузки в верхней области навигации меню, а затем выберите версию Узла, которую вы хотите установить для своей платформы, с помощью диспетчера версий узлов:
Или выберите готовый установщик для своей платформы:
Запустите установщик, приняв все параметры по умолчанию. При этом будут установлены Node.js и npm. npm — это диспетчер пакетов, который Node.js использует, аналогично . Net NuGet.
Важно!
В оставшейся части материала в этом модуле предполагается, что вы создаете проекты для SharePoint Online.
Установка необходимых средств
В процессе разработки SharePoint Framework используется набор инструментов на основе Node.js, популярных среди веб-разработчиков. Эти средства работают на платформе Node.js. Это означает, что их можно использовать на любой платформе и они будут работать одинаково. К ним относятся Windows, macOS и Linux.
Установка Yeoman
Yeoman — это механизм формирования шаблонов, который запускает генераторы, которые задают пользователю вопросы. На основе ответов на эти вопросы Yeoman затем создает папки и файлы, определенные генератором.
Откройте окно командной строки или терминала и выполните следующую команду, чтобы глобально установить Yeoman с помощью npm:
npm install yo --global
Установка Heft CLI
Heft — это служебная программа для выполнения задач. Она похожа на MSBuild — инструмент, используемый разработчиками .NET и Visual Studio для компиляции проектов, упаковки решений и запуска процесса отладки.
Чтобы установить Интерфейс командной строки Heft, откройте окно командной строки или терминала и выполните следующую команду:
npm install @rushstack/heft --global
Установка генератора Yeoman для SharePoint Framework
Корпорация Майкрософт создала генератор Yeoman для создания формирования шаблонов проектов SharePoint Framework.
Чтобы глобально установить последнюю версию генератора SharePoint Framework Yeoman с помощью npm, откройте окно командной строки или терминала и выполните следующую команду:
npm install @microsoft/generator-sharepoint --global
Чтобы глобально установить определенную версию генератора SharePoint Framework Yeoman с помощью npm, откройте окно командной строки или терминала и выполните следующую команду:
npm install @microsoft/generator-sharepoint@[version number] --global
Например:
npm install @microsoft/generator-sharepoint@1.5.1 --global
Сводка
В этом упражнении вы настроили в локальной среде разработчика все необходимое для создания компонентов SharePoint Framework.
Проверка знаний
Обратная связь
Были ли сведения на этой странице полезными?
Нет
Нужна помощь с этой темой?
Хотите попробовать использовать Ask Learn для уточнения или руководства по этой теме?