Electron uygulaması için Windows yükleyici oluşturma

Electron size bir klasörde çalışan bir Windows uygulaması verir: MyApp.exe, birkaç DLL, resources/app.asar ve yerel ayar dosyaları. Bu klasörü bir Setup.exe'ye dönüştürmek ayrı bir adımdır ve alışılmış araçların (electron-builder, Squirrel, electron-forge maker'ları) her biri kendi yapılandırmasını, kendi tuhaflıklarını ve derleme makinesi gereksinimlerini beraberinde getirir. Sihirbaz tarzı bir yükleyici için bunları öğrenmek istemiyorsanız kısa yol burada.

1. adım: uygulamayı bir klasöre paketleyin

Geliştirme projesi değil, paketlenmiş uygulama gerekir. Aşağıdaki iki araçtan herhangi biri dağıtabileceğiniz bir klasör üretir.

Electron Packager (tek komut, yapılandırma dosyası yok):

npx @electron/packager . MyApp --platform=win32 --arch=x64 --icon=build/icon.ico --overwrite

Bu komut, içinde MyApp.exe bulunan MyApp-win32-x64/ klasörünü oluşturur.

Electron Forge, projeniz zaten kullanıyorsa:

npm run package

Klasör out/ altında görünür, örneğin out/MyApp-win32-x64/.

Her iki komut da Windows, macOS ve Linux'ta çalışır. --icon bayrağı (veya Forge'da packagerConfig.icon) MyApp.exe içine gömülen simgeyi belirler; bu .ico dosyasını yükleyici için de kullanacağınızdan elinizin altında tutun.

Klasörü açın ve paketlenmiş uygulamanın başladığından emin olmak için MyApp.exe dosyasına çift tıklayın. 32 bit derleme gerekiyorsa bunun yerine --arch=ia32 kullanın.

2. adım: klasörü zip'leyin

Üst projeyi değil, MyApp-win32-x64/ klasörünün içeriğini (.exe, DLL'ler, resources/, locales/) zip'leyin. Zip içindeki her şey olduğu gibi kurulur; bu yüzden dağıtılmaması gereken hiçbir şeyi eklemeyin.

3. adım: yükleyiciyi oluşturun

1. Zip dosyasını ExeTup'a yükleyin. Dosyaları listeler ve MyApp.exe dosyasını ana program olarak seçer; onaylayın.
2. Uygulama adını, sürümü (package.json ile aynı olsun), yayıncıyı ve isteğe bağlı bir lisansı girin.
3. Kurulum kapsamını seçin. Electron uygulamaları genellikle kullanıcı başına kurulur; bu, yönetici hakları gerektirmez ve Squirrel tabanlı yükleyicilerin yaptığıyla örtüşür. Uygulamanın makinedeki herkes için Program Files altında olmasını istiyorsanız tüm kullanıcılar seçeneğini seçin.
4. x64 paket için 64 bit seçeneğini koruyun.
5. Yükleyici ve kısayollar için aynı .ico dosyasını yükleyin, Başlat menüsü ve masaüstü kısayollarını açın ve isterseniz “kurulumdan sonra başlat” seçeneğini etkinleştirin.
6. Derleyin, Setup.exe dosyasını indirin ve Windows'ta test edin.

Electron'a özgü noktalar

• Boyut. Paketlenmiş bir Electron uygulaması sıkıştırılmamış hâlde 150 ila 250 MB'dir. Yükleyici katı (solid) LZMA sıkıştırması kullanır ve bu genellikle boyutu 60 ila 90 MB'a düşürür. Zip'lemeden önce fiyatlandırma bölümünden yükleme sınırını kontrol edin; sınır site tarafından belirlenir.
• Otomatik güncellemeler. Bu yükleyici bir güncelleme akışı içermez. electron-updater veya Squirrel'in güncelleme mekanizmasını kullanıyorsanız o yolda kalın; bu kılavuz, yeni sürümleri yeni bir yükleyici olarak dağıtan uygulamalar içindir; bu daha basittir ve pek çok uygulama için yeterlidir.
• Başlangıçta çalıştırma. Seçimin kurulum sırasında yapılmasını istiyorsanız app.setLoginItemSettings yerine yükleyicinin “başlangıçta çalıştır” seçeneğini tercih edin; ikisi de aynı türde bir Run girdisi yazar.
• Kod imzalama. Paketlenmiş MyApp.exe ve Setup.exe, siz imzalamadığınız sürece imzasızdır. İmzasız indirmeler SmartScreen uyarısını tetikleyebilir; SmartScreen kılavuzuna bakın.

electron-builder'ın NSIS hedefiyle karşılaştırma

electron-builder da bir NSIS yükleyicisi üretebilir ve tüm özellik setine ihtiyacınız olduğunda iyi bir araçtır: delta güncellemeler, özel NSIS betikleri, MSI çıktısı, imzalama kancaları. Bedeli ise yapılandırma ve bakımı gereken bir derleme ortamıdır. ExeTup aynı türde NSIS yükleyicisini paketlenmiş klasörden, seçenekleri bir formda ayarlayarak oluşturur; bu da ara sıra sürüm çıkaran ya da Mac'te derleme yapıp yalnızca yükleyici için bir Windows hattı istemeyen ekiplere uygundur.

Sık sorulan sorular

Paketlenmiş uygulama yerine Electron proje klasörünü yükleyebilir miyim?

Hayır. Yükleyici, Electron Packager veya Forge'un çıktısını, yani MyApp.exe dosyasını içeren klasörü sarmalar. Kaynak proje, node_modules ve geliştirme araçlarının orada yeri yoktur.

Bir Electron uygulaması hangi kurulum kapsamını kullanmalı?

Yaygın seçim kullanıcı başınadır; çünkü yönetici onayı istemeden kullanıcının kendi klasörüne kurulur. BT departmanları uygulamayı bir makinedeki her hesap için dağıtacaksa tüm kullanıcıları seçin.

Kaldırma sırasında uygulamanın açık olmasıyla yükleyici başa çıkabilir mi?

Kaldırıcı, kurduğu dosyaları siler. Her Windows programında olduğu gibi kullanıcılardan önce uygulamayı kapatmalarını isteyin; çalışan bir .exe kapanana kadar silinemez.

Bu, Tauri veya NW.js ile oluşturulan uygulamalarda da çalışır mı?

Evet. Bir Windows .exe dosyası ve dosyalarını içeren her klasör sarmalanabilir. Tauri kendi paketleyicisiyle gelir, ancak düz paketlenmiş çıktı burada aynı şekilde çalışır.