0Pricing
Vue Academy · Pelajaran

Mempublikasikan ke npm dan Penerapan Versi Semantik

Field package.json (main, module, exports), changelog, semantic-release, serta alur npm publish.

Mempublikasikan ke npm dan Penerapan Versi Semantik adalah pelajaran Vue Academy gratis di CoddyKit. Ini adalah pelajaran 4 dari 4. Kamu bisa membaca pelajaran lengkapnya di bawah secara gratis — lalu praktikkan langsung di browser dengan editor kode bawaan dan tutor AI 24/7. Ini adalah bagian dari jalur belajar Vue Academy, dan progresmu tersinkronisasi di web dan aplikasi CoddyKit. Kursus Vue Academy mencakup 4 pelajaran total.

Bersiap untuk Memublikasikan

Publikasi membuat pustaka Anda dapat dipasang melalui npm install. Sebelum itu, package.json harus mendeklarasikan titik masuk dengan benar dan Anda harus mengendalikan berkas yang disertakan.

main dan module

main menunjuk ke pembangunan CommonJS untuk alat yang lebih lama; module menunjuk ke pembangunan ESM agar penggabung modern memilih versi yang dapat menjalani penghapusan kode tak terpakai.

{
  "main": "./dist/my-ui-lib.cjs.js",
  "module": "./dist/my-ui-lib.es.js"
}

Peta exports

Kolom exports modern mendefinisikan titik masuk bersyarat. Kolom ini diprioritaskan daripada main/module dan mengendalikan akses subjalur.

{
  "exports": {
    ".": {
      "types": "./dist/index.d.ts",
      "import": "./dist/my-ui-lib.es.js",
      "require": "./dist/my-ui-lib.cjs.js"
    },
    "./style.css": "./dist/style.css"
  }
}

Ekspor Bersyarat

Kondisi import, require, dan types memungkinkan Node dan penggabung menemukan berkas yang tepat untuk ESM, CommonJS, dan TypeScript.

Mengendalikan Berkas yang Dipublikasikan

Gunakan kolom files untuk menentukan daftar berkas yang diizinkan, atau .npmignore untuk menentukan daftar berkas yang diblokir. Menyertakan dist dan mengecualikan sumber serta pengujian membuat paket tetap kecil.

{
  "files": ["dist"]
}

.npmignore

Jika Anda lebih memilih daftar blokir, .npmignore mengecualikan berkas meskipun tidak ada kolom files. Tanpa keduanya, npm memublikasikan hampir semua berkas.

# .npmignore
src
tests
vite.config.ts
*.log

Pratinjau npm pack

Jalankan npm pack untuk membuat arsip tar dan memeriksa tepat apa yang akan dipublikasikan—pemeriksaan keamanan penting sebelum dirilis.

npm pack
# inspect the listed files; nothing secret should appear

Penerapan Versi Semantik

SemVer menggunakan MAJOR.MINOR.PATCH. Naikkan versi perbaikan untuk perbaikan kesalahan yang kompatibel ke belakang, versi minor untuk fitur yang kompatibel ke belakang, dan versi major untuk perubahan yang merusak kompatibilitas.

Perintah npm version

Perintah npm version menaikkan versi dalam package.json dan membuat label git dalam satu langkah.

npm version patch   # 1.0.0 -> 1.0.1
npm version minor   # 1.0.1 -> 1.1.0
npm version major   # 1.1.0 -> 2.0.0

npm publish

npm publish mengunggah paket. Paket publik berskop memerlukan tanda --access public untuk pertama kalinya.

npm publish --access public

prepublishOnly dan dist-tag

Skrip prepublishOnly memastikan pembangunan baru dijalankan sebelum publikasi, sedangkan --tag next memublikasikan prarilis tanpa memindahkan label latest.

{
  "scripts": {
    "prepublishOnly": "npm run build"
  }
}
// npm publish --tag next

Pemeriksaan Singkat

Anda menambahkan properti opsional baru tanpa merusak penggunaan yang sudah ada. Kenaikan versi apa yang diperlukan?

Ringkasan

Konfigurasikan main, module, dan peta exports bersyarat (import/require/types), lalu kendalikan berkas yang disertakan dengan files atau .npmignore. Pratinjau dengan npm pack, kemudian naikkan versi sesuai SemVer menggunakan npm version patch/minor/major dan rilis dengan npm publish (tambahkan --access public untuk paket berskop).

Pertanyaan yang Sering Diajukan

Apakah pelajaran “Mempublikasikan ke npm dan Penerapan Versi Semantik” gratis?

Ya — teks lengkap “Mempublikasikan ke npm dan Penerapan Versi Semantik” gratis dibaca di sini di web. Untuk praktiknya secara interaktif (editor kode bawaan dan tutor AI 24/7) dan buka sisa kursus Vue Academy, upgrade ke CoddyKit PRO. Kursus Vue Academy mencakup 4 pelajaran total.

Apa yang akan aku pelajari di “Mempublikasikan ke npm dan Penerapan Versi Semantik”?

Field package.json (main, module, exports), changelog, semantic-release, serta alur npm publish. Kamu berlatih Vue Academy dengan kode praktik yang langsung kamu jalankan di browser, dan tutor AI 24/7 menjawab pertanyaanmu saat kamu mengerjakan pelajaran ini.

Apakah aku perlu pengalaman untuk memulai Vue Academy?

Tidak diperlukan pengalaman sebelumnya. Vue Academy di CoddyKit dirancang untuk pemula hingga pelajar tingkat lanjut, jadi kamu bisa memulai di sini atau dari awal dan belajar sesuai kecepatan kamu sendiri. Ini adalah pelajaran 4 dari 4.

Berapa lama pelajaran “Mempublikasikan ke npm dan Penerapan Versi Semantik” memakan waktu?

Sebagian besar pelajaran CoddyKit memakan waktu sekitar 5–10 menit. Setiap pelajaran ringkas dan interaktif, jadi kamu membuat kemajuan stabil dan melanjutkan dari tempat kamu tinggalkan di web dan aplikasi.

Bisakah aku menulis dan menjalankan kode dalam pelajaran Vue Academy ini?

Ya. Setiap pelajaran Vue Academy menyertakan editor kode bawaan, jadi kamu menulis dan menjalankan kode nyata langsung di browser dan mendapatkan umpan balik AI instan — tidak diperlukan penyiapan lokal.

Semua pelajaran dalam kursus ini

  1. Konfigurasi Mode Pustaka Vite
  2. Deklarasi TypeScript untuk Pustaka Komponen
  3. Tree-Shaking dan Impor Otomatis
  4. Mempublikasikan ke npm dan Penerapan Versi Semantik
← Kembali ke Vue Academy