MageUI.exe (Narzędzie generowania i edytowania manifestu, klient grafiki)

  • Artykuł

MageUI.exe obsługuje takie same funkcje jak narzędzie wiersza polecenia Mage.exe, ale z interfejsem użytkownika systemu Windows (UI). Za pomocą tego narzędzia można tworzyć, edytować i podpisywać manifesty wdrażania i aplikacji. Nowe manifesty, które są tworzone za pomocą MageUI.exe docelowy profil klienta .NET Framework 4. Poprzednie wersje MageUI.exe stosuje się do poprzednich wersji .NET Framework. Podczas dodawania lub usuwania zestawów z manifestu lub ponownego podpisywania istniejących manifestów MageUI.exe nie aktualizuje manifestu do docelowego profilu klienta .NET Framework 4. Aby uzyskać więcej informacji, zobacz Mage.exe (Narzędzie tworzenia i edycji manifestów).

To narzędzie jest instalowane automatycznie z programem Visual Studio. Aby uruchomić narzędzie, użyj wiersza polecenia dla deweloperów programu Visual Studio lub programu Visual Studio Developer PowerShell.

Dwie wersje Mage.exe i MageUI.exe są dołączone jako składnik programu Visual Studio. Aby wyświetlić informacje o wersji, uruchom MageUI.exe, wybierz pozycję Pomoc i wybierz pozycję Informacje. W tej dokumentacji opisano wersję 4.0.x.x programów Mage.exe i MageUI.exe.

Uwaga

MageUI.exe nie obsługuje zgodnego elementuFrameworks podczas zapisywania manifestu aplikacji, który został już podpisany przy użyciu certyfikatu przy użyciu MageUI.exe. Zamiast tego należy użyć Mage.exe.

Lista elementów UI

W następującej tabeli wymieniono elementy menu i paski narzędzi, które są dostępne.

Polecenie Menu Skrót Opis
Manifest aplikacji Plik, Nowy Tworzy nowy manifest aplikacji.
Manifest wdrożenia Plik, Nowy Tworzy nowy manifest wdrożenia.
Otwórz Plik CTRL+O Otwiera do edycji istniejący manifest wdrażania, manifest aplikacji lub licencję zaufania.
Zamknij Plik CTRL+F4 Zamyka otwarty plik.

Jeśli modyfikujesz plik przed jego zamknięciem, MageUI.exe monituje o ponowne podpisywanie pliku kluczem publicznym, parą kluczy lub przechowywanym certyfikatem.
Zapisz Plik CTRL+S Zapisuje na dysku dokument, który aktualnie ma fokus wprowadzania użytkownika.
Zapisz jako Plik Zapisuje plik na dysku, umożliwiając podanie nowej nazwy pliku i/lub lokalizacji.
Zapisz wszystko Plik Zapisuje zmiany wprowadzone do wszystkich plików aktualnie otwartych w MageUI.exe.
Preferencje Plik Otwiera okno dialogowe Preferencje . Aby uzyskać więcej informacji, zobacz następującą sekcję.
Zakończ Plik ALT+F4 Zamyka program MageUI.exe.
Cut Edytuj CTRL+X Usuwa zaznaczony tekst z aplikacji i przenosi je do Schowka systemu Windows.
Kopiuj Edytuj CTRL+C Kopiuje zaznaczony tekst do Schowka systemu Windows.
Wklej Edytuj CTRL+V Wkleja tekst ze Schowka systemu Windows do aktywnego elementu tekstu.
Usuwanie Edytuj Usuwa element aktualnie wybrany na liście, taki jak licencja zaufania na karcie Manifest wdrożenia .
Zamknij wszystkie Okno Zamyka wszystkie pliki otwarte w MageUI.exe. Jeżeli jeden lub więcej plików wymagają zapisania, MageUI.exe wyświetli monit o zapisanie ich. MageUI.exe również wyświetla monit o wybranie klucza podpisywania dla każdego niepodpisanego lub zmienionego pliku.
Informacje Pomoc Wyświetla informacje o wersji i prawach autorskich dotyczące MageUI.exe.

Okno dialogowe Preferencje

Okno dialogowe Preferencje zawiera następujące elementy.

Element interfejsu użytkownika Opis
Zapisywanie logowania Monituje o podpisanie pliku przy każdym zapisie modyfikacji.
Użyj domyślnego certyfikatu podpisywania Używa klucza wprowadzonego w polu tekstowym Plik certyfikatu , aby podpisać wszystkie pliki. Eliminuje to monit podpisywania, który zwykle pojawia się po zapisaniu pliku i wybraniu opcji Zaloguj się podczas zapisywania . Użyj przycisku wielokropka (...) obok pola tekstowego Plik certyfikatu , aby wybrać plik klucza.
Algorytm porządkowania Określa algorytm, za pomocą którego zostaną wygenerowane skróty zależności. Wartością musi być „sha256RSA” lub „sha1RSA”. Domyślną wartością jest SHA1. Używana zarówno w manifestach aplikacji, jak i wdrażania. Jeśli użytkownik poda certyfikat podczas zapisywania manifestu, używane są algorytmy w certyfikacie do wygenerowania rozkładów zależności.

Okno dialogowe Opcje podpisywania

Okno dialogowe Opcje podpisywania jest wyświetlane podczas zapisywania licencji manifestu lub zaufania po raz pierwszy lub zmiany licencji manifestu lub zaufania. Pojawia się tylko wtedy, gdy w oknie dialogowym Preferencje jest zaznaczona opcja Zaloguj się. Musisz nawiązać połączenie z Internetem podczas podpisywania manifestu, który określa wartość w polu tekstowym Identyfikator URI sygnatury czasowej .

To okno dialogowe zawiera następujące elementy.

Element interfejsu użytkownika Opis
Podpisywanie przy użyciu pliku certyfikatu Podpisuje manifest certyfikatem cyfrowym przechowywanym w systemie plików.
Plik Zapewnia miejsce do wpisania ścieżki do pliku pfx reprezentującego certyfikat.
... Otwiera okno dialogowe Wybieranie pliku do wybrania istniejącego pliku pfx.
Nowe Generuje nowy pfx niesprawdzalny przez urząd certyfikacji (CA). Aby uzyskać więcej informacji na temat typów certyfikatów używanych do podpisywania wdrożeń ClickOnce, zobacz Omówienie wdrażania zaufanej aplikacji.
Password (Hasło) Miejsce na wpisanie hasła używanego do podpisywania tym certyfikatem. Jeśli nie ma to zastosowania, może być puste.
Podpisywanie przy użyciu przechowywanego certyfikatu Wyświetla listę wyboru certyfikatów cyfrowych przechowywanych w magazynie certyfikatów na komputerze.
Identyfikator URI sygnatury czasowej Wyświetla identyfikator URI usługi sygnatur cyfrowych. Przypisanie do manifestu znacznika czasu zapobiega konieczności ponownego podpisania manifestu, jeśli certyfikat cyfrowy wygaśnie przed wdrożeniem następnej wersji aplikacji. Aby uzyskać więcej informacji, zobacz Członków programu certyfikatów głównych systemu Windows i ClickOnce i Authenticode.
Nie podpisuj Umożliwia zapisanie manifestu bez dodawania podpisu z certyfikatu cyfrowego.

Opisy karta i panelu

Po otwarciu w programie MageUI.exe dokument pojawia się w obrębie własnej strony karty. Każda karta zawiera zestaw paneli właściwości. Panele zawierają zgrupowane podzbiory danych dokumentu.

Karta Manifest aplikacji

Karta Manifest aplikacji wyświetla zawartość manifestu aplikacji. Manifest aplikacji opisuje wszystkie pliki dołączone do wdrożenia oraz uprawnienia wymagane do uruchomienia aplikacji na kliencie.

Karta Manifest aplikacji zawiera następujące karty.

Element interfejsu użytkownika Opis
Nazwa Określa informacje identyfikujące to wdrożenie.
Opis Określa informacje o wydawcy, produkcie i pomocy technicznej.
Opcje aplikacji Określa, czy jest to aplikacja przeglądarki i czy ten manifest jest źródłem informacji o zaufaniu.
Pliki Określa wszystkie pliki, które stanowią to wdrożenie.
Wymagane uprawnienia Określa minimalny zestaw uprawnień wymagany przez aplikację do uruchomienia na kliencie.

Karta Nazwa

Karta Nazwa jest wyświetlana podczas tworzenia lub otwierania manifestu aplikacji. Jednoznacznie identyfikuje wdrożenie i opcjonalnie określa prawidłową platformę docelową.

Element interfejsu użytkownika Opis
Nazwa Wymagane. Nazwa manifestu aplikacji. Zazwyczaj jest to samo co nazwa pliku.
Wersja Wymagane. Numer wersji wdrożenia w postaci N.N.N. Wymagany jest tylko pierwszy numer kompilacji głównej. Na przykład w przypadku wersji 1.0 aplikacji prawidłowe wartości to 1, , 1.01.0.0i 1.0.0.0.
Procesor Opcjonalny. Architektura maszyny, na której można uruchomić to wdrożenie. Wartość domyślna to msil, lub Microsoft Intermediate Language, czyli domyślny format wszystkich zarządzanych zestawów. Zmień to pole, jeśli zestawy w aplikacji zostały wstępnie skompilowane dla określonej architektury. Aby uzyskać więcej informacji na temat wstępnej kompilacji, zobacz Ngen.exe (Generator obrazów natywnych).
Kultura Opcjonalny. Dwuczęściowy kod kraju i regionu ISO, w którym działa ta aplikacja. Wartość domyślna to neutral.
Token klucza publicznego Opcjonalny. Klucz publiczny, za pomocą którego podpisano ten manifest aplikacji. Jeśli jest to nowy lub niepodpisany manifest, to pole będzie wyświetlane jako Unsigned.

Karta Opis

Te informacje są zwykle udostępniane w manifeście wdrożenia. Te pola można modyfikować tylko wtedy, gdy pole wyboru Użyj informacji o zaufaniu manifestu aplikacji jest zaznaczone na karcie Opcje aplikacji .

Element interfejsu użytkownika Opis
Wydawca Nazwa osoby lub organizacji odpowiedzialnej za aplikację. Ta wartość jest używana jako nazwa folderu menu Start.
Product Pełna nazwa produktu. Jeśli wybrano opcję Zainstaluj lokalnie dla elementu Typ aplikacji na karcie Opcje wdrażania manifestu wdrożenia, ta nazwa będzie wyświetlana w linku menu Start i w obszarze Dodaj lub Usuń programy dla tej aplikacji.
Lokalizacja pomocy technicznej Adres URL, z którego klienci mogą uzyskać pomoc i pomoc techniczną dla aplikacji.

Karta Opcje aplikacji

Element interfejsu użytkownika Opis
aplikacja przeglądarki Windows Presentation Foundation Określa, czy jest to aplikacja WPF działająca w przeglądarce jako aplikacja przeglądarki XAML (XBAP).
Korzystanie z informacji o zaufaniu manifestu aplikacji Określa, czy ten manifest zawiera informacje o zaufaniu.

Karta Pliki

Element interfejsu użytkownika Opis
Katalog aplikacji Katalog, w którym znajdują się pliki aplikacji. Użyj przycisku wielokropka (...), aby wybrać katalog.
Wypełnić Dodaje wszystkie pliki w katalogu aplikacji i podkatalogach do manifestu aplikacji. Jeśli MageUI.exe znajdzie pojedynczy plik wykonywalny w katalogu, automatycznie oznaczy go jako punkt wejścia, który jest najpierw wykonywany po uruchomieniu aplikacji ClickOnce na kliencie.
Pliki aplikacji Wyświetla listę wszystkich plików w aplikacji. Każdy plik ma trzy atrybuty edytowalne, omówione poniżej.
Typ pliku Typ pliku może być jedną z czterech wartości:

-Brak.
- Punkt wejścia. Podstawowy plik wykonywalny aplikacji. Jako punkt wejścia można oznaczyć tylko jeden plik wykonywalny.
- Plik danych. Plik, taki jak plik XML, który dostarcza dane do aplikacji.
- Plik ikony. Ikona aplikacji, taka jak wyświetlana na pulpicie lub w rogu okna aplikacji.
Opcjonalne Pliki oznaczone jako opcjonalne nie są pobierane podczas początkowej instalacji lub aktualizacji, ale mogą być pobierane w czasie wykonywania przy użyciu interfejsu API System.Deployment On-Demand. Aby uzyskać więcej informacji, zobacz Przewodnik: pobieranie zestawów na żądanie przy użyciu interfejsu API wdrażania ClickOnce przy użyciu projektanta.
Grupa Etykieta zestawu opcjonalnych plików. Etykietę grupy można zastosować do zestawu plików i użyć interfejsu API na żądanie, aby pobrać partię plików z pojedynczym wywołaniem interfejsu API.

Karta Wymagane uprawnienia

Użyj karty Wymagane uprawnienia , jeśli musisz przyznać aplikacji więcej dostępu do komputera lokalnego niż jest domyślnie udzielana. Aby uzyskać więcej informacji, zobacz Zabezpieczanie aplikacji ClickOnce.

Element interfejsu użytkownika Opis
Typ zestawu uprawnień Minimalny zestaw uprawnień wymagany przez tę aplikację do uruchomienia na kliencie. Aby zapoznać się z opisem tych zestawów uprawnień i uprawnieniami, których nie wymagają, zobacz Nazwane zestawy uprawnień.
Szczegóły Kod XML utworzony dla manifestu aplikacji reprezentujący zestaw uprawnień. Jeśli nie znasz dobrze formatu XML manifestu aplikacji, nie należy edytować tego kodu XML ręcznie. Aby uzyskać więcej informacji, zobacz Manifest aplikacji ClickOnce.

Karta Manifest wdrożenia

Karta Manifest wdrożenia zawiera następujące karty.

Element interfejsu użytkownika Opis
Nazwa Określa informacje identyfikujące to wdrożenie.
Opis Określa informacje o wydawcy, produkcie i pomocy technicznej.
Opcje wdrażania Określa dodatkowe informacje o wdrożeniu, takie jak typ aplikacji i lokalizacja początkowa.
Opcje aktualizacji Określa, jak często usługa ClickOnce powinna sprawdzać dostępność aktualizacji aplikacji.
Dokumentacja aplikacji Określa manifest aplikacji dla tego wdrożenia.

Karta Nazwa

Karta Nazwa jest wyświetlana podczas tworzenia lub otwierania manifestu wdrożenia. Jednoznacznie identyfikuje wdrożenie i opcjonalnie określa prawidłową platformę docelową.

Element interfejsu użytkownika Opis
Nazwa Wymagane. Nazwa manifestu wdrożenia. Zazwyczaj jest to samo co nazwa pliku.
Wersja Wymagane. Numer wersji wdrożenia w postaci N.N.N. Wymagany jest tylko pierwszy numer kompilacji głównej. Na przykład w przypadku wersji 1.0 aplikacji prawidłowe wartości to 1, , 1.01.0.0i 1.0.0.0.
Procesor Opcjonalny. Architektura maszyny, na której można uruchomić to wdrożenie. Wartość domyślna to msil, lub Microsoft Intermediate Language, domyślny format wszystkich zarządzanych zestawów. Zmień to pole, jeśli zestawy zostały skompilowane w aplikacji dla określonej architektury.
Kultura Opcjonalny. Dwuczęściowy kod kraju/regionu ISO, w którym działa ta aplikacja. Wartość domyślna to neutral.
Token klucza publicznego Opcjonalny. Klucz publiczny, za pomocą którego podpisano ten manifest wdrożenia. Jeśli jest to nowy lub niepodpisany manifest, to pole będzie wyświetlane jako Unsigned.

Karta Opis

Element interfejsu użytkownika Opis
Wydawca Wymagane. Nazwa osoby lub organizacji odpowiedzialnej za aplikację. Ta wartość jest używana jako nazwa folderu menu Start.
Product Wymagane. Pełna nazwa produktu. Jeśli na karcie Opcje wdrażania wybrano pozycję Zainstaluj lokalnie dla elementu Typ aplikacji, ta nazwa będzie wyświetlana w linku menu Start i w obszarze Dodaj lub Usuń programy dla tej aplikacji.
Lokalizacja pomocy technicznej Opcjonalny. Adres URL, z którego klienci mogą uzyskać pomoc i pomoc techniczną dla aplikacji.

Karta Opcje wdrażania

Element interfejsu użytkownika Opis
Typ aplikacji Opcjonalny. Określa, czy ta aplikacja instaluje się na komputerze klienckim (Zainstaluj lokalnie), działa w trybie online (tylko online) lub jest aplikacją WPF działającą w przeglądarce (aplikacja przeglądarki WPF). Wartość domyślna to Zainstaluj lokalnie.
Lokalizacja początkowa Opcjonalny. Adres URL, z którego aplikacja powinna być rzeczywiście uruchomiona. Przydatne podczas wdrażania aplikacji z dysku CD, który powinien zostać zaktualizowany z sieci Web.
Uwzględnij lokalizację początkową (ProviderURL) w manifeście Opcjonalny. Określa adres URL, pod którym technologia ClickOnce będzie szukać aktualizacji aplikacji.
Automatycznie uruchamiaj aplikację po zainstalowaniu Wymagane. Określa, że aplikacja ClickOnce powinna działać natychmiast po początkowej instalacji z adresu URL. Domyślnie jest zaznaczone pole wyboru.
Zezwalaj na przekazywanie parametrów adresu URL do aplikacji Wymagane. Zezwala na transfer danych parametrów do aplikacji ClickOnce za pomocą ciągu zapytania dołączonego do adresu URL manifestu wdrożenia. Wartość domyślna to pole wyboru jest wyczyszczone.
Korzystanie z rozszerzenia pliku .deploy Wymagane. Po wybraniu wszystkie pliki w manifeście aplikacji muszą mieć rozszerzenie .deploy. Wartość domyślna to pole wyboru jest wyczyszczone.

Karta Opcje aktualizacji

Karta Opcje aktualizacji zawiera tylko opcje wymienione tutaj, gdy pole wyboru Typ aplikacji na karcie Nazwa jest ustawione na Pozycję Zainstaluj lokalnie.

Element interfejsu użytkownika Opis
Ta aplikacja powinna sprawdzać dostępność aktualizacji Określa, czy ClickOnce ma sprawdzać dostępność aktualizacji aplikacji. Jeśli to pole wyboru nie jest zaznaczone, aplikacja nie będzie sprawdzać dostępności aktualizacji, chyba że zaktualizujesz ją programowo przy użyciu interfejsów API w System.Deployment.Application przestrzeni nazw.
Wybierz, kiedy aplikacja powinna sprawdzać dostępność aktualizacji Udostępnia dwie opcje sprawdzania aktualizacji:

- Przed uruchomieniem aplikacji. Sprawdzanie aktualizacji jest wykonywane przed wykonaniem aplikacji.
- Po uruchomieniu aplikacji. Sprawdzanie aktualizacji rozpoczyna się po zainicjowaniu formularza głównego aplikacji i zostanie uruchomiony przy następnym uruchomieniu aplikacji.
Częstotliwość sprawdzania aktualizacji Określa, jak często usługa ClickOnce powinna sprawdzać dostępność aktualizacji:

- Sprawdź za każdym razem, gdy aplikacja jest uruchomiona. Funkcja ClickOnce przeprowadza sprawdzanie aktualizacji za każdym razem, gdy użytkownik otworzy aplikację.
- Sprawdź co: wybierz przedział czasu i jednostkę (godziny, dni lub tygodnie), które muszą upłynąć przed sprawdzeniem dostępności aktualizacji.
Określ minimalną wymaganą wersję dla tej aplikacji Opcjonalny. Określa, że określona wersja aplikacji jest wymaganą instalacją, uniemożliwiając użytkownikom pracę z wcześniejszą wersją.
Wersja Wymagane, jeśli jest zaznaczone pole wyboru Określ minimalną wymaganą wersję dla tej aplikacji . Podany numer wersji musi mieć postać N.N.N.N.N. Wymagany jest tylko pierwszy numer kompilacji głównej. Na przykład w przypadku wersji 1.0 aplikacji prawidłowe wartości to 1, 1.0, 1.0.0i 1.0.0.0.

Karta Dokumentacja aplikacji

Karta Dokumentacja aplikacji zawiera te same pola, co karta Nazwa opisana wcześniej w tym temacie. Jednym wyjątkiem jest następujące pole.

Element interfejsu użytkownika Opis
Wybieranie manifestu Umożliwia wybranie manifestu aplikacji. Wszystkie pozostałe pola na tej stronie zostaną wypełnione po wybraniu manifestu aplikacji.

Zobacz też