NPM Paketi — Programlı API

@microsoft/winappcli için TypeScript/JavaScript API’si başvurusu. Her CLI komutu, stdout/stderr yakalayan ve yazılan bir sonuç döndüren bir zaman uyumsuz işlev olarak kullanılabilir. MSIX kimliği, Elektron hata ayıklama kimliği ve derleme araçları için yardımcı yardımcı programlar da dışarı aktarılır.

Kurulum

npm install @microsoft/winappcli

Hızlı başlangıç

import { init, packageApp, certGenerate } from '@microsoft/winappcli';

// Initialize a new project with defaults
await init({ useDefaults: true });

// Generate a dev certificate
await certGenerate({ install: true });

// Package the built app
await packageApp({ inputFolder: './dist', cert: './devcert.pfx' });

Yaygın türler

Her bir CLI komut sarmalayıcısı, CommonOptions genişleten bir seçenekler nesnesini kabul eder ve Promise<WinappResult> döndürür.

`CommonOptions`

Çoğu komut tarafından paylaşılan temel seçenekler.

Mülkiyet	Türü	Zorunlu	Description
`quiet`	`boolean \\| undefined`	Hayır	İlerleme iletilerini gizleme.
`verbose`	`boolean \\| undefined`	Hayır	Ayrıntılı çıkışı etkinleştirin.
`cwd`	`string \\| undefined`	Hayır	CLI işlemi için çalışma dizini (varsayılan olarak process.cwd()).

`WinappResult`

Her komut sarmalayıcısının döndürdüğü sonuç.

Mülkiyet	Türü	Zorunlu	Description
`exitCode`	`number`	Yes	İşlem çıkış kodu (her zaman başarıda 0 – sıfır olmayan atmalar).
`stdout`	`string`	Yes	Kaydedilen standart çıkış.
`stderr`	`string`	Yes	Kaydedilen standart hata.

CLI komut sarmalayıcıları

Bu işlevler yerel winapp CLI komutlarını sarmalar. Tümü CommonOptions'ı (quiet, verbose, cwd) kabul eder.

`certGenerate()`

Yalnızca yerel test için otomatik olarak imzalanan bir sertifika oluşturun. Yayıncı, manifest ile eşleşmelidir (--manifest sağlandıysa veya Package.appxmanifest çalışma dizinindeyse otomatik olarak belirlenir). Çıkış: devcert.pfx (varsayılan parola: 'password'). Üretim için güvenilen bir CA'dan sertifika alın. Bu makineye güvenmek için 'cert install' komutunu kullanın.

function certGenerate(options?: CertGenerateOptions): Promise<WinappResult>

Seçenekler:

Mülkiyet	Türü	Zorunlu	Description
`exportCer`	`boolean \\| undefined`	Hayır	pfx ile birlikte yalnızca ortak anahtar içeren .cer dosyasını dışa aktarma
`ifExists`	`IfExists \\| undefined`	Hayır	Çıkış dosyası mevcut olduğunda davranış: 'error' (fail, default), 'skip' (var olanı koru) veya 'overwrite' (değiştir)
`install`	`boolean \\| undefined`	Hayır	Sertifikayı oluşturma sonrasında yerel makine deposuna yükleme
`json`	`boolean \\| undefined`	Hayır	Çıktıyı JSON olarak biçimlendirme
`manifest`	`string \\| undefined`	Hayır	Yayımcı bilgilerini ayıklamak için Package.appxmanifest veya appxmanifest.xml dosyasının yolu
`output`	`string \\| undefined`	Hayır	Oluşturulan PFX dosyasının çıkış yolu
`password`	`string \\| undefined`	Hayır	Oluşturulan PFX dosyasının parolası
`publisher`	`string \\| undefined`	Hayır	Oluşturulan sertifika için Yayıncı adı. Belirtilmezse manifestten anlaşılır.
`validDays`	`number \\| undefined`	Hayır	Sertifikanın geçerli olduğu gün sayısı