II/ Publish library lên NPM
1/ Khái niệm versioning
Trước khi publish lên, ta phải hiểu 1 chút về versioning bên NPM.
Tại NPM, ta phải để version như sau: MAJOR.MINOR.PATCH (x.x.x – ex: 1.0.0)
Ở version như vậy, ta sẽ hiểu ý nghĩa như sau:
- MAJOR: là khi ta hoàn toàn nâng cấp version, có API changes, thay đổi nhiều ở version cũ.
- MINOR: là khi ta update thêm features cho version hiện tại.
- PATCH: là khi ta có một patch để update nhỏ (fix bug, sửa lỗi,…)
Vậy nên ta cần phải follow theo version của NPM để quản lý version của library của chúng ta.
2/ Đăng nhập vào npm
Các bạn tạo account tại npmjs.com nhé, sau đó chạy lệnh này để login vào npm tại máy của bạn:
npm adduser
Để check xem bạn đã đăng nhập hay chưa, dùng lệnh:
npm whoami
3/ Tạo version cho library và publish lên NPM
Vì ta mới đưa library lên lần đầu, vậy version của chúng ta sẽ là 1.0.0, vậy nên ta chạy lệnh sau để gán version
npm version 1.0.0
Và chạy lệnh này luôn để publish lên NPM:
npm publish
(Với Git) Bởi vì ta quản lý theo version, thì khi ta chạy lệnh version của npm, nó sẽ tự tạo ra 1 tag version dành cho chúng ta lun, chúng ta chỉ cần push tag lên thôi :D, chạy tiếp lệnh:
git push --tags
Về phần tags này thì nó tương tự như Composer khi ta đưa package lên, same same vậy 😀
Vậy là ta đã publish thành công library lên NPM, các bạn có thể vào link sau để vào library của bạn:
https://www.npmjs.com/package/<package_name>
4/ Update lại NPM khi có thay đổi sau này
Cũng rất đơn giản thôi, sau khi đã sửa xong, push commit đã đời, bạn cũng chỉ chạy 2 lệnh tương tự:
npm version 1.0.1
npm publish
Vậy là NPM package của bạn đã được update 😀
# Build Javascript library và publish lên NPM