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

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 docelowego .NET Framework 4 profilu klienta. 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 program MageUI.exe aktualizuje manifest do docelowego profilu klienta .NET Framework 4. Aby uzyskać więcej informacji, zobaczMage.exe (Narzędzie tworzenia i edycji manifestów).

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

Dwie wersje Mage.exe i MageUI.exe są uwzględniane jako składnik 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 elementu compatibleFrameworks 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 zaznaczony 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 o podpisywanie, który zwykle pojawia się podczas zapisywania pliku i wybrano pozycję Zaloguj się Zapisz. 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 manifestu lub licencji zaufania po raz pierwszy lub podczas zmiany manifestu lub licencji zaufania. Ta opcja jest wyświetlana tylko wtedy, gdy opcja Zaloguj się — Zapisz w oknie dialogowym Preferencje jest zaznaczona. Podczas podpisywania manifestu, który określa wartość w polu tekstowym TimeStamping URI , musisz mieć połączenie z Internetem.

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 w celu 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 zaufanych 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.
TimeStamping URI 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 Windows programu certyfikatów głównych oraz 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 manifestu aplikacji

Na karcie Manifest aplikacji jest wyświetlana zawartość manifestu aplikacji. Manifest aplikacji zawiera opis wszystkich plików dołączonych do wdrożenia oraz uprawnień wymaganych 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 pierwszego 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. Zwykle taka sama jak nazwa pliku.
Wersja Wymagane. Numer wersji wdrożenia w postaci N.N.N.N. Wymagany jest tylko pierwszy główny numer kompilacji. Na przykład w wersji 1.0 aplikacji prawidłowe wartości obejmują 1, 1.0, 1.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, zobaczNgen.exe (Generator obrazów natywnych).
Kultura Opcjonalny. Dwuscowy 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 manifest aplikacji został podpisany. Jeśli jest to nowy lub niepodpisane manifest, to pole będzie wyświetlane jako Unsigned.

Karta Opis

Te informacje są zwykle podane 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 menu Start folderu.
Product Pełna nazwa produktu. Jeśli dla elementu Typ aplikacji wybrano opcję Zainstaluj lokalnie na karcie Opcje wdrażania manifestu wdrożenia, ta nazwa będzie wyświetlana w linku menu Start oraz 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
Windows Presentation Foundation Browser Określa, czy jest to aplikacja WPF, która działa 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 w katalogu znajdzie pojedynczy plik wykonywalny, automatycznie oznacza go jako punkt wejścia, który jest plikiem po raz pierwszy wykonywanym podczas ClickOnce aplikacji 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że być oznaczony 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 ani aktualizacji, ale mogą być pobierane w czasie rzeczywistym przy użyciu interfejsu API System.Deployment On-Demand. Aby uzyskać więcej informacji, zobacz Przewodnik: pobieranie zestawów na żądanie za pomocą interfejsu API ClickOnce wdrażania przy użyciu projektanta.
Grupa Etykieta dla zestawu plików opcjonalnych. 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 chcesz udzielić aplikacji większej liczby dostępu do komputera lokalnego, niż jest przyznawane domyślnie. Aby uzyskać więcej informacji, zobacz Securing ClickOnce Applications (Zabezpieczanie ClickOnce aplikacji).

Element interfejsu użytkownika Opis
Typ zestawu uprawnień Minimalny zestaw uprawnień wymagany przez tę aplikację do uruchomienia na kliencie. Opis tych zestawów uprawnień oraz uprawnienia, których te zestawy uprawnień nie wymagają, zawiera temat Nazwane zestawy uprawnień.
Szczegóły Plik XML utworzony dla manifestu aplikacji reprezentujący zestaw uprawnień. Jeśli nie masz dobrej znajomości formatu XML manifestu aplikacji, nie należy edytować tego kodu XML ręcznie. Aby uzyskać więcej informacji, zobacz ClickOnce Manifest aplikacji.

Karta manifestu 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 rozpoczęcia.
Opcje aktualizacji Określa, jak często ClickOnce sprawdzać aktualizacje aplikacji.
Informacje o aplikacji Określa manifest aplikacji dla tego wdrożenia.

Karta Nazwa

Karta Nazwa jest wyświetlana podczas pierwszego 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. Zwykle taka sama jak nazwa pliku.
Wersja Wymagane. Numer wersji wdrożenia w postaci N.N.N.N. Wymagany jest tylko pierwszy główny numer kompilacji. Na przykład w wersji 1.0 aplikacji prawidłowe wartości obejmują 1, 1.0, 1.0.0i 1.0.0.0.
Procesor Opcjonalny. Architektura maszyny, na której można uruchomić to wdrożenie. Domyślnym formatem msiljest , lub Microsoft Intermediate Language, domyślny format wszystkich zarządzanych zestawów. Zmień to pole, jeśli skompilowane zestawy w aplikacji zostały skompilowane dla określonej architektury.
Kultura Opcjonalny. Dwuscowy 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 ten manifest wdrożenia został podpisany. Jeśli jest to nowy lub niepodpisane 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 menu Start folderu.
Product Wymagane. Pełna nazwa produktu. W przypadku wyboru opcji Zainstaluj lokalnie dla elementu Typ aplikacji na karcie Opcje wdrażania ta nazwa będzie wyświetlana w linku menu Start oraz 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 jest instalowana na komputerze klienckim (Instaluj lokalnie), działa w trybie online (tylko online), czy jest aplikacją WPF uruchamianą w przeglądarce (aplikacja przeglądarki WPF). Wartość domyślna to Zainstaluj lokalnie.
Lokalizacja rozpoczęcia Opcjonalny. Adres URL, z którego faktycznie powinna zostać uruchomiona aplikacja. Przydatne podczas wdrażania aplikacji z dysku CD, która powinna zostać sama zaktualizowana z sieci Web.
Uwzględnianie lokalizacji rozpoczęcia (ProviderURL) w manifeście Opcjonalny. Określa adres URL, pod którym technologia ClickOnce będzie szukać aktualizacji aplikacji.
Automatyczne uruchamianie aplikacji po zainstalowaniu Wymagane. Określa, że ClickOnce powinna działać natychmiast po początkowej instalacji z adresu URL. Pole wyboru jest domyślnie zaznaczone.
Zezwalaj na przekazywane parametry adresu URL do aplikacji Wymagane. Umożliwia transfer danych parametrów do aplikacji ClickOnce za pośrednictwem ciągu zapytania dołączonego do adresu URL manifestu wdrożenia. Domyślnie pole wyboru jest wyczyszone.
Korzystanie z rozszerzenia pliku .deploy Wymagane. Po wybraniu wszystkie pliki w manifeście aplikacji muszą mieć rozszerzenie .deploy. Domyślnie pole wyboru jest wyczyszone.

Karta Opcje aktualizacji

Karta Opcje aktualizacji zawiera tylko opcje wymienione w tym miejscu, gdy pole wyboru Typ aplikacji na karcie Nazwa ma wartość Zainstaluj lokalnie.

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

- Przed rozpoczęciem aplikacji. Sprawdzanie aktualizacji jest wykonywane przed wykonaniem aplikacji.
- Po zakończeniu uruchamiania aplikacji. Sprawdzanie aktualizacji rozpoczyna się po zainicjowaniu formularza głównego aplikacji i zostanie uruchomione przy następnym uruchomieniu aplikacji.
Częstotliwość sprawdzania aktualizacji Określa, jak często ClickOnce sprawdzać aktualizacje:

- Sprawdzaj za każdym razem, gdy aplikacja jest uruchamiana. ClickOnce będzie 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 aktualizacji.
Określ minimalną wymaganą wersję dla tej aplikacji Opcjonalny. Określa, że wymagana jest instalacja konkretnej wersji aplikacji, co uniemożliwia użytkownikom pracę z wcześniejszą wersją.
Wersja Wymagane, jeśli pole wyboru Określ minimalną wymaganą wersję dla tej aplikacji jest zaznaczone. Podany numer wersji musi mieć postać N.N.N.N. Wymagany jest tylko pierwszy główny numer kompilacji. Na przykład w wersji 1.0 aplikacji prawidłowe wartości obejmują 1, 1.0, 1.0.0i 1.0.0.0.

Karta Odwołania do aplikacji

Karta Odwołanie do aplikacji zawiera te same pola co karta Nazwa opisana wcześniej w tym temacie. Jedynym 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ż