TypeScript Academy · Ders

TypeScript Proje Başvurularını Açıklama

Çok paketli derlemeler için composite ve references ayarlarını kullanın

TypeScript Proje Başvurularını Açıklama, CoddyKit'te ücretsiz bir TypeScript Academy dersidir. Bu, 4 dersinin 1. 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, TypeScript Academy öğrenme yolunun bir parçasıdır ve ilerlemeniz web ve CoddyKit uygulaması arasında senkronize olur. TypeScript Academy kursu toplamda 4 dersten oluşur.

Proje Başvuruları Nedir?

Proje başvuruları, bir TypeScript kod tabanını birbirine bağımlılık bildiren birden çok tsconfig projesine bölmenize olanak tanır; böylece artımlı ve yalıtılmış derlemeler etkinleştirilir.

// tsconfig.json (root)
{
  "references": [
    { "path": "./packages/core" },
    { "path": "./packages/ui" }
  ]
}

Birleşik Projeler

Başvurulan her projede tsconfig dosyasında "composite": true bulunmalıdır. Bu seçenek, bildirimlerin önbelleğe alınmasını ve bağımlılıkların izlenmesini sağlar.

// packages/core/tsconfig.json
{
  "compilerOptions": {
    "composite": true,
    "declaration": true,
    "outDir": "./dist"
  }
}

tsc --build ile Derleme

Tüm başvurulan projeleri bağımlılık sırasına göre derlemek için kök dizinden tsc --build (veya tsc -b) komutunu çalıştırın.

# Build all projects
tsc --build

# Build and watch
tsc --build --watch

# Clean build outputs
tsc --build --clean

Artımlı Yeniden Derlemeler

İlk derlemeden sonra tsc --build, yalnızca kaynak dosyaları veya bağımlılıkları değişen projeleri yeniden derler ve büyük depolardaki derlemeleri önemli ölçüde hızlandırır.

# Only changed packages are rebuilt
tsc --build
# Output: 2/5 projects up to date — skipping

Bildirim Dosyalarını Kullanma

Başvurulan bir proje, bağımlılıklarını kaynak TypeScript dosyalarını yeniden ayrıştırarak değil, dist/ içindeki oluşturulmuş .d.ts dosyaları aracılığıyla kullanır.

// packages/ui imports from packages/core
import { Button } from "@myapp/core"; // resolved via dist/index.d.ts

Yol Yapılandırması

Geliştirme sırasında TypeScript'in paket içe aktarmalarını doğru şekilde çözümlemesi için kök tsconfig dosyasında paths ayarlayın veya package.json içinde exports kullanın.

{
  "compilerOptions": {
    "paths": {
      "@myapp/core": ["./packages/core/src/index.ts"]
    }
  }
}

Derleme Sırasını Koruma

TypeScript, derleme sırasını başvuru grafiğinden otomatik olarak belirler. Döngüsel başvurular algılanır ve hata olarak bildirilir.

// Circular reference error example:
// packages/core references packages/ui
// packages/ui references packages/core
// Error: Circular project reference

outDir ve rootDir

Her birleşik projede, çıktı düzenini denetlemek ve paket sınırları arasında dosya sızmasını önlemek için outDir ve rootDir yapılandırılmalıdır.

{
  "compilerOptions": {
    "rootDir": "./src",
    "outDir": "./dist"
  }
}

Derleme Araçlarıyla Tümleştirme

Turborepo, Nx ve Lerna; bağımlılık grafiğine göre derlemeleri önbelleğe almak ve paralel yürütmek için proje başvurularıyla tümleşir.

// turbo.json — declare TypeScript build as a pipeline step
{
  "pipeline": {
    "build": { "dependsOn": ["^build"], "outputs": ["dist/**"] }
  }
}

Birden Çok Projeyi İzleme

tsc --build --watch, başvurulan tüm projeleri izler ve her değişiklikte artımlı olarak yeniden derler; böylece monorepo'larda neredeyse anında geri bildirim sağlar.

# Terminal: tsc --build --watch
# [9:00:01 AM] Found 0 errors. Watching for file changes.

Özet: Proje Başvuruları

Proje başvuruları, TypeScript'i yalıtılmış ve önbelleğe alınabilir derleme birimlerine böler. Monorepo'larda hızlı ve doğru artımlı derlemeler için composite: true ayarlayın, references bildirin ve tsc --build kullanın.

Kısa Denetim

Bir projenin başka bir proje tarafından başvurulabilmesi için hangi tsconfig seçeneği gereklidir?

Öğrendikleriniz

TypeScript proje başvuruları, monorepo'larda hızlı ve yalıtılmış derlemeler sağlar. composite: true yapılandırın, bağımlılıkları references aracılığıyla bildirin ve artımlı derleme için tsc --build ile derleyin.

Sıkça Sorulan Sorular

“TypeScript Proje Başvurularını Açıklama” dersi ücretsiz mi?

Evet — “TypeScript Proje Başvurularını Açıklama” 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 TypeScript Academy kursunun geri kalanını açmak için CoddyKit PRO'ya yükselt. TypeScript Academy kursu toplamda 4 dersten oluşur.

“TypeScript Proje Başvurularını Açıklama” dersinde ne öğreneceğim?

Çok paketli derlemeler için composite ve references ayarlarını kullanın TypeScript 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.

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

Önceden deneyim gerekmez. CoddyKit'te TypeScript 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 1. dersidir.

“TypeScript Proje Başvurularını Açıklama” 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 TypeScript Academy dersinde kod yazıp çalıştırabilir miyim?

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

TypeScript Proje Başvurularını Açıklama
TypeScript ile pnpm Çalışma Alanları
Paylaşılan Türler Paketi Stratejisi
Monorepo'larda Artımlı Derlemeler ve Önbellek

← TypeScript Academy Sayfasına Dön