İnternetsiz Bilgisayara VS Code Eklentisi Kurma

Bu yazıda, Visual Studio Code için internet bağlantısı olmayan bir bilgisayara bir eklentiyi (örnek olarak: Microsoft'un C# eklentisi) nasıl kurulacağını adım adım anlatacağız.

Kurmak istediğimiz eklenti:

  • Eklenti adı: C#
  • Yayıncı: Microsoft
  • Eklenti kimliği: ms-dotnettools.csharp
  • Marketplace adresi: https://marketplace.visualstudio.com/items?itemName=ms-dotnettools.csharp

İnternetsiz bilgisayarda doğrudan VS Code Marketplace kullanılamayacağı için, gerekli .vsix dosyalarını internet bağlantısı olan başka bir bilgisayarda indirip offline bilgisayara taşıyacağız.

1. VSIX Dosyası Nedir?

VS Code eklentileri .vsix uzantılı paketler halinde dağıtılır.

Normalde VS Code içerisinde Extensions bölümünden bir eklentiyi yüklediğimizde bu dosya arka planda otomatik olarak indirilir ve kurulur.

İnternet olmayan bir bilgisayarda ise aynı işlemi manuel olarak yapabiliriz:

  1. VSIX dosyasını internetli bilgisayarda indiririz.
  2. USB bellek veya ağ üzerinden offline bilgisayara taşırız.
  3. VS Code'a manuel olarak kurarız.

2. İnternetli Bilgisayarda PowerShell Açın

Windows'ta PowerShell'i açın.

Örneğin:

Başlat → PowerShell

İndirme işlemlerini yapmak için ayrı bir klasör oluşturmak faydalı olacaktır.

Örneğin:

mkdir C:\VSCodeOfflineExtensions
cd C:\VSCodeOfflineExtensions

3. C# Eklentisinin VSIX Dosyasını İndirin

Microsoft C# eklentisinin en güncel sürümünü indirmek için aşağıdaki PowerShell komutunu çalıştırın:

Invoke-WebRequest `
  -Uri "https://marketplace.visualstudio.com/_apis/public/gallery/publishers/ms-dotnettools/vsextensions/csharp/latest/vspackage" `
  -OutFile "ms-dotnettools.csharp.vsix"

Komut tamamlandıktan sonra klasörde şu dosya oluşmalıdır:

ms-dotnettools.csharp.vsix

Dosyanın oluştuğunu kontrol etmek için:

dir

komutunu kullanabilirsiniz.

4. .NET Install Tool Bağımlılığını da İndirin

C# eklentisi, Microsoft'un .NET Install Tool eklentisini kullanabilir.

Bu nedenle offline kurulum yaparken bu eklentinin VSIX dosyasını da önceden indirmek faydalıdır.

PowerShell'de:

Invoke-WebRequest `
  -Uri "https://marketplace.visualstudio.com/_apis/public/gallery/publishers/ms-dotnettools/vsextensions/vscode-dotnet-runtime/latest/vspackage" `
  -OutFile "ms-dotnettools.vscode-dotnet-runtime.vsix"

İşlem sonunda klasörde en az şu iki dosya bulunmalıdır:

ms-dotnettools.csharp.vsix
ms-dotnettools.vscode-dotnet-runtime.vsix

5. Ubuntu Üzerinden VSIX Dosyalarını İndirme

İnternet bağlantısı olan bilgisayar Ubuntu ise aynı .vsix dosyalarını wget veya curl kullanarak indirebilirsiniz.

Önce bir klasör oluşturabilirsiniz:

mkdir -p ~/VSCodeOfflineExtensions
cd ~/VSCodeOfflineExtensions

C# Eklentisini wget ile İndirme

wget -O ms-dotnettools.csharp.vsix \
"https://marketplace.visualstudio.com/_apis/public/gallery/publishers/ms-dotnettools/vsextensions/csharp/latest/vspackage"

C# Eklentisini curl ile İndirme

curl -L \
"https://marketplace.visualstudio.com/_apis/public/gallery/publishers/ms-dotnettools/vsextensions/csharp/latest/vspackage" \
-o ms-dotnettools.csharp.vsix

Buradaki -L parametresi HTTP yönlendirmelerini takip etmek için kullanılır.

.NET Install Tool Bağımlılığını Ubuntu'da İndirme

wget ile:

wget -O ms-dotnettools.vscode-dotnet-runtime.vsix \
"https://marketplace.visualstudio.com/_apis/public/gallery/publishers/ms-dotnettools/vsextensions/vscode-dotnet-runtime/latest/vspackage"

veya curl ile:

curl -L \
"https://marketplace.visualstudio.com/_apis/public/gallery/publishers/ms-dotnettools/vsextensions/vscode-dotnet-runtime/latest/vspackage" \
-o ms-dotnettools.vscode-dotnet-runtime.vsix

İndirme tamamlandıktan sonra dosyaları kontrol etmek için:

ls -lh *.vsix

Örneğin:

ms-dotnettools.csharp.vsix
ms-dotnettools.vscode-dotnet-runtime.vsix

dosyalarını görmelisiniz.

Bu dosyaları daha sonra USB bellek, SCP, Samba veya başka bir yöntemle internet bağlantısı olmayan bilgisayara taşıyabilirsiniz.

6. Dosyaları Offline Bilgisayara Taşıyın

Oluşan .vsix dosyalarını:

  • USB bellek,
  • harici disk,
  • yerel ağ,
  • paylaşımlı klasör

gibi bir yöntemle internet bağlantısı olmayan bilgisayara aktarın.

Örneğin offline bilgisayarda dosyaları şu klasöre koyabilirsiniz:

C:\VSIX

7. VS Code Üzerinden VSIX Kurma

Offline bilgisayarda Visual Studio Code'u açın.

Daha sonra:

Extensions
    ↓
Sağ üstteki "..." menüsü
    ↓
Install from VSIX...

seçeneğine tıklayın.

Önce şu dosyayı seçin:

ms-dotnettools.vscode-dotnet-runtime.vsix

Daha sonra:

ms-dotnettools.csharp.vsix

dosyasını kurun.

Kurulum tamamlandıktan sonra VS Code'u yeniden başlatmak faydalı olabilir.

8. Komut Satırından VSIX Kurma

VS Code'un code komutu PATH içerisinde tanımlıysa kurulumu terminalden de yapabilirsiniz.

Önce VSIX dosyalarının bulunduğu klasöre geçin:

cd C:\VSIX

Daha sonra bağımlılığı kurun:

code --install-extension ms-dotnettools.vscode-dotnet-runtime.vsix

Ardından C# eklentisini kurun:

code --install-extension ms-dotnettools.csharp.vsix

Kurulu eklentileri görmek için:

code --list-extensions

çıktısında aşağıdakilere benzer satırlar görmelisiniz:

ms-dotnettools.csharp
ms-dotnettools.vscode-dotnet-runtime

9. .NET SDK'nın Kurulu Olduğunu Kontrol Edin

C# geliştirme yapabilmek için yalnızca VS Code eklentisinin kurulması yeterli değildir.

Bilgisayarda uygun bir .NET SDK da bulunmalıdır.

Kontrol etmek için:

dotnet --info

veya:

dotnet --list-sdks

komutunu çalıştırın.

Örneğin:

8.0.419 [C:\Program Files\dotnet\sdk]

gibi bir çıktı görüyorsanız .NET SDK kuruludur.

Eğer:

'dotnet' is not recognized...

benzeri bir hata alıyorsanız offline bilgisayara ayrıca .NET SDK kurulmalıdır.

10. .NET SDK'yı da Offline Kurmak

.NET SDK kurulum dosyasını da internetli bilgisayardan önceden indirmeniz gerekir.

Microsoft'un resmi .NET indirme sayfasından kullandığınız Windows mimarisine uygun SDK kurulum paketini indirin.

Genellikle 64 bit Windows sistemlerde:

Windows x64 SDK Installer

paketi kullanılır.

İndirdiğiniz .exe dosyasını VSIX dosyalarıyla birlikte offline bilgisayara taşıyıp normal şekilde kurabilirsiniz.

Kurulumdan sonra:

dotnet --info

komutuyla tekrar kontrol edin.

11. Basit Bir C# Projesi ile Test Etme

Kurulumların doğru çalıştığını doğrulamak için terminal açıp:

mkdir CSharpTest
cd CSharpTest

komutlarını çalıştırın.

Yeni bir console projesi oluşturun:

dotnet new console

Daha sonra klasörü VS Code ile açın:

code .

Oluşan Program.cs dosyasında varsayılan olarak buna benzer bir kod bulunacaktır:

Console.WriteLine("Hello, World!");

Programı çalıştırmak için:

dotnet run

kullanın.

Çıktı:

Hello, World!

şeklinde olmalıdır.

12. Belirli Bir Eklenti Sürümünü İndirmek

latest kullanıldığında Marketplace'teki en yeni sürüm indirilir.

Örneğin:

.../csharp/latest/vspackage

adresindeki latest, en güncel C# eklentisini ifade eder.

Kurumsal veya tamamen kapalı bir ortamda aynı sürümü birden fazla bilgisayara kuracaksanız, indirdiğiniz VSIX dosyalarını saklamak iyi bir fikirdir.

Bu sayede Marketplace'teki sürüm daha sonra değişse bile bütün bilgisayarlara aynı paketi kurabilirsiniz.

Dosya adını sürüm bilgisi içerecek şekilde de değiştirebilirsiniz:

ms-dotnettools.csharp-<surum>.vsix

13. Özet

Offline bir bilgisayara VS Code C# desteği kurmak için temel süreç şöyledir:

  1. İnternetli bilgisayarda C# eklentisinin VSIX paketini indirin.
  2. .NET Install Tool VSIX paketini de indirin.
  3. Gerekliyse .NET SDK offline kurulum paketini indirin.
  4. Dosyaları USB veya başka bir yöntemle offline bilgisayara taşıyın.
  5. Önce .NET Install Tool, ardından C# eklentisini kurun.
  6. dotnet --info ile SDK'yı kontrol edin.
  7. dotnet new console ve dotnet run ile kurulumu test edin.

En önemli iki VSIX indirme komutu şunlardır:

Invoke-WebRequest `
  -Uri "https://marketplace.visualstudio.com/_apis/public/gallery/publishers/ms-dotnettools/vsextensions/csharp/latest/vspackage" `
  -OutFile "ms-dotnettools.csharp.vsix"

ve:

Invoke-WebRequest `
  -Uri "https://marketplace.visualstudio.com/_apis/public/gallery/publishers/ms-dotnettools/vsextensions/vscode-dotnet-runtime/latest/vspackage" `
  -OutFile "ms-dotnettools.vscode-dotnet-runtime.vsix"

Bu yöntemle VS Code C# geliştirme ortamını internet bağlantısı olmayan Windows bilgisayarlara da kurabilirsiniz.