Angular Academy · Ders

npm'ye Yayınlama

Kitaplığınızın sürümünü belirleyip yayınlayın

npm'ye Yayınlama, CoddyKit'te ücretsiz bir Angular 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, Angular Academy öğrenme yolunun bir parçasıdır ve ilerlemeniz web ve CoddyKit uygulaması arasında senkronize olur. Angular Academy kursu toplamda 4 dersten oluşur.

Kitaplığınızı Dünyayla Paylaşma

Bir kitaplık Angular Paket Biçimi'ne derlendikten sonra genellikle npm olmak üzere bir kayıt deposunda yayımlanır; böylece herhangi bir proje onu npm install ile kurabilir. Bu derste sürümlendirme ve yayımlama iş akışı ele alınır.

Kaynak Kodu Değil dist Çıktısını Yayımlayın

Oluşturulmuş package.json dosyasını ve derlenmiş paketleri içeren dist/<lib> altındaki derlenmiş paketi yayımlarsınız; ham kaynak projesini değil. Paketin kullanılabilir olmasını sağlayan adım derlemedir.

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

Anlamsal Sürümleme

npm paketleri semver kullanır: MAJOR.MINOR.PATCH. Düzeltmeler için PATCH'i, geriye dönük uyumlu özellikler için MINOR'u, geriye dönük uyumluluğu bozan değişiklikler için MAJOR'u artırın. Tüketiciler güvenli biçimde yükseltme yapmak için buna güvenir.

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)

Sürümü Ayarlama

Sürüm, kitaplığın kendi package.json dosyasından gelir. Derlemeden önce sürümü güncelleyin veya tutarlı biçimde artırmak için npm version kullanın.

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

npm'e Giriş Yapma

Yayımlamadan önce kayıt deposunda kimlik doğrulaması yapın. npm login, yayımlama komutunun yetkilendirilmesi için bir belirteç depolar.

npm login
# enter username, password / token, email

Yayımlama

Derlenmiş paket klasöründen npm publish komutunu çalıştırın. npm paketi yükler ve adından ve sürümünden yararlanılarak kurulabilir hale getirir.

cd dist/ui-kit
npm publish

Kapsamlı Paketler

Kuruluş paketleri @myorg/ui-kit gibi bir kapsam kullanır. Kapsamlı paketler npm'de varsayılan olarak özeldir; herkese açık yayımlamak için --access public seçeneğini geçin.

npm publish --access public

Yayımlanan Kitaplığı Kurma

Tüketiciler daha sonra onu diğer bağımlılıklar gibi ekler ve genel API'sinden içe aktarır. Angular, oluşturulan package.json üzerinden FESM paketini ve türleri bulur.

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

Yayın Öncesi Sürümler ve Etiketler

Kararsız derlemeleri next gibi bir dağıtım etiketi altında yayımlayın; böylece varsayılan latest sürümü haline gelmezler. Tüketiciler bunları açıkça seçerek kullanır.

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

Özel Kayıt Depoları

Yalnızca kurum içinde kullanılacak kitaplıklar için .npmrc dosyasını yapılandırarak özel bir kayıt deposuna (npm özel paketleri, GitHub Packages veya Verdaccio) yayımlayın. Yayımlama iş akışı aynıdır; yalnızca kayıt deposu URL'si ve kimlik doğrulama bilgileri farklıdır.

CI'da Otomatikleştirme

Olgun ekipler etiketlenmiş bir sürümde CI üzerinden yayımlar: işlem hattı kitaplığı derler, testleri çalıştırır ve depolanmış bir belirteçle npm publish komutunu çalıştırır. Bu yaklaşım elle yapılan hataları önler ve sürümlerin işlem kayıtlarıyla izlenebilir kalmasını sağlar.

Kısa Kontrol

npm'e ne yayımlarsınız?

Özet

semver ile sürümlendirilmiş derlenmiş dist/<lib> çıktısını yayımlayın. Sürümü artırın, npm login komutunu, ardından npm publish komutunu çalıştırın (kapsamlı paketler için --access public, yayın öncesi sürümler için --tag next ekleyin). Tüketiciler npm install ile kurar ve genel API'den içe aktarır. Güvenilirlik için yayımlamayı CI'da otomatikleştirin.

Sıkça Sorulan Sorular

“npm'ye Yayınlama” dersi ücretsiz mi?

Evet — “npm'ye Yayınlama” 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 Angular Academy kursunun geri kalanını açmak için CoddyKit PRO'ya yükselt. Angular Academy kursu toplamda 4 dersten oluşur.

“npm'ye Yayınlama” dersinde ne öğreneceğim?

Kitaplığınızın sürümünü belirleyip yayınlayın Angular 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.

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

Önceden deneyim gerekmez. CoddyKit'te Angular 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” 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 Angular Academy dersinde kod yazıp çalıştırabilir miyim?

Evet. Her Angular 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

← Angular Academy Sayfasına Dön