Дата публикации
28 Февраля 2021
Дата изменения
8 Марта 2021
Уникальных просмотров
3.013

Оглавление

Для начала нужно ответить на вопрос — зачем вам вообще использовать NPM? Ответ очень просто, вы можете написать некий плагин, компонент или скрипт и таскать его из проекта в проект. Если вдруг вы обнаружите ошибку или захотите улучшить ваше творение, вам придется во всех проектах ручками править код. Этого можно избежать, добавив ваше творение как отдельный пакет в NPM и подключать / обновлять его одной командой на всех ваших проектах.

Что нужно для работы с NPM?

Чтобы создать NPM-пакет у вас должен быть установлен Node.js. После установки Node.js, нужно убедиться что установка прошла корректно и заодно проверить его версию, сделать это можно следующей командой:

npm -v

Инициализация NPM-пакета

Перед тем как инициализировать NPM-пакет важно отметить, что для его грамотной и удобной разработки, лучше всего использовать какой-нибудь Git-репозиторий, например Github или Gitlab. Теперь в терминале, находясь в директории вашего NPM-пакета, нужно провести его инициализацию выполнив следующую команду:

npm init

Вам будут заданы вопросы про ваш NPM-пакет, вы можете ответить на них сразу или пропустить, нажав Enter. После ответов на вопросы, в директории пакета создаться файл package.json, в нем будет прописана основная информация о вашем пакете.

package.json

Вы можете редактировать файл package.json вручную. Вот основные и самые важные его настройки:

Перед тем как создавать пакет, убедитесь что такого названия в базе NPM еще нету. Для этого воспользуйтесь поиском на сайте, вбейте название которое придумали и проверье уникальность.

README.md

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

Пример README.md можете взять отсюда.

Публикация NPM-пакета

Для начала нужно пройти регистрацию на npmjs.com, сделать это можно из терминала командой:

npm adduser

Если же учетная запись у вас уже есть, то нужно авторизироваться в терминале:

npm login

Проверить под какой учетной записью вы находитесь можно с помощью команды:

npm whoami

Теперь можно публиковать NPM-пакет:

npm publish

После введения команды выше, ваш пакет отправиться на сервера NPM и будет доступен для подключения к проектам.

Обновление NPM-пакета

Без обновлений никуда. Для того чтобы правильно обновить пакет, вам нужно:

  1. Внести изменения в код.
  2. Обновить версию пакета командой npm version [ major | minor | patch ].
  3. Опубликовать новую версию пакета командой npm publish.

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

npm version patch

Команда npm version patch, увеличит версию пакета например, с 1.0.0 до 1.0.1. Незначительные исправления мелких ошибок.

npm version minor

Команда npm version minor, увеличит версию пакета например, с 1.0.0 до 1.1.0. Добавления нового функционала, который не влияет на уже существующий функционал.

npm version major

Команда npm version major, увеличит версию пакета например, с 1.0.0 до 2.0.0. Модификация пакета без обратной совместимости с предыдущей версией. Разработчик поймет что простое обновление пакета может что-то сломать и изучит вопрос правильного обновления на новую мажорную версию.

Удаление NPM-пакета

Удаление NPM-пакетов является очень плохим тоном, т. к. от этих пакетов могут зависеть проекты других пользователей. Однако, если после публикации пакета командой npm publish прошло менее 24 часов, то публикацию можно отменить командой npm unpublish. Пакеты, которые были добавлены более 24 часов назад, удалить нельзя.

Если все-таки вам необходимо удалить пакета, то напишите в поддержку, указав причину удаления пакета. Пакет будет помечен как @deprecated и исчезнет из вашего профиля.

Установка NPM-пакета

После того, как ваш NPM-пакет появился в вашем профиле, он будет доступен по ссылку:

https://www.npmjs.com/package/название-вашего-пакета

И его можно будет подключить к любому вашему проекту, с помощью команды:

npm i название-вашего-пакета

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

Благодарность автору

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

Один из самых популярных способов поблагодарить автора, воспользоваться сервисом Яндекс.Деньги.

Время работы: 0,1562 s
Время запросов: 0,1562 s
Количество запросов: 28
Источник: cache