0Pricing
Vue Academy · Ders

npm'ye Yayınlama ve Anlamsal Sürümleme

package.json alanları (main, module, exports), değişiklik günlükleri, semantic-release ve npm publish akışı.

npm'ye Yayınlama ve Anlamsal Sürümleme, CoddyKit'te ücretsiz bir Vue Academy dersidir. Bu, 4 dersinin 4. dersidir. Aşağıdan dersin tamamını ücretsiz okuyabilir, sonra tarayıcıda yerleşik kod editörü ve 7/24 yapay zeka koçu ile uygulamalı olarak pratik yapabilirsin. Bu, Vue Academy öğrenme yolunun bir parçasıdır ve ilerlemeniz web ve CoddyKit uygulaması arasında senkronize olur. Vue Academy kursu toplamda 4 dersten oluşur.

Yayımlamaya Hazırlanma

Yayımlama, kütüphanenizin npm install aracılığıyla kurulabilmesini sağlar. Bundan önce package.json giriş noktalarını doğru şekilde bildirmeli ve hangi dosyaların pakete dahil edileceğini denetlemelisiniz.

Ana ve Modül Alanları

main, eski araçlar için CommonJS derlemesine yönlendirir; module ise modern paketleyicilerin ağaç budamasına uygun sürümü seçmesi için ESM derlemesine yönlendirir.

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

exports Haritası

Modern exports alanı koşullu giriş noktalarını tanımlar. main/module alanlarına göre önceliklidir ve alt yol erişimini denetler.

{
  "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"
  }
}

Koşullu Dışa Aktarımlar

import, require ve types koşulları, Node ve paketleyicilerin sırasıyla ESM, CommonJS ve TypeScript için doğru dosyayı çözümlemesini sağlar.

Yayımlanan Dosyaları Denetleme

Nelerin pakete dahil edileceğini izin listesiyle belirtmek için files alanını veya neleri engelleyeceğinizi belirtmek için bir .npmignore dosyasını kullanın. dist klasörünü dahil edip kaynak kodunu ve testleri dışarıda bırakmak paketi küçük tutar.

{
  "files": ["dist"]
}

.npmignore

Engelleme listesini tercih ediyorsanız .npmignore, files alanı ayarlanmamış olsa bile dosyaları dışarıda bırakır. İkisi de yoksa npm neredeyse her şeyi yayımlar.

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

npm pack Önizlemesi

Bir tar arşivi oluşturmak ve tam olarak nelerin yayımlanacağını incelemek için npm pack çalıştırın; bu, yayına geçmeden önce yapılması gereken kritik bir güvenlik kontrolüdür.

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

Anlamsal Sürümleme

SemVer, MAJOR.MINOR.PATCH biçimini kullanır. Geriye dönük uyumlu hata düzeltmeleri için patch, geriye dönük uyumlu özellikler için minor ve uyumluluğu bozan değişiklikler için major değerini artırın.

npm version Komutları

npm version komutu, package.json içindeki sürümü artırır ve tek adımda bir git etiketi oluşturur.

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 ile Yayımlama

npm publish paketi yükler. Kapsamlı herkese açık paketlerde ilk yayımlama sırasında --access public bayrağı gerekir.

npm publish --access public

prepublishOnly ve dağıtım etiketi

prepublishOnly betiği yayımlamadan önce güncel bir derlemenin çalışmasını sağlar; --tag next ise latest etiketini değiştirmeden ön sürümleri yayımlar.

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

Hızlı Kontrol

Mevcut kullanımı bozmadan yeni bir isteğe bağlı özellik ekliyorsunuz. Hangi sürüm artırılmalıdır?

Özet

main, module ve koşullu bir exports haritasını (içe aktarma/gerektirme/türler) yapılandırın; pakete dahil edilen dosyaları files veya .npmignore ile denetleyin. npm pack ile önizleyin, ardından npm version patch/minor/major kullanarak SemVer kurallarına göre sürümü artırın ve npm publish ile yayımlayın (kapsamlı paketler için --access public ekleyin).

Sıkça Sorulan Sorular

“npm'ye Yayınlama ve Anlamsal Sürümleme” dersi ücretsiz mi?

Evet — “npm'ye Yayınlama ve Anlamsal Sürümleme” dersin tüm metni burada web'de ücretsiz olarak okunabilir. Etkileşimli olarak pratik yapmak (yerleşik kod editörü ve 7/24 yapay zeka koçu) ve Vue Academy kursunun geri kalanını açmak için CoddyKit PRO'ya yükselt. Vue Academy kursu toplamda 4 dersten oluşur.

“npm'ye Yayınlama ve Anlamsal Sürümleme” dersinde ne öğreneceğim?

package.json alanları (main, module, exports), değişiklik günlükleri, semantic-release ve npm publish akışı. Vue Academy ile uygulamalı kodu tarayıcıda doğrudan çalıştırarak pratik yaparsın ve 7/24 yapay zeka koçu dersi çalışırken sorularını yanıtlar.

Vue Academy öğrenmeye başlamak için deneyim gerekli mi?

Önceden deneyim gerekmez. CoddyKit'te Vue Academy, başlangıçtan ileri seviyeye kadar yapılandırıldığı için buradan başlayabilir veya başından başlayıp kendi hızında ilerleme yapabilirsin. Bu, 4 dersinin 4. dersidir.

“npm'ye Yayınlama ve Anlamsal Sürümleme” dersi ne kadar sürer?

Çoğu CoddyKit dersi yaklaşık 5–10 dakika sürer. Her biri kısa ve etkileşimli olduğu için sabit ilerleme yaparsın ve web ile uygulama arasında tam olarak bıraktığın yerden devam edebilirsin.

Bu Vue Academy dersinde kod yazıp çalıştırabilir miyim?

Evet. Her Vue Academy dersi yerleşik bir kod editörü içerir, bu sayede tarayıcıda gerçek kod yazıp çalıştırabilir ve anlık yapay zeka geri bildirimi alırsın — yerel kurulum gerekli değildir.

Bu kursun tüm dersleri

  1. Vite Kütüphane Modu Yapılandırması
  2. Bileşen Kütüphaneleri için TypeScript Bildirimleri
  3. Ağaç Sarsma ve Otomatik İçe Aktarma
  4. npm'ye Yayınlama ve Anlamsal Sürümleme
← Vue Academy Sayfasına Dön