Wskazówki: ręczne wdrażanie aplikacji ClickOnce

Artykuł
06/10/2015

Jeśli nie można użyć programu Visual Studio do wdrażania sieci ClickOnce aplikacji albo trzeba korzystać z funkcji zaawansowanych rozmieszczeń, takich jak zaufane wdrażanie aplikacji należy używać narzędzia wiersza polecenia Mage.exe, aby utworzyć swoje ClickOnce manifesty.W tym instruktażu opisano sposób tworzenia ClickOnce wdrażania przy użyciu wiersza polecenia wersja (Mage.exe) lub wersji graficznego (MageUI.exe) Manifest generacji i narzędzia do edycji.

Wymagania wstępne

W tym instruktażu ma pewne wymagania wstępne i opcje, które należy wybrać przed rozpoczęciem budowy do wdrożenia.

Zainstaluj Mage.exe i MageUI.exe.

Mage.exe i MageUI.exe są częścią Windows Software Development Kit (SDK).Musi mieć albo Windows SDK zainstalowane lub wersję z Windows SDK dołączony do programu Visual Studio.Aby uzyskać więcej informacji, zobacz Windows SDK w witrynie MSDN.
Należy zapewnić aplikację, aby wdrożyć.

W tym instruktażu założono, że jest gotowe do wdrożenia aplikacji systemu Windows.Ta aplikacja będzie dalej jako AppToDeploy.
Określić rozkład rozmieszczania.

Opcje dystrybucji obejmują: sieci Web, udziale pliku lub dysku CD.Aby uzyskać więcej informacji, zobacz Wskazówki dotyczące wdrażania ClickOnce.
Określ, czy aplikacja wymaga podniesionym poziomie zaufania.

Jeśli aplikacja wymaga pełnego zaufania — na przykład, pełny dostęp do systemu użytkownika — można użyć -TrustLevel to możliwość Mage.exe.Jeśli chcesz zdefiniować uprawnienia niestandardowe, ustawione dla aplikacji, można skopiować sekcji uprawnień Internet lub intranet z innym manifestu, zmodyfikować go do własnych potrzeb i dodać go do manifest aplikacji przy użyciu edytora tekstów lub MageUI.exe.Aby uzyskać więcej informacji, zobacz Przegląd wdrażania zaufanych aplikacji.
Uzyskać certyfikat Authenticode.

Należy podpisać wdrażania przy użyciu certyfikatu Authenticode.Można wygenerować certyfikatu testowego za pomocą narzędzi Visual Studio, MageUI.exe, lub MakeCert.exe i Pvk2Pfx.exe lub certyfikat można uzyskać z certyfikatu urzędu certyfikacji.Jeśli wybierzesz opcję Użyj zaufanego wdrażania aplikacji, należy również wykonać jednorazowa instalacja certyfikatu na wszystkich komputerach klienckich.Aby uzyskać więcej informacji, zobacz Przegląd wdrażania zaufanych aplikacji.
Upewnij się, że aplikacja nie jest manifestu informacje funkcji Kontrola konta użytkownika.

Należy ustalić, czy aplikacja zawiera manifestu kontroli konta użytkownika (UAC) informacje, takie jak <dependentAssembly> element.Aby zbadać manifest aplikacji, można użyć narzędzi Windows Sysinternals Sigcheck narzędzia.

Jeśli aplikacja zawiera manifestu ze szczegółami dotyczącymi funkcji Kontrola konta użytkownika, należy przebudować go bez informacji o funkcji Kontrola konta użytkownika.C# projektu w programie Visual Studio Otwórz okno właściwości projektu, a następnie wybierz kartę aplikacji.W Manifest listy rozwijanej wybierz Tworzenie aplikacji bez manifest.Dla projektu Visual Basic w programie Visual Studio, Otwórz okno właściwości projektu, wybierz kartę aplikacji, a następnie kliknij przycisk Ustawienia funkcji Kontrola konta użytkownika w widoku.Usunąć wszystkie elementy w ramach jednolitego otwartego pliku manifestu, <asmv1:assembly> element.
Określ, czy aplikacja wymaga wstępne na komputerze klienckim.

ClickOnceaplikacji wdrożonych z programu Visual Studio może zawierać inicjującego uwzględnione w wymaganiach wstępnych instalacji (setup.exe) z wdrożeniem.W tym instruktażu tworzy dwa manifestów wymagane dla ClickOnce wdrażania.Wstępne program inicjujący można utworzyć za pomocą GenerateBootstrapper — Zadanie.

Aby wdrożyć aplikację za pomocą narzędzia wiersza polecenia Mage.exe

Utwórz katalog, w którym będą przechowywane na ClickOnce rozmieszczania plików.
Tworzenie podkatalogu wersji właśnie utworzonego katalogu wdrażania.Jeśli po raz pierwszy wdrażania aplikacji, nazwy podkatalogu wersji 1.0.0.0.

[!UWAGA]

Wersja wdrażania mogą być odmienne od wersji aplikacji.
Skopiuj wszystkie pliki aplikacji do podkatalogu wersji, w tym pliki wykonywalne, zespoły, zasobów i plików danych.Jeśli to konieczne, można utworzyć dodatkowe podkatalogi, które zawierają dodatkowe pliki.
Otwórz Windows SDK lub Visual Studio polecenia monit i zmienić na podkatalog wersji.
Utwórz manifest aplikacji z wywołania Mage.exe.Poniższa instrukcja tworzy manifest aplikacji dla kod skompilowany do uruchomienia na procesorze Intel x 86.
```
mage -New Application -Processor x86 -ToFile AppToDeploy.exe.manifest -name "My App" -Version 1.0.0.0 -FromDirectory . 
```
[!UWAGA]

Należy koniecznie dodać kropkę (.) po -FromDirectory opcja, która wskazuje bieżący katalog.Jeśli nie zawierają kropki, należy określić ścieżkę do plików aplikacji.
Zarejestrować się manifest aplikacji przy użyciu tego certyfikatu Authenticode.Zastąpić mycert.pfx ze ścieżką do pliku certyfikatu.Zastąpić passwd z hasłem pliku certyfikatu.
```
mage -Sign AppToDeploy.exe.manifest -CertFile mycert.pfx -Password passwd
```
Zmiany do głównego katalogu wdrażania.
Generowanie manifestu wdrażania z zaproszeniem do Mage.exe.Domyślnie, znak będzie Mage.exe na ClickOnce wdrażania jako zainstalowaną aplikację, tak że mogą być uruchamiane zarówno online i offline.Umożliwia utworzenie aplikacji dostępne tylko wtedy, gdy użytkownik jest w trybie online, -Install opcji o wartości false.Jeśli użytkownik korzysta z domyślnych, a użytkownicy będą instalować aplikację z witryny sieci Web lub w udziale pliku, upewnij się, że wartość -ProviderUrl opcji wskazuje lokalizację aplikacji manifest na serwerze sieci Web lub udziału.
```
mage -New Deployment -Processor x86 -Install true -Publisher "My Co." -ProviderUrl "\\myServer\myShare\AppToDeploy.application" -AppManifest 1.0.0.0\AppToDeploy.exe.manifest -ToFile AppToDeploy.application
```
Zarejestruj manifestu wdrażania przy użyciu tego certyfikatu Authenticode.
```
mage -Sign AppToDeploy.application -CertFile mycert.pfx -Password passwd
```
Skopiuj wszystkie pliki w katalogu instalacyjnym wdrażania docelowego lub na nośniku.Może to być folder na witrynę sieci Web lub witryny FTP, udział pliku lub dysku CD-ROM.
Zapewnianie użytkownikom z adresu URL, UNC lub nośnika fizycznego wymagane do zainstalowania aplikacji.Jeśli podasz adres URL lub ścieżkę UNC, musisz nadać użytkownikom pełną ścieżkę do manifestu wdrażania.Na przykład jeśli AppToDeploy jest wdrożony http://webserver01/ w katalogu AppToDeploy, pełną ścieżkę URL byłoby http://webserver01/AppToDeploy/AppToDeploy.application.

Aby wdrożyć aplikację za pomocą narzędzia graficzne MageUI.exe

Utwórz katalog, w którym będą przechowywane na ClickOnce rozmieszczania plików.
Tworzenie podkatalogu wersji właśnie utworzonego katalogu wdrażania.Jeśli po raz pierwszy wdrażania aplikacji, nazwy podkatalogu wersji 1.0.0.0.

[!UWAGA]

Wersja wdrażania prawdopodobnie różni się od wersji aplikacji.
Skopiuj wszystkie pliki aplikacji do podkatalogu wersji, w tym pliki wykonywalne, zespoły, zasobów i plików danych.Jeśli to konieczne, można utworzyć dodatkowe podkatalogi, które zawierają dodatkowe pliki.
Uruchom narzędzie graficzne MageUI.exe.
```
MageUI.exe
```
Tworzyć nowe manifest aplikacji, wybierając pliku, Nowy, Manifest aplikacji z menu.
W domyślnym Nazwa tab, wpisz liczbę nazwa i wersja tego wdrożenia.Określ również procesora wbudowanych aplikacji, takich jak x 86.
Wybierz pliki tab, a następnie kliknij przycisk wielokropka (...) przycisk Dalej, aby katalogu aplikacji pole tekstowe.Zostanie wyświetlone okno dialogowe Przeglądanie w poszukiwaniu folderu.
Zaznacz ten podkatalog wersji zawierającym pliki aplikacji, a następnie kliknij przycisk OK.
Jeśli zostanie wdrożony z Internet Information Services (IIS), zaznacz podczas wypełniania dodać do dowolnego pliku, który nie mają rozszerzenie .deploy pole wyboru.
Kliknij przycisk Wypełnij przycisk, aby dodać wszystkie pliki aplikacji do listy plików.Jeśli aplikacja zawiera więcej niż jeden plik wykonywalny, zaznaczając głównego pliku wykonywalnego dla tego wdrożenia jako aplikacja uruchamiania Punktu wejścia z Typ pliku listy rozwijanej.(Jeśli aplikacja zawiera tylko jeden plik wykonywalny, MageUI.exe spowoduje oznaczenie go dla Ciebie.)
Wybierz wymagane uprawnienia kartę i wybierz poziom zaufania, że potrzebne aplikacji w celu potwierdzenia.Wartością domyślną jest FullTrust, który będzie odpowiedni dla większości aplikacji.
Wybierz pliku, Zapisać jako z menu.Zostanie wyświetlone okno dialogowe Opcje podpisywania, w którym monitowania do zarejestrowania się manifest aplikacji.
Jeśli certyfikat przechowywany jako plik w systemie plików, użyj znak z pliku certyfikatu opcji i wybierz certyfikat z systemu plików za pomocą wielokropka (...) przycisk.Następnie wpisz hasło certyfikatu.

- lub -

Jeśli certyfikat jest przechowywany w magazynie certyfikatów dostępna na komputerze, zaznacz Podpisz certyfikatem przechowywane opcji i wybierz certyfikat z podanej listy.
Kliknij przycisk OK do podpisania Twój manifest aplikacji.Zostanie wyświetlone okno dialogowe Zapisz jako.
W oknie dialogowym Zapisz jako określony katalog wersji, a następnie kliknij przycisk zapisać.
Wybierz pliku, Nowy, Wdrażania Manifest z menu, aby utworzyć Twój manifest wdrażania.
Na Nazwa tab, określ nazwę i numer wersji dla tego wdrożenia (1.0.0.0 w tym przykładzie).Określ również procesora wbudowanych aplikacji, takich jak x 86.
Wybierz Opis , a następnie określ wartości dla wydawcy i Rozpoczęcie pracyt.(Produktu jest nazwą nadawaną do aplikacji w menu Start systemu Windows, gdy aplikacja zainstaluje na komputerze klienckim w trybie offline.)
Wybierz Opcje wdrażania kartę i w Lokalizacji uruchomić tekst Określ lokalizację manifest aplikacji na serwerze sieci Web lub udziału.Na przykład \\myServer\myShare\AppToDeploy.application.
Jeśli rozszerzenie .deploy dodaje się w poprzednim kroku, wybierz również wykorzystania rozszerzenie .deploy tutaj.
Wybierz Opcje aktualizacji , a następnie określ, jak często chcesz zaktualizować tę aplikację.Jeśli aplikacja używa UpdateCheckInfo , aby sprawdzić aktualizacje sobie, wyczyść tej aplikacji należy sprawdzić aktualizacje pole wyboru.
Wybierz Odniesienia aplikacji tab, a następnie kliknij przycisk Zaznacz Manifest przycisku.Otwórz okno dialogowe jest wyświetlane.
Wybierz utworzony wcześniej manifest aplikacji, a następnie kliknij przycisk Otwórz.
Wybierz pliku, Zapisać jako z menu.Zostanie wyświetlone okno dialogowe Opcje podpisywania, w którym prośbą do podpisania manifestu wdrażania.
Jeśli certyfikat przechowywany jako plik w systemie plików, użyj znak z pliku certyfikatu opcji i wybierz certyfikat z systemu plików za pomocą wielokropka (...) przycisk.Następnie wpisz hasło certyfikatu.

- lub -

Jeśli certyfikat jest przechowywany w magazynie certyfikatów dostępna na komputerze, zaznacz Podpisz certyfikatem przechowywane opcji i wybierz certyfikat z podanej listy.
Kliknij przycisk OK do podpisania Twój manifest wdrażania.Zostanie wyświetlone okno dialogowe Zapisz jako.
W Zapisać jako okno dialogowe, przejście w górę jeden katalog główny urząd certyfikacji, wdrażania i następnie kliknij przycisk zapisać.
Skopiuj wszystkie pliki w katalogu instalacyjnym wdrażania docelowego lub na nośniku.Może to być folder na witrynę sieci Web lub witryny FTP, udział pliku lub dysku CD-ROM.
Zapewnianie użytkownikom z adresu URL, UNC lub nośnika fizycznego wymagane do zainstalowania aplikacji.Jeśli podasz adres URL lub ścieżkę UNC, należy nadać użytkownikom pełną ścieżkę manifestu wdrażania.Na przykład jeśli AppToDeploy jest wdrożony http://webserver01/ w katalogu AppToDeploy, pełną ścieżkę URL byłoby http://webserver01/AppToDeploy/AppToDeploy.application.

Następne kroki

Kiedy należy zainstalować nową wersję aplikacji, należy utworzyć nowy katalog o nazwie po nowej wersji — na przykład, 1.0.0.1—and, skopiuj nowe pliki aplikacji do nowego katalogu.Następnie należy wykonać poprzednie kroki, aby utworzyć i zarejestrować nowy manifest aplikacji, aktualizacji i podpisać manifestu wdrażania.Należy zachować ostrożność określić tę samą wersję wyższe w obu Mage.exe -New i –Update rozmowy, jako ClickOnce z najbardziej znaczących całkowitą lewego aktualizuje tylko nowsze wersje.Jeśli używana jest MageUI.exe, można zaktualizować manifestu wdrażania przez otwarcie go, zaznaczając Odniesienia aplikacji kartę, klikając przycisk Zaznacz Manifest przycisk, a następnie wybierając manifest aplikacji zaktualizowane.