electron/docs-translations/tr-TR/tutorial/application-distribution.md

6.6 KiB
Raw Blame History

Application Distribution

Electron uygulamanızı dağıtmak için önce Electron nun [prebuilt mimarilerini] (https://github.com/electron/electron/releases) indirmeniz gerekmektedir. Sonrasında, uygulamanızın bulundugu klasör app şeklinde isimlendirilmeli ve Electron kaynaklar klasörüne aşagıda gösterildiği gibi yerleştirilmelidir. Unutmayın, Electronun prebuilt mimarileri aşağıdaki örneklerde electron/ şeklinde belirtilmiştir.

MacOS da:

electron/Electron.app/Contents/Resources/app/
├── package.json
├── main.js
└── index.html

Windows ve Linux da:

electron/resources/app
├── package.json
├── main.js
└── index.html

Ardından Electron.app (veya electron Linux'da, electron.exe Windows'da) şeklinde çalıstırın, ve Electron uygulama şeklinde çalışacaktır. electron klasörü son kullanıcıya aktaracağınız dağıtımınız olacaktır.

Uygulamanın bir dosya şeklinde paketlenmesi

Tüm kaynak kodlarını kopyalama yoluyla uygulamanızı dağıtmak haricinde, uygulamanızı asar ile arşiv haline getirerek, kaynak kodlarınızın kullanıcılar tarafından görülmesini engelliye bilirsiniz.

app klasörü yerine asar arşiv dosyası kullanmak için, arşiv dosyanızı app.asar şeklinde isimlendirmeniz gerekiyor, ve bu dosyayı Electron'nun kaynak klasörüne aşağıdaki gibi yerleştirmelisiniz. Böylelikle Electron arşivi okuyup ondan başlayacaktır.

MacOS'da:

electron/Electron.app/Contents/Resources/
└── app.asar

Windows ve Linux'da:

electron/resources/
└── app.asar

Daha fazla bilgi için Application packaging.

İndirilen mimarileri yeniden adlandırma

Uygulamanızı Electron ile paketledikten sonra ve kullanıcılara uygulamanızı dağıtmadan önce adını değiştirmek isteye bilirsiniz.

Windows

electron.exe istediğiniz şekilde yeniden adlandırabilirsiniz. Icon ve diğer bilgileri bu gibi araçlar rcedit ile düzenleye bilirsiniz.

macOS

Electron.app'i istediğiniz şekilde yeniden adlandırabilirsiniz, ve aşağıdaki dosyalarda CFBundleDisplayName, CFBundleIdentifier ve CFBundleName kısımlarınıda düzenlemelisiniz.

  • Electron.app/Contents/Info.plist
  • Electron.app/Contents/Frameworks/Electron Helper.app/Contents/Info.plist

Görev yöneticisinde Electron Helper şeklinde göstermek yerine, isterseniz helper uygulamasınında adını değiştire bilirsiniz, ancak dosyanın adınıılabilir olduğundan emin olun.

Yeniden adlandırılmış uygulamanın klasör yapısı bu şekilde görünecektir:

MyApp.app/Contents
├── Info.plist
├── MacOS/
│   └── MyApp
└── Frameworks/
    ├── MyApp Helper EH.app
    |   ├── Info.plist
    |   └── MacOS/
    |       └── MyApp Helper EH
    ├── MyApp Helper NP.app
    |   ├── Info.plist
    |   └── MacOS/
    |       └── MyApp Helper NP
    └── MyApp Helper.app
        ├── Info.plist
        └── MacOS/
            └── MyApp Helper

Linux

electron dosyasını istediğiniz şekilde yeniden adlandırabilirsiniz.

Paketleme Araçları

Uygulamanızı manuel şekilde paketlemek dışında, üçüncü parti paketleme araçlarıylada otomatik olarak ayni şekilde paketliye bilirsiniz:

Kaynaktan yeniden kurulum yoluyla isim değişikliği

Ürün adını değiştirip, kaynaktan kurulum yoluylada Electron'nun adını değiştirmek mümkün. Bunun için atom.gyp dosyasını yeniden modifiye edip, tekrardan temiz bir kurulum yapmalısınız.

grunt-build-atom-shell

Manuel olarak Electron kodlarını kontrol edip tekrar kurulum yapmak biraz zor olabilir, bu yüzden tüm bu işlemleri otomatik olarak gerçekleştirecek bir Grunt görevi oluşturuldu: grunt-build-atom-shell.

Bu görev otomatik olarak .gyp dosyasını düzenleyecek, kaynaktan kurulumu gerçekleştirecek, sonrasında ise uygulamanızın doğal Node modüllerini, yeni yürütülebilen isim ile eşleştirmek icin tekrardan kuracaktır.

Özel bir Electron kopyası oluşturma

Electron'un size ait bir kopyasını oluşturmak, neredeyse uygulamanızı kurmak için hiç ihtiyacınız olmayacak bir işlemdir, "Production Level" uygulamalarda buna dahildir. electron-packager veya electron-builder gibi araçlar kullanarak yukarıda ki işlemleri gerçekleştirmeksizin, "Rebrand" Electron işlemini uygulaya bilirsiniz.

Eğer kendinize ait yüklenemiyen veya resmi versiyondan red edilmiş, direk olarak Electron a paketlediğiniz C++ kodunuz var ise, öncelikle Electron'un bir kopyasını oluşturmalısınız. Electron'nun destekleyicileri olarak, senaryonuzun çalışmasını çok isteriz, bu yüzden lütfen yapacağınız değişiklikleri Electron'nun resmi versiyonuna entegre etmeye calışın, bu sizin için daha kolay olacaktır, ve yardimlarınız için cok minnettar olacağız.

surf-build İle Özel Dağıtım oluşturulması

  1. Npm yoluyla Surf yükleyin: npm install -g surf-build@latest

  2. Yeni bir S3 bucket ve aşağıdakı boş klasör yapısını oluşturun:

    - atom-shell/
      - symbols/
      - dist/
    
  3. Aşağıdaki Ortam Değişkenlerini ayarlayın:

  • ELECTRON_GITHUB_TOKEN - GitHub üzerinden dağıtım oluşturan token
  • ELECTRON_S3_ACCESS_KEY, ELECTRON_S3_BUCKET, ELECTRON_S3_SECRET_KEY - node.js bağlantılarını ve sembollerini yükleyeceğiniz yer
  • ELECTRON_RELEASE - true şeklinde ayarlayın ve yükleme işlemi çalışacaktır, yapmamanız halinde, surf-build sadece CI-type kontrolü yapacak, tüm pull isteklerine uygun hale getirecektir.
  • CI - true olarak ayarlayın yoksa çalışmayacaktır.
  • GITHUB_TOKEN - bununla aynı şekilde ayarlayın ELECTRON_GITHUB_TOKEN
  • SURF_TEMP - Windowsda ki 'path too long' sorunundan kaçınmak için C:\Temp şeklinde ayarlayın
  • TARGET_ARCH - ia32 veya x64 şeklinde ayarlayın
  1. script/upload.py dosyasında ki ELECTRON_REPO kısmını, kendi kopyanız ile değiştirmek zorundasınız, özellikle eğer bir Electron proper destekleyicisi iseniz.

  2. surf-build -r https://github.com/MYORG/electron -s YOUR_COMMIT -n 'surf-PLATFORM-ARCH'

  3. Kurulum bitene kadar uzunca bekleyin.