Angular Academy · Pelajaran

Mempublikasikan ke npm

Beri versi dan publikasikan pustaka Anda.

Pelajaran 4 dari 413 langkah

Mempublikasikan ke npm adalah pelajaran Angular 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 Angular Academy, dan progresmu tersinkronisasi di web dan aplikasi CoddyKit. Kursus Angular Academy mencakup 4 pelajaran total.

Membagikan Pustaka Anda kepada Dunia

Setelah dibuild ke Angular Package Format, pustaka dipublikasikan ke registri, biasanya npm, sehingga proyek apa pun dapat memasangnya dengan npm install. Pelajaran ini membahas pembuatan versi dan alur kerja publikasi.

Publikasikan Keluaran dist, Bukan Sumber

Publikasikan paket hasil build di dist/<lib>, yang berisi package.json yang dibuat otomatis dan bundel terkompilasi, bukan proyek sumber mentah. Langkah build inilah yang membuatnya dapat digunakan.

ng build ui-kit --configuration production
cd dist/ui-kit

Pembuatan Versi Semantik

Paket npm menggunakan semver: MAJOR.MINOR.PATCH. Naikkan PATCH untuk perbaikan, MINOR untuk fitur yang kompatibel dengan versi sebelumnya, dan MAJOR untuk perubahan yang merusak. Pengguna mengandalkan aturan ini untuk melakukan peningkatan dengan aman.

0.0.1 -> 0.1.0   # new feature, no breaks (minor)
0.1.0 -> 0.1.1   # bug fix (patch)
0.1.1 -> 1.0.0   # breaking change (major)

Menetapkan Versi

Versi berasal dari package.json milik pustaka. Perbarui sebelum melakukan build, atau gunakan npm version untuk menaikkannya secara konsisten.

# inside projects/ui-kit (or use the field directly)
npm version minor   # bumps and tags the version

Masuk ke npm

Lakukan autentikasi ke registri sebelum memublikasikan. npm login menyimpan token agar perintah publikasi memperoleh otorisasi.

npm login
# enter username, password / token, email

Publikasi

Dari direktori paket hasil build, jalankan npm publish. npm mengunggah paket dan membuatnya dapat dipasang berdasarkan nama dan versinya.

cd dist/ui-kit
npm publish

Paket Berscope

Paket organisasi menggunakan scope seperti @myorg/ui-kit. Di npm, paket berscope secara bawaan bersifat privat; teruskan --access public untuk memublikasikannya secara publik.

npm publish --access public

Memasang Pustaka yang Dipublikasikan

Pengguna kemudian menambahkannya seperti dependensi lain dan mengimpor dari API publiknya. Angular menemukan bundel FESM dan tipe melalui package.json yang dibuat otomatis.

npm install ui-kit
// then:
import { ButtonComponent } from 'ui-kit';

Pra-Rilis dan Tag

Publikasikan build yang belum stabil di bawah dist-tag seperti next agar tidak menjadi latest bawaan. Pengguna harus memilihnya secara eksplisit.

npm publish --tag next
npm install ui-kit@next

Registri Privat

Untuk pustaka yang hanya digunakan secara internal, publikasikan ke registri privat (paket privat npm, GitHub Packages, atau Verdaccio) dengan mengonfigurasi .npmrc. Alur kerja publikasinya sama; yang berbeda hanya URL registri dan autentikasinya.

Otomatiskan dalam CI

Tim yang matang memublikasikan dari CI pada rilis yang diberi tag: pipeline membuild pustaka, menjalankan pengujian, dan menjalankan npm publish dengan token yang tersimpan. Hal ini menghindari kesalahan manual dan menjaga agar versi dapat dilacak ke commit.

Pemeriksaan Singkat

Apa yang Anda publikasikan ke npm?

Jawab di pelajaran interaktif

Rangkuman

Publikasikan keluaran dist/<lib> hasil build yang telah diberi versi dengan semver. Naikkan versinya, jalankan npm login, lalu npm publish (tambahkan --access public untuk paket berscope dan --tag next untuk pra-rilis). Pengguna menjalankan npm install dan mengimpor dari API publik. Otomatiskan publikasi dalam CI untuk keandalan.

Gratis untuk memulai

Belajar HTML dengan tutor AI — gratis

Tulis dan jalankan kode asli di browser kamu, dapatkan bantuan instan dari tutor AI 24/7, dan lanjutkan di mana kamu tinggalkan di web atau aplikasi.

Kursus: 38
Pelajaran: 144

Mulai belajar gratis Lihat kursus lengkapnya

Pertanyaan yang Sering Diajukan

Apakah pelajaran “Mempublikasikan ke npm” gratis?

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

Apa yang akan aku pelajari di “Mempublikasikan ke npm”?

Beri versi dan publikasikan pustaka Anda. Kamu berlatih Angular 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 Angular Academy?

Tidak diperlukan pengalaman sebelumnya. Angular 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” 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 Angular Academy ini?

Ya. Setiap pelajaran Angular 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

← Kembali ke Angular Academy