Yapılandırma

Volta, JavaScript araç zincirinizi yönetmek için birkaç yapılandırma dosyası kullanır. Bu referans, mevcut yapılandırma seçeneklerini ve formatlarını açıklar.

Proje Yapılandırması

Projeye özel yapılandırmalar, projenizin package.json dosyasında volta anahtarı altında saklanır.

Format

{
  "volta": {
    "node": "16.14.2",
    "npm": "8.5.0",
    "yarn": "1.22.19",
    "extends": "../shared-volta-config.json"
  }
}

Özellikler

Özellik	Tür	Açıklama
node	String	Bu projede kullanılacak Node.js sürümü
npm	String	Bu projede kullanılacak npm sürümü
yarn	String	Bu projede kullanılacak Yarn sürümü
pnpm	String	Bu projede kullanılacak pnpm sürümü
extends	String	Paylaşılan bir Volta yapılandırma dosyasına yol

Sürüm Formatı

volta yapılandırmasındaki sürüm dizeleri aşağıdaki formatları kullanabilir:

• Tam sürüm: 16.14.2
• Yalnızca ana sürüm: 16
• Ana ve alt sürüm: 16.14
• Sürüm aralıkları (npm semver): ^16.14.0
• Etiketler: latest, lts

Paylaşılan Proje Yapılandırması

Birden fazla projenin genişletebileceği paylaşılan Volta yapılandırmaları oluşturabilirsiniz. Bu, projeler genelinde araç sürümlerini standartlaştırmak isteyen kuruluşlar için kullanışlıdır.

Format

{
  "node": "16.14.2",
  "npm": "8.5.0"
}

Format, package.json içindeki volta bölümüyle aynıdır, ancak JSON dosyasının kök düzeyindedir.

Kullanıcı Yapılandırması

Volta'nın kullanıcı yapılandırması Volta ev dizininde saklanır:

• Unix: ~/.volta/
• Windows: %LOCALAPPDATA%\Volta\

Araç Depolama

Kurulu araçlar yapılandırılmış dizinlerde saklanır:

• Node.js: ~/.volta/tools/image/node/
• Paket yöneticileri: ~/.volta/tools/image/yarn/, ~/.volta/tools/image/npm/
• Paketler: ~/.volta/tools/user/packages/

Hooks Dizini

Özel hook'lar ~/.volta/hooks/ dizininde saklanır. Daha fazla ayrıntı için Gelişmiş Özellikler bölümüne bakın.

Ortam Değişkenleri

Ortam değişkenleri, Volta'nın davranışını yapılandırmanın başka bir yolunu sağlar. Tam referans için Ortam Değişkenleri sayfasına bakın.

Yapılandırma Önceliği

Hangi araç sürümünün kullanılacağını çözerken, Volta kaynakları aşağıdaki sırayla kontrol eder:

1. Komut satırı bağımsız değişkenleri (ör. volta run --node 14)
2. En yakın package.json içindeki proje yapılandırması (bir volta bölümüyle)
3. Kullanıcının varsayılan araç sürümleri (volta install ile ayarlanır)
4. Paketlenmiş sürümler (ör. Node.js ile birlikte gelen npm)

Örnekler

Tipik Proje Yapılandırması

{
  "name": "my-project",
  "version": "1.0.0",
  "volta": {
    "node": "16.14.2",
    "npm": "8.5.0"
  },
  "dependencies": {
    // ...
  }
}

Genişletilmiş Yapılandırma

// shared-config.json
{
  "node": "16.14.2",
  "yarn": "1.22.19"
}

// package.json
{
  "name": "my-project",
  "version": "1.0.0",
  "volta": {
    "extends": "./shared-config.json",
    "npm": "8.5.0"  // Genişletilmiş yapılandırmadaki herhangi bir npm sürümünü geçersiz kılar
  }
}

Çalışma Alanı Yapılandırması

Çalışma alanı tabanlı projeler için, kök package.json yapılandırması tüm çalışma alanı paketleri için geçerlidir:

// Kök package.json
{
  "name": "workspace-root",
  "volta": {
    "node": "16.14.2",
    "yarn": "1.22.19"
  },
  "workspaces": [
    "packages/*"
  ]
}

// packages/app/package.json - Node.js 16.14.2 ve Yarn 1.22.19 kullanacaktır
{
  "name": "app",
  "version": "1.0.0",
  // Burada volta bölümüne gerek yok
}