Angular Academy · Pelajaran

Menerbitkan ke npm

Nomborkan versi dan terbitkan pustaka anda.

Pelajaran 4 daripada 413 langkah

Menerbitkan ke npm ialah pelajaran Angular Academy percuma di CoddyKit. Ini ialah pelajaran 4 daripada 4. Sebanyak 3 pelajaran dalam laluan pembelajaran ini boleh dibaca sepenuhnya secara percuma — selepas itu, CoddyKit PRO membuka akses kepada semua pelajaran, serta latihan praktikal dengan penyunting kod terbina dalam dan tutor kecerdasan buatan yang tersedia 24/7. Pelajaran ini merupakan sebahagian daripada laluan pembelajaran Angular Academy, dan kemajuan anda disegerakkan merentas web serta aplikasi CoddyKit. Kursus Angular Academy merangkumi sejumlah 4 pelajaran.

Berkongsi Pustaka Anda dengan Dunia

Setelah dibina menjadi Format Pakej Angular, pustaka diterbitkan ke pendaftaran, biasanya npm, supaya mana-mana projek boleh memasangnya dengan npm install. Pelajaran ini merangkumi pemversian dan aliran kerja penerbitan.

Terbitkan Keluaran dist, Bukan Sumber

Anda menerbitkan pakej yang telah dibina dalam dist/<lib>, yang mengandungi package.json yang dijana dan bundle yang telah dikompil, bukannya projek sumber mentah. Langkah binaanlah yang menjadikannya boleh digunakan.

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

Pemversian Semantik

Pakej npm menggunakan semver: MAJOR.MINOR.PATCH. Naikkan PATCH untuk pembaikan, MINOR untuk ciri yang serasi ke belakang dan MAJOR untuk perubahan yang merosakkan keserasian. Pengguna bergantung pada aturan ini untuk menaik taraf dengan selamat.

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 datang daripada package.json pustaka itu sendiri. Kemas kini sebelum membina, 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

Log Masuk ke npm

Sahkan diri dengan pendaftaran sebelum menerbitkan. npm login menyimpan token supaya arahan penerbitan dibenarkan.

npm login
# enter username, password / token, email

Penerbitan

Dari direktori pakej yang telah dibina, jalankan npm publish. npm memuat naik pakej dan menjadikannya boleh dipasang menggunakan nama serta versinya.

cd dist/ui-kit
npm publish

Pakej Berskop

Pakej organisasi menggunakan skop seperti @myorg/ui-kit. Pakej berskop adalah peribadi secara lalai di npm; hantarkan --access public untuk menerbitkannya kepada umum.

npm publish --access public

Memasang Pustaka yang Diterbitkan

Pengguna kemudian menambahkannya seperti mana-mana kebergantungan dan mengimport daripada API awamnya. Angular mencari bundle FESM dan jenis melalui package.json yang dijana.

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

Pra-keluaran dan Tag

Terbitkan binaan yang tidak stabil di bawah tag pengedaran seperti next supaya binaan tersebut tidak menjadi latest lalai. Pengguna memilih untuk menggunakannya secara jelas.

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

Pendaftaran Peribadi

Untuk pustaka dalaman sahaja, terbitkan ke pendaftaran peribadi (pakej peribadi npm, GitHub Packages atau Verdaccio) dengan mengkonfigurasi .npmrc. Aliran kerja penerbitan adalah sama; hanya URL pendaftaran dan pengesahan yang berbeza.

Automatikkan dalam CI

Pasukan yang matang menerbitkan daripada CI pada keluaran yang ditag: saluran paip membina pustaka, menjalankan ujian dan menjalankan npm publish dengan token yang disimpan. Ini mengelakkan kesilapan manual dan memastikan versi boleh dijejaki kepada komit.

Semakan Pantas

Apakah yang anda terbitkan ke npm?

Imbas Kembali

Terbitkan keluaran dist/<lib> yang telah dibina dan diberikan versi menggunakan semver. Naikkan versi, jalankan npm login, kemudian npm publish (tambahkan --access public untuk pakej berskop dan --tag next untuk pra-keluaran). Pengguna menjalankan npm install dan mengimport daripada API awam. Automatikkan penerbitan dalam CI untuk kebolehpercayaan.

Percuma untuk bermula

Pelajari HTML dengan tutor kecerdasan buatan — percuma

Tulis dan jalankan kod sebenar dalam pelayar anda, dapatkan bantuan segera daripada tutor kecerdasan buatan yang tersedia 24/7, dan sambung semula dari tempat anda berhenti di web atau dalam aplikasi.

Kursus
38
Pelajaran
144

Soalan Lazim

Adakah pelajaran “Menerbitkan ke npm” percuma?

Ya — sebanyak 3 pelajaran dalam laluan pembelajaran Angular Academy, termasuk “Menerbitkan ke npm”, boleh dibaca sepenuhnya secara percuma di web ini. Selepas itu, CoddyKit PRO membuka akses kepada semua pelajaran, serta latihan interaktif dengan penyunting kod terbina dalam dan tutor kecerdasan buatan yang tersedia 24/7. Kursus Angular Academy merangkumi sejumlah 4 pelajaran.

Apakah yang akan saya pelajari dalam “Menerbitkan ke npm”?

Nomborkan versi dan terbitkan pustaka anda. Anda berlatih Angular Academy menggunakan kod praktikal yang dijalankan terus dalam pelayar, manakala tutor kecerdasan buatan 24/7 menjawab soalan anda semasa anda mengikuti pelajaran.

Adakah saya memerlukan pengalaman untuk memulakan Angular Academy?

Tiada pengalaman terdahulu diperlukan. Pembelajaran Angular Academy di CoddyKit disusun untuk pelajar daripada peringkat pemula hingga lanjutan, jadi anda boleh bermula di sini atau dari awal dan belajar mengikut kadar anda sendiri. Ini ialah pelajaran 4 daripada 4.

Berapa lamakah pelajaran “Menerbitkan ke npm” diambil?

Kebanyakan pelajaran CoddyKit mengambil masa kira-kira 5–10 minit. Setiap pelajaran ringkas dan interaktif, jadi anda boleh membuat kemajuan secara berterusan dan menyambung tepat dari tempat anda berhenti di web atau aplikasi.

Bolehkah saya menulis dan menjalankan kod dalam pelajaran Angular Academy ini?

Ya. Setiap pelajaran Angular Academy menyertakan penyunting kod terbina dalam, jadi anda boleh menulis dan menjalankan kod sebenar terus dalam pelayar serta menerima maklum balas kecerdasan buatan serta-merta — tanpa memerlukan persediaan setempat.

Semua pelajaran dalam kursus ini

  1. Mencipta Pustaka dengan ng generate
  2. API Awam dan Titik Masuk
  3. Membina dengan ng-packagr
  4. Menerbitkan ke npm
← Kembali ke Angular Academy