Mage.exe (Bildirim Üretme ve Düzenleme Aracı)
Bildirim Oluşturma ve Düzenleme Aracı (Mage.exe), uygulama ve dağıtım bildirimlerini oluşturmayı ve düzenlemeyi destekleyen bir komut satırı aracıdır. Komut satırı aracı olarak, Mage.exe hem toplu komut dosyalarından hem de ASP.NET uygulamaları da dahil olmak üzere diğer Windows tabanlı uygulamalardan çalıştırılabilir.
Mage.exe yerine grafik bir uygulama olan MageUI.exe de kullanabilirsiniz. Daha fazla bilgi için bkz. MageUI.exe (Bildirim Oluşturma ve Düzenleme Aracı, Grafik İstemci).
Bu araç, Visual Studio ile birlikte otomatik olarak yüklenir. Aracı çalıştırmak için Visual Studio Geliştirici Komut İstemi'ni veya Visual Studio Geliştirici PowerShell'i kullanın.
Visual Studio'ya iki Mage.exe ve MageUI.exe sürümü dahildir. Sürüm bilgilerini görmek için MageUI.exe çalıştırın, Yardım'ı seçin ve Hakkında'yı seçin. Bu belgede Mage.exe ve MageUI.exe 4.0.x.x sürümü açıklanmaktadır.
Sözdizimi
Mage [commands] [commandOptions]
Parametreler
Aşağıdaki tabloda, Mage.exe tarafından desteklenen komutlar gösterilmektedir. Bu komutlar tarafından desteklenen seçenekler hakkında daha fazla bilgi için bkz . Yeni ve Güncelleştirme komut seçenekleri ve İmza komutu seçenekleri.
| Komut | Açıklama |
|---|---|
| -cc, ClearApplicationCache | Tüm yalnızca çevrimiçi uygulamalar için indirilen uygulama önbelleğini temizler. |
| -n, -New fileType [newOptions] | Belirtilen türde yeni bir dosya oluşturur. Geçerli türler: - Deployment: Yeni bir dağıtım bildirimi oluşturur.- Application: Yeni bir uygulama bildirimi oluşturur.Eğer bu komutla birlikte hiçbir ek parametre belirtmezseniz, uygun türde ve uygun varsayılan etiketlere ve öznitelik değerlerine sahip bir dosya oluşturur. Yeni dosyanın dosya adını ve yolunu belirtmek için -ToFile seçeneğini kullanın (aşağıdaki tabloda bakın). Bildirimin bağımlılık> bölümüne eklenen <bir uygulamanın tüm derlemeleriyle bir uygulama bildirimi oluşturmak için -FromDirectory seçeneğini kullanın (aşağıdaki tabloda bakın). |
| -u, -Update [filePath] [updateOptions] | Bir bildirim dosyasına bir veya daha fazla değişiklik yapar. Düzenlediğiniz dosya türünü belirtmeniz gerekli değildir. Mage.exe, bir buluşsal yöntem kümesi kullanarak dosyayı inceler ve bir dağıtım bildirimi ya da uygulama bildirimi olup olmadığını belirler. Bir dosyayı zaten bir sertifikayla imzaladıysanız, -Update anahtar imza bloğunu kaldırır. Bunun nedeni, anahtar imzasının dosyasının bir karmasını içermesi ve dosyayı değiştirmenin karmayı geçersiz kılmasıdır. Varolan dosyanın üzerine yazmak yerine yeni bir dosya adı ve yol belirtmek için -ToFile seçeneğini kullanın (aşağıdaki tabloda bakın). |
-s, -Sign [signOptions] |
Bir dosyayı imzalamak için bir anahtar çifti veya X509 sertifikası kullanır. İmzalar, dosyaların içine XML öğeleri olarak eklenir. -TimestampUri değerini belirten bir bildirim imzalarken İnternet'e bağlı olmanız gerekir. |
| -ver, -Verify [manifest-filename] | Bildirimin doğru imzalandığını doğrular. Diğer komutlarla birleştirilemez. .NET Framework 4.7 ve sonraki sürümlerde kullanılabilir. |
| -h, -?, -Help [ayrıntılı] | Tüm kullanılabilir komutları ve seçeneklerini açıklar. Ayrıntılı yardım almak için belirtin verbose . |
Yeni ve Güncelleştir komut seçenekleri
Aşağıdaki tabloda ve -Update komutları tarafından -New desteklenen seçenekler gösterilmektedir:
| Seçenekler | Varsayılan Değer | Uygulandığı Öğe | Açıklama |
|---|---|---|---|
| -a, -Algoritma | sha1RSA | Uygulama bildirimleri. Dağıtım bildirimleri. |
Bağımlılık özetlerinin oluşturması için kullanılan algoritmayı belirtir. Değer "sha256RSA" veya "sha1RSA" olmalıdır. "-Update" seçeneğiyle kullanın. Bu seçenek "-Sign" seçeneğini kullanırken yok sayılır. |
-appc, -AppCodeBase manifestReference |
Dağıtım bildirimleri. | Uygulama bildirim dosyasına bir URL veya dosya yolu başvurusu ekler. Bu değer, uygulama bildiriminin tam yolu olmalıdır. | |
-appm, -AppManifest manifestPath |
Dağıtım bildirimleri. | Bir dağıtım bildirimine, dağıtımın uygulama bildirimindeki bir başvuruyu ekler. tarafından manifestPath belirtilen dosyanın mevcut olması gerekir, aksi takdirde Mage.exe bir hata döndürür. tarafından manifestPath başvuruda bulunılan dosya bir uygulama bildirimi değilse, Mage.exe bir hata döndürür. |
|
-cf, -CertFile filePath |
Tüm dosya türleri. | Bildirim veya lisans dosyasını imzalamak için X509 dijital sertifikasının konumunu belirtir. Sertifika Kişisel Bilgi Değişimi (PFX) dosyaları için parola gerektiriyorsa, bu seçenek -Password seçeneğiyle birlikte kullanılabilir. .NET Framework 4.7'den başlayarak, dosya özel anahtar içermiyorsa - CryptoProvider ve -KeyContainer seçeneklerinin bir bileşimi gerekir. .NET Framework 4.6.2'den başlayarak Mage.exe bildirimleri CNG ve CAPI sertifikaları ile imzalar. |
|
-ch, -CertHash hashSignature |
Tüm dosya türleri. | İstemci bilgisayarın kişisel sertifika deposunda tutulan bir dijital sertifikanın karması. Bu, Windows Sertifikaları Konsolu içinde görüntülenen bir dijital sertifikanın Parmak İzi dizesine karşılık gelir.hashSignature büyük veya küçük harf olabilir ve tek bir dize olarak veya Parmak İzi'nin her sekizlisi boşluklarla ve Parmak İzinin tamamı tırnak içine alınmış olarak sağlanabilir. |
|
-csp, -CryptoProvider provider-name |
Tüm dosya türleri. | Özel anahtar kapsayıcısını içeren bir şifreleme hizmeti sağlayıcısının (CSP) adını belirtir. Bu seçenek için -KeyContainer seçeneği gerekir. Bu seçenek .NET Framework 4.7'den itibaren kullanılabilir. |
|
-fd, -FromDirectory directoryPath |
Uygulama bildirimleri. | Uygulama bildirimini, dağıtmak istediğiniz uygulamayı içeren dizin olan directoryPath tüm alt dizinler de dahil olmak üzere içinde bulunan directoryPathtüm derlemelerin ve dosyaların açıklamalarıyla doldurur. Dizindeki her dosya için Mage.exe dosyanın bir derleme mi yoksa statik bir dosya mı olduğuna karar verir. Bir derlemeyse, derlemenin adı, kod tabanı ve installFrom sürümüyle uygulamaya bir <dependency> etiket ve öznitelik ekler. Statik bir dosyaysa bir <file> etiket ekler. Mage.exe ayrıca uygulamanın ana yürütülebilir dosyasını algılamak için basit bir buluşsal yöntemler kümesi kullanır ve bunu bildirimde ClickOnce uygulamasının giriş noktası olarak işaretler.Mage.exe hiçbir zaman bir dosyayı otomatik olarak "veri" dosyası olarak işaretlemez. Bunu elle yapmanız gerekir. Daha fazla bilgi için bkz . Nasıl yapılır: ClickOnce Uygulamasına Veri Dosyası Ekleme. Mage.exe ayrıca her dosya için boyutuna göre bir karma oluşturur. ClickOnce bu karmaları kullanarak, bildirim oluşturulduktan sonra dağıtımın dosyaları üzerinde kimsenin değişiklik yapmadığından emin olur. Dağıtımınızdaki dosyalardan herhangi biri değişirse, -Update komutu ve -FromDirectory seçeneğiyle Mage.exe çalıştırabilirsiniz; bu seçenek başvuruda bulunılan tüm dosyaların karmalarını ve derleme sürümlerini güncelleştirir. -FromDirectory içinde bulunan directoryPathtüm alt dizinlerdeki tüm dosyaları içerir.-Update komutuyla -FromDirectory kullanırsanız, Mage.exe artık dizinde bulunmayan uygulama bildirimindeki tüm dosyaları kaldırır. |
|
-if, -IconFile filePath |
Uygulama bildirimleri. | Bir .ICO simge dosyasının tam yolunu belirtir. Bu simge başlat menüsünde uygulamanızın adının yanında ve Program Ekle/Kaldır girdisinde görünür. Eğer simge sağlanmazsa, varsayılan bir simge kullanılır. | |
-ip, -IncludeProviderURL url |
true | Dağıtım bildirimleri. | Dağıtım bildiriminin -ProviderURL tarafından ayarlanan güncelleştirme konumu değerini içerip içermediğini gösterir. |
-i, -Install willInstall |
true | Dağıtım bildirimleri. | ClickOnce uygulamasının yerel bilgisayara yüklenip yüklenmeyeceğini veya Web'den çalışıp çalışmayacağını belirtir. Bir uygulamayı yüklemek, bu uygulamaya Windows Başlat menüsünde bir iletişim durumu sağlar. Geçerli değerler "true" veya "t" ve "false" veya "f" değerleridir. -MinVersion seçeneğini belirtirseniz ve bir kullanıcının -MinVersion'dan küçük bir sürümü yüklüyse, -Install'a geçirdiğiniz değerden bağımsız olarak uygulamayı yüklemeye zorlar. Bu seçenek -BrowserHosted seçeneğiyle kullanılamaz. Aynı bildirimde ikisini de belirtmeyi denemek hata oluşturur. |
-kc, -KeyContainer name |
Tüm dosya türleri. | Özel anahtarın adını içeren anahtar kapsayıcısını belirtir. Bu seçenek CryptoProvider seçeneğini gerektirir. Bu seçenek .NET Framework 4.7'den itibaren kullanılabilir. |
|
-mv, -MinVersion [version] |
-Version bayrağı tarafından belirtilen ClickOnce dağıtım bildiriminde listelenen sürüm . | Dağıtım bildirimleri. | Bir kullanıcının çalıştırabileceği bu uygulamanın en düşük sürümü. Bu bayrak uygulamanızın adlandırılmış sürümünü gereken bir güncelleştirme yapar. Eğer ürününüzün bir sürümünü bozucu bir değişiklik veya kritik bir güvenlik açığı için güncelleştirirseniz, bu bayrağı kullanarak bu güncelleştirmenin yüklenmesi gerektiğini ve kullanıcının önceki sürümleri kullanamayacağını belirtebilirsiniz.version, -Version bayrağının bağımsız değişkeniyle aynı semantiğine sahiptir. |
-n, -Name nameString |
Dağıtma | Tüm dosya türleri. | Uygulamayı tanımlamak için kullanılan ad. ClickOnce, Başlat menüsünde (uygulama kendisini yükleyecek şekilde yapılandırılmışsa) ve İzin Yükseltme iletişim kutularında uygulamayı tanımlamak için bu adı kullanır. Not: Mevcut bir bildirimi güncelleştiriyorsanız ve bu seçenekle bir yayımcı adı belirtmezseniz, Mage.exe bildirimi bilgisayarda tanımlanan kuruluş adıyla güncelleştirir. Farklı bir ad kullanmak için, bu seçeneği kullanmayı ve istediğiniz yayımcı adını belirtmeyi unutmayın. |
-pwd, -Password passwd |
Tüm dosya türleri. | Bir bildirimi dijital sertifika ile imzalamak için kullanılan şifre. -CertFile seçeneğiyle birlikte kullanılmalıdır. | |
-p, İşlemci processorValue |
Msil | Uygulama bildirimleri. Dağıtım bildirimleri. |
Bu dağıtımın çalışabileceği mikro işlemci mimarisi. Eğer derlemeleri belirli bir mikro işlemci için önceden derlenmiş olan bir veya daha fazla yükleme için hazırlanıyorsanız bu değer gereklidir. Geçerli değerler , , x86ia64ve amd64değerlerini içerirmsil. msil Microsoft ara dilidir; diğer bir deyişle tüm derlemeleriniz platformdan bağımsızdır ve uygulamanız ilk kez çalıştırıldığında ortak dil çalışma zamanı (CLR) bunları tam zamanında derler. |
-pu, -ProviderURL url |
Dağıtım bildirimleri. | ClickOnce'ın uygulama güncelleştirmeleri için inceleyeceği URL'yi belirtir. | |
-pub, -Publisher publisherName |
Uygulama bildirimleri. Dağıtım bildirimleri. |
Dağıtım veya uygulama bildiriminin açıklama öğesine yayımcı adını ekler. Bir uygulama bildiriminde kullanıldığında - UseManifestForTrust da "true" veya "t" değeriyle belirtilmelidir; aksi takdirde, bu parametre bir hata oluşturur. | |
-s, -SupportURL url |
Uygulama bildirimleri. Dağıtım bildirimleri. |
ClickOnce uygulaması için Program Ekle veya Kaldır'da görünen bağlantıyı belirtir. | |
-ti, -TimestampUri uri |
Uygulama bildirimleri. Dağıtım bildirimleri. |
Bir dijital zaman damgası hizmetinin URL'si. Bildirimlere zaman damgası koymak, uygulamanızın sonraki sürümünü dağıtmadan önce dijital sertifikanızın süresi dolarsa bildirimleri yeniden imzalamanıza gerek kalmamasını sağlar. Daha fazla bilgi için bkz . Windows kök sertifika programı üyeleri. | |
-t, -ToFile filePath |
-Yeni: - Dağıtım: deploy.application - Uygulama: application.exe.manifest -Güncelleştirmek: - Giriş dosyası. |
Tüm dosya türleri. | Oluşturulan veya değiştirilen dosyanın çıkış yolunu belirtir. -New kullandığınızda -ToFile sağlanmazsa, çıkış geçerli çalışma dizinine yazılır. -Update kullanırken -ToFile sağlanmazsa, Mage.exe dosyayı giriş dosyasına geri yazar. |
-tr, -TrustLevel level |
Uygulama URL'sinin bulunduğu bölgeyi temel alır. | Uygulama bildirimleri. | İstemci bilgisayarlarda uygulamaya sağlanacak güven düzeyi. Değerler "Internet", "Intranet" ve "FullTrust" değerlerini içerir. |
-um, -UseManifestForTrust willUseForTrust |
False | Uygulama bildirimleri. | Uygulama bildiriminin dijital imzasının, uygulama istemcide çalışırken güven kararları için kullanılıp kullanılmayacağını belirtir. "true" veya "t" belirtmek uygulama bildiriminin güven kararları için kullanılacağını belirtir. "false" veya "f" belirtmek dağıtım bildiriminin imzasının kullanılacağını belirtir. |
-v, -Version versionNumber |
Kategori 1.0.0.0 | Uygulama bildirimleri. Dağıtım bildirimleri. |
Dağıtımın sürümü. Bağımsız değişken, "N.N.N.N" biçiminde geçerli bir sürüm dizesi olmalıdır; burada "N" işaretsiz bir 32 bit tamsayıdır. |
-wpf, -WPFBrowserApp isWPFApp |
yanlış | Uygulama bildirimleri. Dağıtım bildirimleri. |
Bu bayrağı yalnızca uygulama bir tarayıcı içinde barındırılacak bir Windows Presentation Foundation (WPF) uygulamasıysa ve tek başına yürütülebilir dosya değilse kullanın. Geçerli değerler "true" veya "t" ve "false" veya "f" değerleridir. Uygulama bildirimleri için, özniteliğini hostInBrowser uygulama bildirimi öğesinin entryPoint altına ekler.Dağıtım bildirimleri için öğesindeki install deployment özniteliği false olarak ayarlar ve dağıtım bildirimini bir .xbap uzantısıyla kaydeder. Bu bağımsız değişkenin -Install bağımsız değişkeniyle birlikte belirtilmesi, tarayıcı tarafından barındırılan bir uygulama yüklü, çevrimdışı bir uygulama olamayacağından bir hataya neden olur. |
İmzala komut seçenekleri
Aşağıdaki tabloda, komut tarafından -Sign desteklenen ve tüm dosya türleri için geçerli olan seçenekler gösterilmektedir.
| Seçenekler | Açıklama |
|---|---|
-cf, -CertFile filePath |
Bildirim imzalamak için bir dijital sertifikanın konumunu belirtir. Sertifika Kişisel Bilgi Değişimi (PFX) dosyaları için parola gerektiriyorsa, bu seçenek -Password seçeneğiyle birlikte kullanılabilir. .NET Framework 4.7'den başlayarak, dosya özel anahtar içermiyorsa - CryptoProvider ve -KeyContainer seçeneklerinin bir bileşimi gerekir. .NET Framework 4.6.2'den başlayarak Mage.exe bildirimleri CNG ve CAPI sertifikaları ile imzalar. |
-ch, -CertHash hashSignature |
İstemci bilgisayarın kişisel sertifika deposunda tutulan bir dijital sertifikanın karması. Bu, Windows Sertifikaları Konsolu içinde görüntülenen bir dijital sertifikanın Parmak İzi özelliğine karşılık gelir.hashSignature büyük veya küçük harf olabilir ve tek bir dize olarak veya Parmak İzi'nin her sekizlisi boşluklarla ve Parmak İzinin tamamı tırnak içine alınmış olarak sağlanabilir. |
-csp, -CryptoProvider provider-name |
Özel anahtar kapsayıcısını içeren bir şifreleme hizmeti sağlayıcısının (CSP) adını belirtir. Bu seçenek için -KeyContainer seçeneği gerekir. Bu seçenek .NET Framework 4.7'den itibaren kullanılabilir. |
-kc, -KeyContainer name |
Özel anahtarın adını içeren anahtar kapsayıcısını belirtir. Bu seçenek CryptoProvider seçeneğini gerektirir. Bu seçenek .NET Framework 4.7'den itibaren kullanılabilir. |
-pwd, -Password passwd |
Bir bildirimi dijital sertifika ile imzalamak için kullanılan şifre. -CertFile seçeneğiyle birlikte kullanılmalıdır. |
-t, -ToFile filePath |
Oluşturulan veya değiştirilen dosyanın çıkış yolunu belirtir. |
Açıklamalar
Mage.exe için tüm bağımsız değişkenler büyük/küçük harfe duyarlı değildir. Komutlar ve seçenekler bir tire (-) veya eğik çizgi (/) ile belirtilebilir.
-Sign komutuyla kullanılan tüm bağımsız değişkenler, -New veya -Update komutları ile de istediğiniz zaman kullanılabilir. Aşağıdaki komutlar eşdeğerdir.
mage -Sign c:\HelloWorldDeployment\HelloWorld.deploy -CertFile cert.pfx
mage -Update c:\HelloWorldDeployment\HelloWorld.deploy -CertFile cert.pfx
Not
.NET Framework 4.6.2 sürümünden itibaren CNG sertifikaları da desteklenir.
İmzalama gerçekleştireceğiniz son görevdir; çünkü imzalanmış bir belge, imzanın belge için geçerli olup olmadığını doğrulamak için dosyanın bir karmasını kullanır. Eğer imzalanan dosyada bir değişiklik yaparsanız, yeniden imzalamanız gerekir. Daha önce imzalanan bir belgeyi imzalarsanız, Mage.exe eski imzayı yenisiyle değiştirir.
Dağıtım bildirimini doldurmak için -AppManifest seçeneğini kullandığınızda, Mage.exe uygulama bildiriminizin geçerli dağıtım sürümünden sonra adlı bir alt dizindeki dağıtım bildirimiyle aynı dizinde yer alacağını ve dağıtım bildiriminizi uygun şekilde yapılandıracağını varsayar. Uygulama bildiriminiz başka bir yerde yer alacaksa alternatif konumu ayarlamak için -AppCodeBase seçeneğini kullanın.
Uygulamanızı dağıtmadan önce dağıtım ve uygulama belgeleriniz imzalanmalıdır. bildirimleri imzalama hakkında yönergeler için bkz . Güvenilen Uygulama Dağıtımına Genel Bakış.
Uygulama bildirimleri için -TrustLevel seçeneği, bir uygulamanın istemci bilgisayarda çalışması için gereken izin kümesini açıklar. Varsayılan olarak, uygulamalara URL'lerinin bulunduğu bölgeye göre bir güven düzeyi atanır. Bir şirket ağında dağıtılan uygulamalar genellikle Intranet bölgesine yerleştirilirken, Internet üzerinden dağıtılan uygulamalar Internet bölgesine yerleştirilir. İki güvenlik bölgesi de uygulamanın yerel kaynaklara erişimine kısıtlamalar koyar, ancak Intranet bölgesi Internet bölgesine göre biraz daha az sınırlayıcıdır. FullTrust bölgesi uygulamalara, bir bilgisayarın yerel kaynakları için tam erişim sağlar. Bir uygulamayı bu bölgeye yerleştirmek için -TrustLevel seçeneğini kullanırsanız, CLR'nin Trust Manager bileşeni kullanıcıdan bu daha yüksek düzeyde güven vermek isteyip istemediğine karar vermesini ister. Eğer uygulamanızı bir şirket ağı üzerinden dağıtıyorsanız, kullanıcıya sormadan uygulamanın güven düzeyini yükseltmek için Güvenilen Uygulama Dağıtımı'nı kullanabilirsiniz.
Uygulama bildirimleri de özel güven bölümlerini destekler. Bu, uygulamanızın en az izni isteme güvenlik ilkesine uymasına yardımcı olur; çünkü bildirimi, uygulamanın yürütülebilmesi için gereken belirli izinleri isteyecek şekilde yapılandırabilirsiniz. Mage.exe özel güven bölümü eklemeyi doğrudan desteklemez. Metin düzenleyicisi, XML ayrıştırıcısı veya grafik araç MageUI.exe kullanarak ekleyebilirsiniz. Özel güven bölümleri eklemek için MageUI.exe kullanma hakkında daha fazla bilgi için bkz. MageUI.exe (Bildirim Oluşturma ve Düzenleme Aracı, Grafik İstemci).
Visual Studio 2017, Mage.exe 4.6.1 sürümünü içerir. Mage.exe hedef .NET Framework 4'ün bu sürümüyle oluşturulan bildirimler. .NET Framework'ün eski sürümlerini hedeflemek için Mage.exe'nin önceki bir sürümünü kullanın.
Derlemeleri varolan bir bildirime eklediğinizde veya kaldırdığınızda ya da var olan bir bildirimi yeniden imzaladığınızda, Mage.exe bildirimi hedef .NET Framework 4'e güncelleştirmez.
Aşağıdaki tablolarda bu özellikler ve kısıtlamalar gösterilmektedir:
| Bildirim sürümü | İşlem | Mage v2.0 | Mage v4.0 |
|---|---|---|---|
| .NET Framework'ün 2.0 veya 3.x sürümünü hedefleyen uygulamalar için bildirim | Açılış | Tamam | Tamam |
| Kapat | Tamam | Tamam | |
| Kaydet | Tamam | Tamam | |
| Yeniden İmzala | Tamam | Tamam | |
| Yeni | Tamam | Desteklenmez | |
| Update (aşağıya bakın) | Tamam | Tamam | |
| .NET Framework'ün 4 sürümünü hedefleyen uygulamalar için bildirim | Açılış | Tamam | Tamam |
| Kapat | Tamam | Tamam | |
| Kaydet | Tamam | Tamam | |
| Yeniden İmzala | Tamam | Tamam | |
| Yeni | Desteklenmez | Tamam | |
| Update (aşağıya bakın) | Desteklenmez | Tamam |
| Bildirim sürümü | Update İşlemi Ayrıntıları | Mage v2.0 | Mage v4.0 |
|---|---|---|---|
| .NET Framework'ün 2.0 veya 3.x sürümünü hedefleyen uygulamalar için bildirim | Bir derlemeyi değiştir | Tamam | Tamam |
| Bir derleme ekle | Tamam | Tamam | |
| Bir derlemeyi kaldır | Tamam | Tamam | |
| .NET Framework'ün 4 sürümünü hedefleyen uygulamalar için bildirim | Bir derlemeyi değiştir | Desteklenmez | Tamam |
| Bir derleme ekle | Desteklenmez | Tamam | |
| Bir derlemeyi kaldır | Desteklenmez | Tamam |
Mage.exe. .NET Framework 4 İstemci Profilini hedefleyen yeni bildirimler oluşturur. .NET Framework 4 İstemci Profilini hedefleyen ClickOnce uygulamaları hem .NET Framework 4 İstemci Profilinde hem de .NET Framework 4'ün tam sürümünde çalıştırılabilir. Uygulamanız .NET Framework 4'ün tam sürümünü hedef alıyorsa ve .NET Framework 4 İstemci Profilinde çalıştırılamıyorsa, bir metin düzenleyicisi kullanarak istemci <framework> öğesini kaldırın ve bildirimi yeniden imzalayın.
Aşağıda .NET Framework 4 İstemci Profilini hedefleyen bir örnek <framework> öğe verilmiştir:
<framework targetVersion="4.0" profile="client" supportedRuntime="4.0.20506" />
Örnekler
Aşağıdaki örnek, Mage (MageUI.exe) için kullanıcı arabirimini açar.
mage
Aşağıdaki örnekler varsayılan bir dağıtım bildirimi ve uygulama bildirimi oluşturur. Bu dosyaların hepsi geçerli çalışma dizininde oluşturulur ve sırasıyla deploy.application ve application.exe.manifest olarak adlandırılır.
mage -New Deployment
mage -New Application
Aşağıdaki örnek, geçerli dizindeki tüm derlemeler ve kaynak dosyalarıyla doldurulmuş bir uygulama bildirimi oluşturur.
mage -New Application -FromDirectory . -Version 1.0.0.0
Aşağıdaki örnek önceki örneği devam ettirerek dağıtım adımı ve hedef mikro işlemciyi belirtir. Ayrıca ClickOnce'ın güncelleştirmeler için denetleyeceği bir URL belirtir.
mage -New Application -FromDirectory . -Name "Hello, World! Application" -Version 1.0.0.0 -Processor "x86" -ProviderUrl http://internalserver/HelloWorld/
Aşağıdaki örnekte, tarayıcıda barındırılacak WPF uygulamasını dağıtmak için bir bildirim çiftinin nasıl oluşturulacağı gösterilmektedir.
mage -New Application -FromDirectory . -Version 1.0.0.0 -WPFBrowserApp true
mage -New Deployment -AppManifest 1.0.0.0\application.manifest -WPFBrowserApp true
Aşağıdaki örnek, geçerli dizinden ve imzalardan tüm derlemeler ve kaynak dosyalarıyla doldurulmuş bir uygulama bildirimi oluşturur.
mage -New Application -FromDirectory . -Version 1.0.0.0 -KeyContainer keypair.snk -CryptoProvider "Microsoft Enhanced Cryptographic Provider v1.0"
Aşağıdaki örnek dağıtım bildirimini bir uygulama bildirimindeki bilgiyle güncelleştirir, ve uygulama bildiriminin konumu için kod temelini ayarlar.
mage -Update HelloWorld.deploy -AppManifest 1.0.0.0\application.manifest -AppCodeBase http://internalserver/HelloWorld.deploy
Aşağıdaki örnek dağıtım bildirimini düzenleyerek kullanıcının yüklü sürümünün zorla güncelleştirilmesini sağlar.
mage -Update c:\HelloWorldDeployment\HelloWorld.deploy -MinVersion 1.1.0.0
Aşağıdaki örnek dağıtım bildiriminin uygulama bildirimini ayrı bir dizinden almasını sağlar.
mage -Update HelloWorld.deploy -AppCodeBase http://anotherserver/HelloWorld/1.1.0.0/
Aşağıdaki örnek geçerli çalışma dizinindeki bir dijital sertifikayı kullanarak varolan bir dağıtım bildirimini imzalar.
mage -Sign deploy.application -CertFile cert.pfx -Password <passwd>
Aşağıdaki örnek, geçerli çalışma dizininde bir dijital sertifika ve özel anahtar kullanarak var olan bir dağıtım bildirimini imzalar.
mage -Sign deploy.application -CertFile cert.pfx -KeyContainer keyfile.snk -CryptoProvider "Microsoft Enhanced Cryptographic Provider v1.0"
