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. |