Paketlarni nashr qilish (publish)

Paketni nashr qilish nimani anglatadi?

Paketni nashr qilish Node.js moduli yoki loyihangizni boshqalar uchun npm registr orqali o‘rnatishi va foydalanishi uchun ochiq qilish demakdir.

Node.js hamjamiyatiga ochiq manbali kutubxonalar va vositalar shu tarzda ulashiladi.

Paketni nashr qilganingizda, u npm install your-package-name yordamida har kim o‘rnatishi mumkin bo‘ladi.

Eslatma: Paketingiz qiymatga ega ekanligiga va u NPMdagi mavjud paketning dublikati emasligiga ishonch hosil qiling.

Paketingiz tayyorlanmoqda

1. Paketni ishga tushirish

Yangi katalog yarating va paketingizni ishga tushiring:

mkdir my-package
cd my-package
npm init -y

2. Muhim fayllar

Paket quyidagi asosiy fayllarni o‘z ichiga olishi kerak:

package.json - Paketingiz haqidagi metama’lumotlar
README.md - Documentation (supports Markdown)
index.js - Asosiy kirish nuqtasi (yoki package.json’da ko‘rsating)
LICENSE - Foydalanish shartlari (MIT, ISC va boshqalar)
.gitignore - node_modules, jurnallar va boshqalarni istisno qilish.
.npmignore - ixtiyoriy, chop etilgan paketdan fayllarni chiqarib tashlash uchun

3. Package.json asoslari

package.json quyidagi minimal maydonlarga ega ekanligiga ishonch hosil qiling:

{
  "name": "your-package-name",
  "version": "1.0.0",
  "description": "A brief description of your package",
  "main": "index.js",
  "scripts": {
    "test": "echo \"Error: no test specified\" && exit 1"
  },
  "keywords": ["keyword1", "keyword2"],
  "author": "Your Name <your.email@example.com>",
  "license": "MIT"
}

npm hisobini yaratish

1. Ro‘yxatdan o‘tish

Agar sizda yo‘q bo‘lsa, npmjs.com/signup sahifasida hisob yarating.

2. Elektron pochtangizni tasdiqlang

Nashr qilishdan oldin elektron pochtangizni tekshiring va hisobingizni tasdiqlang.

3. CLI orqali tizimga kiring

Terminalingizni oching va ishga tushiring:

npm login

Sizdan so‘raladi:

Foydalanuvchi nomi
Parol
Email (npm hisobingiz bilan mos kelishi kerak)
Bir martalik parol (agar 2FA yoqilgan bo‘lsa)

4. Kirish holatini tekshiring

npm whoami

Paketingizni nashr qilish

1. Ism mavjudligini tekshiring

npm view <package-name>

Agar bunday nomdagi paket mavjud bo‘lmasa, siz ushbu nomdan foydalanishingiz mumkin.

Agar shunday bo‘lsa, package.json da boshqa nom tanlashingiz kerak bo‘ladi.

2. Paketni mahalliy sinovdan o‘tkazish

Nashr qilishdan oldin paketingizni mahalliy sifatida sinab ko‘ring:

# In your package directory
npm link

# In another project directory
npm link <package-name>

3. npm Registry-da nashr qilish

# First, make sure you're in the right directory
cd path/to/your/package

# Publish to the public npm registry
npm publish

4. Muayyan teg bilan nashr qilish

npm publish --tag beta

5. Ommaviy paketni nashr qilish (agar pullik npm hisobidan foydalansangiz)

npm publish --access public

Paketingiz yangilanmoqda

1. Versiya raqamini yangilang

Paket versiyasini yangilash uchun semantik versiyadan (SemVer) foydalaning:

# For a patch release (bug fixes)
npm version patch

# For a minor release (backward-compatible features)
npm version minor

# For a major release (breaking changes)
npm version major

2. Changelogni yangilash

Ushbu versiyadagi o‘zgarishlarni hujjatlashtirish uchun CHANGELOG.md-ni yangilang.

3. Yangilanishni nashr qiling

npm publish

4. Relizga teg qo‘yish (ixtiyoriy)

Agar siz Git-dan foydalansangiz, nashr uchun teg yarating:

git tag -a v1.0.0 -m "Initial release"
git push origin v1.0.0

Nashr qilingan paketlarni boshqarish

Paketni nashrdan chiqarish

Paketni npm registridan olib tashlash uchun:

# Unpublish a specific version
npm unpublish <package-name>@<version>

# Unpublish the entire package (only works within 72 hours of publishing)
npm unpublish <package-name> --force

Muhim: Nashrni bekor qilish qat’iyan tavsiya etilmaydi, chunki u paketingizga bog‘liq bo‘lgan boshqa loyihalarni buzishi mumkin. Buning o‘rniga npm deprecate dan foydalanishni o‘ylab ko‘ring.

Paketni bekor qilish

Agar foydalanuvchilarning versiyani o‘rnatishiga yo‘l qo‘ymaslik, lekin uni mavjud foydalanuvchilar uchun mavjud bo‘lishini istasangiz:

# Deprecate a specific version
npm deprecate <package-name>@<version> "message"

# Example
npx deprecate my-package@1.0.0 "This version is no longer maintained. Please upgrade to v2.0.0"

Egalik huquqini o‘tkazish

Paketni boshqa foydalanuvchi yoki tashkilotga o‘tkazish uchun:

npm owner add <username> <package-name>

Eng yaxshi amaliyotlar

Semantik versiyaga rioya qiling - MAJOR.MINOR.PATCH versiya raqamlaridan mos ravishda foydalaning
Yaxshi hujjatlarni yozing - README-ga aniq foydalanish misollarini qo‘shing
Sinovlarni qo‘shish - Birlik testlarini qo‘shing va ularni qanday bajarishni hujjatlang
.npmignore dan foydalaning - Faqat kerakli fayllarni nashr qiling
Kalit so‘zlarni qo‘shish - Paketingizni boshqalarga topishga yordam bering
To‘g‘ri litsenziyani tanlang - Shartlaringizni foydalanuvchilarga tushunarli qiling
O‘zgarishlar jurnalini saqlash - Versiyalar orasidagi hujjat o‘zgarishlari
Uzluksiz integratsiyadan foydalanish - Sinov va nashrni avtomatlashtirish

Xulosa

Paketlarni npm-ga nashr qilish kodingizni Node.js hamjamiyatiga almashishning ajoyib usuli hisoblanadi.

Agar siz eng yaxshi amaliyotlarga amal qilsangiz va paketlaringizni yaxshi saqlasangiz, boshqalar qurishi mumkin bo‘lgan qimmatli vositalarni o‘z hissangizni qo‘shishingiz mumkin.

Yodda tuting: Katta kuch bilan katta mas’uliyat keladi. Paketni nashr qilganingizda, siz uni saqlab qolish yoki uning holatini foydalanuvchilarga aniq etkazish majburiyatini olasiz.

W3Schools Pathfinder

Yutuqlaringizni kuzating – bu bepul!

Ro'yxatdan o'tish Kirish