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