Node Package Manager, известен като npm, е онлайн хранилище за публикуване на NodeJS пакети и библиотеки.
Освен това е инструмент за команден ред, който ви позволява да взаимодействате с регистрирани пакети. Може да помогне при инсталиране на пакети, управление на версии и управление на зависимости.
Разработчиците публикуват своите JavaScript библиотеки на npm всеки ден. Процесът е доста прост, така че вие също можете да публикувате пакет в npm.
Стъпка 1: Инсталиране на NodeJS
За да взаимодействате с npm, трябва да го имате глобално инсталиран на вашата система.
Започнете от инсталиране на NodeJS и npm на Ubuntu, на Windows, или като следвате инструкциите на NodeJS уебсайт.
Стъпка 2: Създаване на npm акаунт
За да публикувате вашите пакети в npm, трябва да създадете npm акаунт на официалния уебсайт на npm.
Следвайте стъпките по-долу, за да създадете npm акаунт:
- Отидете на npm регистрация страница.
- Попълнете данните си, съгласете се с лиценза и политиката за поверителност и щракнете върху „Създаване на акаунт“.
- Потвърдете своя имейл с връзката, която ще получите от npm във вашата пощенска кутия.
Ако не потвърдите имейл адреса си, npm ще изведе грешка, когато се опитате да публикувате вашите пакети.
Стъпка 3: Инициализиране на Git хранилище
След това трябва да инициализирате Git хранилище, за да проследите всички промени, които ще направите във вашия проект.
На вашия терминал отидете до основната директория на вашия проект и изпълнете следната команда, за да инициализирате празно Git хранилище.
git init
Създавам .gitignore файл и добавете всички файлове, които не искате Git да проследява. След това изпълнете следната команда, за да проследите останалите файлове:
git add -A
След това изпълнете следната команда, за да направите първата си моментна снимка, като изпратите кода към Git.
git ангажирам -м начален-ангажирам
Можете да изберете да хоствайте своето Git хранилище в GitHub или подобна услуга като Gitlab за безпроблемно сътрудничество.
Стъпка 4: Инициализиране на npm във вашия проект
След това инициализирайте npm във вашия проект, за да добавите подробности за вашия проект към файл package.json. Тези подробности ще бъдат публични в npm.
На вашия терминал отидете до главната директория на вашия проект и изпълнете следната команда, за да инициализирате npm във вашия проект.
npm инициал
Командата по-горе ще задейства набор от подкани на вашия команден ред:
- име на пакета: Това е името на вашия npm пакет; трябва да е уникален, ако искате да публикувате пакета на npm; в противен случай npm ще изведе грешка.
- версия: Това свойство обозначава текущата версия на вашия пакет. Трябва да го увеличавате всеки път, когато актуализирате пакета си, или npm ще изведе грешка. Стойността по подразбиране е 1.0.0.
- описание: Това свойство е описанието на вашия пакет. Той ще бъде публичен, когато публикувате своя пакет.
- входна точка: Това свойство обозначава името на файла, където започва изпълнението на вашия код.
- тестова команда: Това свойство показва командата, която ще се изпълни, когато изпълните npm стартирайте тест.
- git хранилище: Това свойство е URL адресът за вашето отдалечено Git хранилище.
- ключови думи: Това свойство обозначава съответните ключови думи за вашия проект, които ще помогнат на търсачката да го намери.
- автор: Това свойство трябва да е вашето име или псевдоним.
- Разрешително: Това е лицензът, под който искате да публикувате пакета. Лицензът по подразбиране е лицензът на Internet Systems Consortium (ISC).
След като настроите това, можете да създадете своя пакет.
Стъпка 5: Тестване на вашия пакет
След като приключите със създаването на своя пакет, трябва да го тествате локално, за да видите как ще се държи, след като го разположите на npm.
За да тествате вашия пакет локално, първо изпълнете следната команда в директорията на вашия проект:
npm връзка
Командата по-горе ви позволява да посочите вашия пакет локално, както бихте направили пакет, хостван от npm.
След това създайте друга папка в главната директория на вашия проект и компактдиск в нея.
mkdir тест
cdтест
В тестовата папка изпълнете следната команда, за да свържете вашия пакет с папката:
npm връзка име-на-вашето-пакет
Накрая създайте фиктивен файл, за да тествате функционалността на вашия пакет.
След като завършите вашите тестове, можете безопасно да изтриете тестовата папка.
Стъпка 6: Влизане в npm във вашата система
След това трябва да влезете в своя npm акаунт във вашата система.
Изпълнете следната команда, за да влезете във вашия npm акаунт:
влизане в npm
Това ще ви подкани да попълните вашето потребителско име, парола и двуфакторен код за удостоверяване (ако сте го активирали в акаунта си).
Стъпка 7: Публикуване на вашия пакет
След като изпълните всички стъпки по-горе, изпълнете следната команда, за да публикувате пакета си в npm.
npm публикува
Тази команда изисква еднократна парола, която ще бъде към вашия имейл. След това ще публикува вашия пакет на npm.
Можете да видите пакетите, които сте публикували в npm. Влезте в своя npm акаунт на npmjs.com и отидете до секцията с пакети на таблото за управление на вашия профил.
За да инсталирате вашия пакет и да го използвате като зависимост от някой от вашите проекти, изпълнете:
npm Инсталирайиме-на-Вашият-пакет
Изтриване на вашия пакет от npm
Все още имате пълен контрол върху вашите пакети в npm, което означава, че можете да променяте и дори да изтриете пакета си за постоянно от npm. Можете да изтриете вашите пакети, като отидете в секцията с настройки на вашия пакет и изберете опцията за изтриване на пакет.