MageUI.exe (Bildirim Üretme ve Düzenleme Aracı, Grafik İstemci)
MageUI.exe, komut satırı aracı Mage.exe ile aynı işlevselliği, ancak Windows tabanlı kullanıcı arabirimi (UI) ile destekler. Bu araçla, dağıtım ve uygulama bildirimleri oluşturabilir, düzenleyebilir ve imzalayabilirsiniz. MageUI.exe ile oluşturulan yeni bildirimler .NET Framework 4 İstemci Profilini hedefler. Önceki .NET Framework sürümlerini hedeflemek için MageUI.exe'nin önceki sürümleri kullanılmalıdır. Bir bildirimdeki derlemeleri eklerken veya kaldırırken ya da mevcut bildirimleri yeniden imzalarken MageUI.exe bildirimi .NET Framework 4 İstemci Profili'ni hedeflemeyecek şekilde güncelleştirmez. Daha fazla bilgi için bkz. Mage.exe (Bildirim Oluşturma ve Düzenleme Aracı).
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 Developer PowerShell'i kullanın.
Visual Studio'nun bir bileşeni olarak iki Mage.exe ve MageUI.exe sürümü eklenmiştir. Sürüm bilgilerini görmek için MageUI.exe çalıştırın, Yardım'ı ve Hakkında'yı seçin. Bu belge Mage.exe ve MageUI.exe'nin 4.0.x.x sürümünü açıklar.
Not
MageUI.exe, MageUI.exe kullanılarak sertifikayla önceden imzalanmış bir uygulama bildirimi kaydedilirken compatibleFrameworks öğesini desteklemez. Bunun yerine ,Mage.exekullanmanız gerekir.
UIElement Listesi
Aşağıdaki tablo, kullanılabilen menü ve araç çubuğu öğelerini listeler.
| Komut | Menü | Kısayol | Description |
|---|---|---|---|
| Uygulama Bildirimi | Dosya, Yeni | Yeni bir uygulama bildirimi oluşturur. | |
| Dağıtım Bildirimi | Dosya, Yeni | Yeni bir dağıtım bildirimi oluşturur. | |
| Aç | Dosya | CTRL+O | Varolan bir dağıtım bildirimini, uygulama bildirimini ya da düzenlemek için güven lisansını açar. |
| Kapat | Dosya | CTRL+F4 | Açık bir dosyayı kapatır. Bir dosyayı kapatmadan önce değiştirirseniz, MageUI.exe dosyayı bir ortak anahtarla, anahtar çiftiyle veya depolanmış bir sertifikayla yeniden imzalamanızı ister. |
| Kaydet | Dosya | CTRL+S | Şu anda kullanıcı giriş odağı olan belgeyi diske kaydeder. |
| Farklı Kaydet | Dosya | Yeni bir dosya adı ve/veya konum girmenizi sağlayarak bir dosyayı diske kaydeder. | |
| Tümünü Kaydet | Dosya | MageUI.exe içinde açık durumdaki tüm dosyalarda yapılan değişiklikleri kaydeder. | |
| Tercihler | Dosya | Tercihler iletişim kutusunu açar. Daha fazla bilgi için aşağıdaki bölüme bakın. | |
| Çıkış | Dosya | ALT+F4 | MageUI.exe'den çıkılır. |
| Kes | Düzenle | CTRL+X | Seçili durumdaki metni uygulamadan kaldırır ve sistem Pano'suna taşır. |
| Kopyala | Düzenle | CTRL+C | Seçili durumdaki metni sistem Pano'suna kopyalar. |
| Yapıştır | Düzenle | CTRL+V | Sistem Pano'sundaki metni etkin durumdaki metin öğesinin içine yapıştırır. |
| Silme | Düzenle | Dağıtım Bildirimi sekmesindeki güven lisansı gibi listede seçili olan bir öğeyi siler. | |
| Tümünü Kapat | Pencere | MageUI.exe'de açık durumdaki tüm dosyaları kapatır. Bir veya daha fazla dosyanın kaydedilmesi gerekiyorsa, gereksinimi MageUI.exe sizden onları kaydetmenizi ister. MageUI.exe ayrıca imzalanmamış veya değiştirilmiş her dosya için bir imzalama anahtarı seçmenizi de ister. | |
| Hakkında | Yardım | MageUI.exe'nin sürüm ve telif hakkı bilgilerini görüntüler. |
Tercihler İletişim Kutusu
Tercihler iletişim kutusu aşağıdaki öğeleri içerir.
| Arabirim Öğesi | Description |
|---|---|
| Oturum açma kaydetme | Bir dosyadaki değişikliklerinizi kaydedeceğiniz her zaman dosyayı imzalamanızı ister. |
| Varsayılan imzalama sertifikasını kullan | Tüm dosyaları imzalamak için Sertifika dosyası metin kutusuna girilen anahtarı kullanır. Bu, normalde bir dosyayı kaydettiğinizde görüntülenen imzalama istemini ortadan kaldırır ve Kaydetmede Oturum Aç seçilidir. Anahtar dosyayı seçmek için Sertifika dosyası metin kutusunun yanındaki üç nokta (...) düğmesini kullanın. |
| Özet algoritması | Bağımlılık özetlerinin oluşturması için kullanılan algoritmayı belirtir. Değer "sha256RSA" veya "sha1RSA" olmalıdır. Varsayılan olarak SHA1 kullanılır. Hem uygulama hem de dağıtım bildirimlerinde kullanılır. Kullanıcı bildirimi kaydederken bir sertifika sunarsa, bağımlılık özetleri oluşturmak için sertifikadaki algoritmaları kullanır. |
İmzalama Seçenekleri İletişim Kutusu
bir bildirim veya güven lisansını ilk kez kaydettiğinizde ya da bildirim veya güven lisansını değiştirdiğinizde İmzalama Seçenekleri iletişim kutusu görüntülenir. Yalnızca Tercihler iletişim kutusundaki Kaydet'te Oturum Aç seçeneği seçiliyse görünür. TimeStamping URI metin kutusunda bir değer belirten bir bildirim imzalarken İnternet'e bağlı olmanız gerekir.
Bu iletişim kutusu aşağıdaki öğeleri içerir.
| Arabirim Öğesi | Description |
|---|---|
| Sertifika dosyasıyla oturum açma | Bildirimi, dosya sisteminde depolanmış bir dijital sertifika ile imzalar. |
| Dosya | Sertifikayı temsil eden .pfx dosyasının yolunu yazmanız için bir alan sağlar. |
| ... | Var olan bir .pfx dosyasını seçmek için Dosya Seç iletişim kutusunu açar. |
| Yeni | Bir Sertifika Yetkilisi (CA) aracılığıyla doğrulanamayan yeni bir .pfx oluşturur. ClickOnce dağıtımlarını imzalamak için kullanılan sertifika türleri hakkında daha fazla bilgi için bkz . Güvenilen Uygulama Dağıtımına Genel Bakış. |
| Parola | Bu sertifikayla imzalamak için kullanılan parolayı yazmanız için bir alan sağlar. Parola yoksa boş bırakılabilir. |
| Depolanan sertifikayla imzalama | Bilgisayarınızın sertifika deposunda depolanmış dijital sertifikaların seçilebilir bir listesini görüntüler. |
| TimeStamping URI'si | Dijital zaman damgası hizmeti Tekdüzen Kaynak Konumlandırıcı'yı (URI) görüntüler. 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 ve ClickOnce ve Authenticode. |
| İmzalamayın | Dijital bir sertifikanın imza eklemeden bildirim kaydetmenize izin verir. |
Sekme ve Panel Açıklamaları
MageUI.exe ile bir belge açtığınızda, kendi sekme sayfasında görünür. Her sekme bir özellik paneli kümesi içerir. Paneller belgenin verilerinin gruplandırılmış alt kümelerini içerir.
Uygulama Bildirimi Sekmesi
Uygulama Bildirimi sekmesi, bir uygulama bildiriminin içeriğini görüntüler. Uygulama bildirimi, dağıtıma dahil olan tüm dosyaları ve uygulamanın istemcide çalışması için gereken izinleri açıklar.
Uygulama Bildirimi sekmesi aşağıdaki sekmeleri içerir.
| Arabirim Öğesi | Açıklama |
|---|---|
| Ad | Bu dağıtımla ilgili tanımlayıcı bilgileri belirtir. |
| Açıklama | Yayımcı, ürün ve destek bilgilerini belirtir. |
| Uygulama Seçenekleri | Bunun bir tarayıcı uygulaması olup olmadığını ve bu bildirimin güven bilgilerinin kaynağı olup olmadığını belirtir. |
| Dosyalar | Bu dağıtımı oluşturan tüm dosyaları belirtir. |
| Gerekli İzinler | Uygulamanın bir istemcide çalışması için gereken en düşük izin kümesini belirtir. |
Ad Sekmesi
Ad sekmesi, bir uygulama bildirimini ilk oluşturduğunuzda veya açtığınızda görüntülenir. Dağıtımı benzersiz olarak tanımlar ve isteğe bağlı olarak geçerli bir hedef platform belirtir.
| Arabirim Öğesi | Açıklama |
|---|---|
| Ad | Gereklidir. Uygulama bildiriminin adı. Genellikle dosya adıyla aynıdır. |
| Sürüm | Gereklidir. Dağıtımın N.N.N.N biçimindeki sürüm numarası. Yalnızca ilk ana derleme numarası gereklidir. Örneğin, bir uygulamanın 1.0 sürümü için geçerli değerler , 1.0, 1.0.0ve 1.0.0.0değerlerini içerir1. |
| İşlemci | İsteğe bağlı. Bu dağıtımın üzerinde çalışabileceği makine mimarisi. Varsayılan, msiltüm yönetilen derlemelerin varsayılan biçimi olan veya Microsoft Ara Dili'dir. Uygulamanızdaki derlemeleri belirli bir mimari için önceden derlediyseniz bu alanı değiştirin. Derleme öncesi hakkında daha fazla bilgi için bkz. Ngen.exe (Yerel Görüntü Oluşturucu). |
| Kültür | İsteğe bağlı. Bu uygulamanın çalıştığı iki parçalı ISO ülke ve bölge kodu. Varsayılan değer: neutral. |
| Ortak anahtar belirteci | İsteğe bağlı. Bu uygulama bildiriminin imzalandığı ortak anahtar. Bu yeni veya imzasız bir bildirimse, bu alan olarak Unsignedgörünür. |
Açıklama Sekmesi
Bu bilgiler genellikle dağıtım bildiriminde sağlanır. Bu alanlar yalnızca Uygulama Seçenekleri sekmesinde Uygulama Bildirimi Güven Bilgilerini Kullan onay kutusu seçiliyse değiştirilebilir.
| Arabirim Öğesi | Description |
|---|---|
| Publisher | Uygulamadan sorumlu kişinin veya kuruluşun adı. Bu değer Başlat menüsü klasör adı olarak kullanılır. |
| Ürün | Tam ürün adı. Dağıtım bildiriminin Dağıtım Seçeneklerisekmesindeki Uygulama Türü öğesi için Yerel Olarak Yükle'yi seçtiyseniz, bu ad Başlat menüsü bağlantısında ve bu uygulama için Program Ekle veya Kaldır'da görünen addır. |
| Destek Konumu | Müşterilerin uygulama için yardım ve destek alabildiği URL. |
Uygulama Seçenekleri Sekmesi
| Arabirim Öğesi | Description |
|---|---|
| tarayıcı uygulamasını Windows Presentation Foundation | Bunun tarayıcıda XAML tarayıcı uygulaması (XBAP) olarak çalışan bir WPF uygulaması olup olmadığını belirtir. |
| Uygulama Bildirimi Güven Bilgilerini Kullanma | Bu bildirimin güven bilgileri içerip içermediğini belirtir. |
Dosyalar Sekmesi
| Arabirim Öğesi | Description |
|---|---|
| Uygulama dizini | Uygulamanın dosyalarının bulunduğu dizin. Dizini seçmek için üç nokta (...) düğmesini kullanın. |
| Doldurmak | Uygulama dizinindeki ve alt dizinlerdeki tüm dosyaları uygulama bildirimine ekler. MageUI.exe dizinde tek bir yürütülebilir dosya bulursa, bunu otomatik olarak Girdi Noktası olarak işaretler. Bu, istemcide ClickOnce uygulaması başlatıldığında ilk yürütülen dosyadır. |
| Uygulama Dosyaları | Uygulamadaki tüm dosyaları listeler. Her dosyanın, aşağıda açıklanan üç düzenlenebilir özniteliği vardır. |
| Dosya Türü | Dosya Türü dört değerden biri olabilir: -Hiçbiri. - Giriş Noktası. Uygulamanın birincil yürütülebilir dosyası. Yalnızca bir yürütülebilir dosya giriş noktası olarak işaretlenebilir. - Veri Dosyası. Xml dosyası gibi uygulamaya veri sağlayan bir dosya. - Simge Dosyası. Masaüstünde veya uygulama penceresinin köşesinde olduğu gibi bir uygulama simgesi görünür. |
| İsteğe bağlı | İsteğe bağlı olarak işaretlenen dosyalar ilk yükleme veya güncelleştirme sırasında indirılmaz, ancak çalışma zamanında System.Deployment İsteğe Bağlı API kullanılarak indirilebilir. Daha fazla bilgi için bkz. İzlenecek Yol: Tasarımcı Kullanarak ClickOnce Dağıtım API'si ile İsteğe Bağlı Derlemeleri İndirme. |
| Grup | İsteğe bağlı dosyalar kümesi için etiket. Bir dosya kümesine Grup etiketi uygulayabilir ve tek bir API çağrısıyla bir grup dosyayı indirmek için İsteğe Bağlı API'yi kullanabilirsiniz. |
Gerekli İzinler Sekmesi
Uygulamanıza varsayılan olarak verilenden daha fazla yerel bilgisayara erişim vermeniz gerekiyorsa Gerekli İzinler sekmesini kullanın. Daha fazla bilgi için bkz . ClickOnce Uygulamalarının Güvenliğini Sağlama.
| Arabirim Öğesi | Description |
|---|---|
| İzin kümesi türü | Bu uygulamanın istemcide çalışması için gereken en düşük izin kümesi. Bu izin kümelerinin açıklaması ve hangi izinleri istediklerini öğrenmek için bkz. Adlandırılmış İzin Kümeleri. |
| Ayrıntılar | İzin kümesini temsil etmek üzere uygulama bildirimi için oluşturulan XML. Uygulama bildirimi XML biçimini iyi anlamadığınız sürece, bu XML'yi el ile düzenlememelisiniz. Daha fazla bilgi için bkz. ClickOnce Uygulama Bildirimi. |
Dağıtım Bildirimi Sekmesi
Dağıtım Bildirimi sekmesi aşağıdaki sekmeleri içerir.
| Arabirim Öğesi | Açıklama |
|---|---|
| Ad | Bu dağıtımla ilgili tanımlayıcı bilgileri belirtir. |
| Açıklama | Yayımcı, ürün ve destek bilgilerini belirtir. |
| Dağıtım Seçenekleri | Uygulama türü ve başlangıç konumu gibi dağıtım hakkında ek bilgileri belirtir. |
| Güncelleştirme Seçenekleri | ClickOnce'un uygulama güncelleştirmelerini ne sıklıkta denetlemesi gerektiğini belirtir. |
| Uygulama Başvurusu | Bu dağıtım için uygulama bildirimini belirtir. |
Ad Sekmesi
Bir dağıtım bildirimini ilk oluşturduğunuzda veya açtığınızda Ad sekmesi görüntülenir. Dağıtımı benzersiz olarak tanımlar ve isteğe bağlı olarak geçerli bir hedef platform belirtir.
| Arabirim Öğesi | Açıklama |
|---|---|
| Ad | Gereklidir. Dağıtım bildiriminin adı. Genellikle dosya adıyla aynıdır. |
| Sürüm | Gereklidir. Dağıtımın N.N.N.N biçimindeki sürüm numarası. Yalnızca ilk ana derleme numarası gereklidir. Örneğin, bir uygulamanın 1.0 sürümü için geçerli değerler , , 1.01.0.0ve 1.0.0.0değerlerini içerir1. |
| İşlemci | İsteğe bağlı. Bu dağıtımın üzerinde çalışabileceği makine mimarisi. Varsayılan, msiltüm yönetilen derlemelerin varsayılan biçimi olan , veya Microsoft Ara Dili'dir. Uygulamanızdaki derlemeleri belirli bir mimari için derlediyseniz bu alanı değiştirin. |
| Kültür | İsteğe bağlı. Bu uygulamanın çalıştırıldığı iki parçalı ISO ülke/bölge kodu. Varsayılan değer: neutral. |
| Ortak anahtar belirteci | İsteğe bağlı. Bu dağıtım bildiriminin imzalandığı ortak anahtar. Bu yeni veya imzasız bir bildirimse, bu alan olarak Unsignedgörünür. |
Açıklama Sekmesi
| Arabirim Öğesi | Description |
|---|---|
| Publisher | Gereklidir. Uygulamadan sorumlu kişinin veya kuruluşun adı. Bu değer Başlangıç menüsü klasör adı olarak kullanılır. |
| Ürün | Gereklidir. Tam ürün adı. Dağıtım Seçeneklerisekmesindeki Uygulama Türü öğesi için Yerel Olarak Yükle'yi seçtiyseniz, bu ad Başlat menüsü bağlantısında ve bu uygulama için Program Ekle veya Kaldır'da görünen addır. |
| Destek Konumu | İsteğe bağlı. Müşterilerin uygulama için yardım ve destek alabildiği URL. |
Dağıtım Seçenekleri Sekmesi
| Arabirim Öğesi | Description |
|---|---|
| Uygulama Türü | İsteğe bağlı. Bu uygulamanın kendisini istemci bilgisayara yükleyip yüklemediğini (Yerel Olarak Yükle), çevrimiçi çalışıp çalışmayacağını (Yalnızca Çevrimiçi) veya tarayıcıda çalışan bir WPF uygulaması (WPF Tarayıcı Uygulaması) olduğunu belirtir. Varsayılan değer Yerel Olarak Yükle'dir. |
| Başlangıç Konumu | İsteğe bağlı. Uygulamanın gerçekten başlatılması gereken URL. Web'den kendisini güncelleştirmesi gereken bir CD'den uygulama dağıtırken kullanışlıdır. |
| Bildirime Başlangıç Konumu (ProviderURL) ekle | İsteğe bağlı. ClickOnce'ın uygulama güncelleştirmeleri için inceleyeceği URL'yi belirtir. |
| Yükledikten sonra uygulamayı otomatik olarak çalıştır | Gereklidir. ClickOnce uygulamasının url'den ilk yüklemeden hemen sonra çalıştırılması gerektiğini belirtir. Varsayılan onay kutusu seçilidir. |
| URL parametrelerinin uygulamaya geçirilmesine izin ver | Gereklidir. Dağıtım bildiriminin URL'sine eklenen bir sorgu dizesi aracılığıyla parametre verilerinin ClickOnce uygulamasına aktarılmasına izin verir. Varsayılan onay kutusu temizlenir. |
| .deploy dosya uzantısını kullanma | Gereklidir. Seçildiğinde, uygulama bildirimindeki tüm dosyalar .deploy uzantısına sahip olmalıdır. Varsayılan onay kutusu temizlenir. |
Güncelleştirme Seçenekleri Sekmesi
Güncelleştirme Seçenekleri sekmesi yalnızca Ad sekmesindeki Uygulama Türü seçim kutusu Yerel Olarak Yükle olarak ayarlandığında burada bahsedilen seçenekleri içerir.
| Arabirim Öğesi | Description |
|---|---|
| Bu uygulama güncelleştirmeleri denetlemelidir | ClickOnce'un uygulama güncelleştirmelerini denetlemesi gerekip gerekmediğini belirtir. Bu onay kutusu seçili değilse, ad alanında API'leri System.Deployment.Application kullanarak program aracılığıyla güncelleştirmediğiniz sürece uygulama güncelleştirmeleri denetlemez. |
| Uygulamanın güncelleştirmeleri ne zaman denetlemesi gerektiğini seçme | Güncelleştirme denetimleri için iki seçenek sağlar: - Uygulama başlamadan önce. Güncelleştirme denetimi, uygulama yürütmeden önce gerçekleştirilir. - Uygulama başladıktan sonra. Güncelleştirme denetimi, uygulamanın ana formu başlatıldıktan sonra başlar ve uygulama bir sonraki başlatışında çalışır. |
| Güncelleştirme denetimi sıklığı | ClickOnce'un güncelleştirmeleri ne sıklıkta denetlemesi gerektiğini belirler: - Uygulamanın her çalıştırıldığında denetleyin. ClickOnce, kullanıcı uygulamayı her açtığında bir güncelleştirme denetimi gerçekleştirir. - Her birini denetleyin: Güncelleştirmeleri denetlemeden önce geçmesi gereken bir zaman aralığı ve birim (saat, gün veya hafta) seçin. |
| Bu uygulama için gereken en düşük sürümü belirtin | İsteğe bağlı. Uygulamanızın belirli bir sürümünün gerekli bir yükleme olduğunu ve kullanıcılarınızın önceki bir sürümle çalışmasını önlediğini belirtir. |
| Sürüm | Bu uygulama için gerekli en düşük sürümü belirtin onay kutusu seçiliyse gereklidir. Sağlanan sürüm numarası N.N.N.N biçiminde olmalıdır. Yalnızca ilk ana derleme numarası gereklidir. Örneğin, bir uygulamanın 1.0 sürümü için geçerli değerler , 1.0, 1.0.0ve 1.0.0.0değerlerini içerir1. |
Uygulama Başvurusu Sekmesi
Uygulama Başvurusu sekmesi, bu konunun önceki bölümlerinde açıklanan Ad sekmesiyle aynı alanları içerir. Tek özel durum aşağıdaki alandır.
| Arabirim Öğesi | Description |
|---|---|
| Bildirim Seç | Uygulama bildirimini seçmenize olanak tanır. Bir uygulama bildirimi seçtiğinizde bu sayfadaki diğer tüm alanlar doldurulur. |
