Przewodnik: Ręczne wdrażanie aplikacji ClickOnce

Dotyczy:yes Visual Studio Visual Studio nodla komputerów Mac noVisual Studio Code

Jeśli nie możesz użyć programu Visual Studio do wdrożenia aplikacji ClickOnce lub musisz użyć zaawansowanych funkcji wdrażania, takich jak wdrożenie zaufanej aplikacji, należy użyć narzędzia wiersza polecenia Mage.exe , aby utworzyć manifesty ClickOnce. W tym przewodniku opisano sposób tworzenia wdrożenia technologii ClickOnce przy użyciu wersji wiersza polecenia (Mage.exe) lub wersji graficznej (MageUI.exe) narzędzia generowania manifestu i edytowania.

Wymagania wstępne

Ten przewodnik zawiera pewne wymagania wstępne i opcje, które należy wybrać przed utworzeniem wdrożenia.

  • Zainstaluj Mage.exe i MageUI.exe.

    Mage.exe i MageUI.exe są częścią zestawu Windows Software Development Kit (SDK). Musisz mieć zainstalowany zestaw Windows SDK lub wersję zestawu Windows SDK dołączonego do programu Visual Studio. Aby uzyskać więcej informacji, zobacz Zestaw WINDOWS SDK w witrynie MSDN.

  • Podaj aplikację do wdrożenia.

    W tym przewodniku założono, że masz aplikację systemu Windows, którą możesz wdrożyć. Ta aplikacja będzie określana jako AppToDeploy.

  • Określ sposób dystrybucji wdrożenia.

    Opcje dystrybucji obejmują: Sieć Web, udział plików lub dysk CD. Aby uzyskać więcej informacji, zobacz ClickOnce Security and Deployment (Zabezpieczenia i wdrażanie technologii ClickOnce).

  • Ustal, czy aplikacja wymaga podwyższonego poziomu zaufania.

    Jeśli aplikacja wymaga pełnego zaufania , na przykład pełnego dostępu do systemu użytkownika, możesz użyć -TrustLevel opcji Mage.exe , aby to ustawić. Jeśli chcesz zdefiniować niestandardowy zestaw uprawnień dla aplikacji, możesz skopiować sekcję uprawnień Internetu lub intranetu z innego manifestu, zmodyfikować go zgodnie z potrzebami i dodać go do manifestu aplikacji przy użyciu edytora tekstów lub MageUI.exe. Aby uzyskać więcej informacji, zobacz Omówienie wdrażania zaufanej aplikacji.

  • Uzyskaj certyfikat Authenticode.

    Należy podpisać wdrożenie przy użyciu certyfikatu Authenticode. Certyfikat testowy można wygenerować przy użyciu programu Visual Studio, MageUI.exelub MakeCert.exe i narzędziPvk2Pfx.exe albo uzyskać certyfikat z urzędu certyfikacji. Jeśli zdecydujesz się używać wdrożenia zaufanej aplikacji, należy również przeprowadzić jednorazową instalację certyfikatu na wszystkich komputerach klienckich. Aby uzyskać więcej informacji, zobacz Trusted Application Deployment Overview (Omówienie wdrażania zaufanej aplikacji).

    Uwaga

    Możesz również podpisać wdrożenie przy użyciu certyfikatu CNG, który można uzyskać z urzędu certyfikacji.

  • Upewnij się, że aplikacja nie ma manifestu z informacjami o kontroli konta użytkownika.

    Musisz określić, czy aplikacja zawiera manifest z informacjami kontroli konta użytkownika (UAC), takimi jak <dependentAssembly> element. Aby sprawdzić manifest aplikacji, możesz użyć narzędzia Sysinternals Sigcheck systemu Windows.

    Jeśli aplikacja zawiera manifest ze szczegółami funkcji UAC, należy ją ponownie skompilować bez informacji o kontroli dostępu użytkownika. W przypadku projektu w języku C# w programie Visual Studio otwórz właściwości projektu i wybierz kartę Aplikacja. Z listy rozwijanej Manifest wybierz pozycję Utwórz aplikację bez manifestu. W przypadku projektu Visual Basic w programie Visual Studio otwórz właściwości projektu, wybierz kartę Aplikacja, a następnie kliknij pozycję Wyświetl ustawienia kontroli dostępu użytkownika. W otwartym pliku manifestu usuń wszystkie elementy w ramach pojedynczego <asmv1:assembly> elementu.

  • Ustal, czy aplikacja wymaga wymagań wstępnych na komputerze klienckim.

    Aplikacje ClickOnce wdrożone z poziomu programu Visual Studio mogą zawierać wstępnie wymagany program rozruchowy (setup.exe) we wdrożeniu. Ten przewodnik tworzy dwa manifesty wymagane do wdrożenia technologii ClickOnce. Aby utworzyć wstępnie wymagany program rozruchowy, możesz użyć zadania GenerateBootstrapper.

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

  1. Utwórz katalog, w którym będą przechowywane pliki wdrożenia Technologii ClickOnce.

  2. W właśnie utworzonym katalogu wdrożenia utwórz podkatalog wersji. Jeśli po raz pierwszy wdrażasz aplikację, nadaj nazwę podkatalogowi wersji 1.0.0.0.

    Uwaga

    Wersja wdrożenia może być różna od wersji aplikacji.

  3. Skopiuj wszystkie pliki aplikacji do podkatalogu wersji, w tym pliki wykonywalne, zestawy, zasoby i pliki danych. W razie potrzeby możesz utworzyć dodatkowe podkatalogi zawierające dodatkowe pliki.

  4. Otwórz wiersz polecenia zestawu Windows SDK lub programu Visual Studio i przejdź do podkatalogu wersji.

  5. Utwórz manifest aplikacji z wywołaniem Mage.exe. Poniższa instrukcja tworzy manifest aplikacji dla kodu skompilowanego do uruchomienia na procesorze Intel x86.

    mage -New Application -Processor x86 -ToFile AppToDeploy.exe.manifest -name "My App" -Version 1.0.0.0 -FromDirectory .
    

    Uwaga

    Pamiętaj o dołączeniu kropki (.) po -FromDirectory opcji, która wskazuje bieżący katalog. Jeśli nie dołączysz kropki, musisz określić ścieżkę do plików aplikacji.

  6. Podpisz manifest aplikacji przy użyciu certyfikatu Authenticode. Zastąp plik mycert.pfx ścieżką do pliku certyfikatu. Zastąp element passwd hasłem dla pliku certyfikatu.

    mage -Sign AppToDeploy.exe.manifest -CertFile mycert.pfx -Password passwd
    

    Począwszy od zestawu .NET Framework 4.6.2 SDK, który jest dystrybuowany za pomocą programu Visual Studio i zestawu Windows SDK, mage.exe podpisuje manifesty za pomocą języka CNG, a także certyfikaty Authenticode. Użyj tych samych parametrów wiersza polecenia co w przypadku certyfikatów Authenticode.

  7. Przejdź do katalogu głównego katalogu wdrożenia.

  8. Wygeneruj manifest wdrożenia za pomocą wywołania Mage.exe. Domyślnie Mage.exe oznaczy wdrożenie ClickOnce jako zainstalowaną aplikację, aby można było uruchamiać je zarówno w trybie online, jak i w trybie offline. Aby udostępnić aplikację tylko wtedy, gdy użytkownik jest w trybie online, użyj -Install opcji z wartością false. Jeśli używasz wartości domyślnej, a użytkownicy zainstalują aplikację z witryny sieci Web lub udziału plików, upewnij się, że wartość -ProviderUrl opcji wskazuje lokalizację manifestu aplikacji na serwerze sieci Web lub udziale.

    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
    
  9. Podpisz manifest wdrożenia przy użyciu certyfikatu Authenticode lub CNG.

    mage -Sign AppToDeploy.application -CertFile mycert.pfx -Password passwd
    
  10. Skopiuj wszystkie pliki w katalogu wdrożenia do miejsca docelowego wdrożenia lub nośnika. Może to być folder w witrynie sieci Web lub witrynie FTP, udziale plików lub cd-ROM.

  11. Podaj użytkownikom adres URL, UNC lub nośnik fizyczny wymagany do zainstalowania aplikacji. Jeśli podasz adres URL lub UNC, musisz przyznać użytkownikom pełną ścieżkę do manifestu wdrożenia. Jeśli na przykład aplikacja AppToDeploy zostanie wdrożona http://webserver01/ w katalogu AppToDeploy, pełna ścieżka adresu URL będzie następująca: http://webserver01/AppToDeploy/AppToDeploy.application.

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

  1. Utwórz katalog, w którym będą przechowywane pliki wdrożenia Technologii ClickOnce.

  2. W właśnie utworzonym katalogu wdrożenia utwórz podkatalog wersji. Jeśli po raz pierwszy wdrażasz aplikację, nadaj nazwę podkatalogowi wersji 1.0.0.0.

    Uwaga

    Wersja wdrożenia jest prawdopodobnie różna od wersji aplikacji.

  3. Skopiuj wszystkie pliki aplikacji do podkatalogu wersji, w tym pliki wykonywalne, zestawy, zasoby i pliki danych. W razie potrzeby możesz utworzyć dodatkowe podkatalogi zawierające dodatkowe pliki.

  4. Uruchom narzędzie graficzneMageUI.exe .

    MageUI.exe
    
  5. Utwórz nowy manifest aplikacji, wybierając pozycję Plik, Nowy, Manifest aplikacji z menu.

  6. Na domyślnej karcie Nazwa wpisz nazwę i numer wersji tego wdrożenia. Określ również procesor , dla którego utworzono aplikację, na przykład x86.

  7. Wybierz kartę Pliki , a następnie wybierz przycisk wielokropka (...) obok pola tekstowego Katalog aplikacji . Zostanie wyświetlone okno dialogowe Przeglądaj dla folderu .

  8. Wybierz podkatalog wersji zawierający pliki aplikacji, a następnie wybierz przycisk OK.

  9. Jeśli wdrożysz z usług Internet Information Services (IIS), zaznacz pole wyboru Podczas wypełniania dodaj rozszerzenie .deploy do dowolnego pliku, który nie ma go .

  10. Przejdź do przycisku Wypełnij , aby dodać wszystkie pliki aplikacji do listy plików. Jeśli aplikacja zawiera więcej niż jeden plik wykonywalny, oznacz główny plik wykonywalny dla tego wdrożenia jako aplikację startową, wybierając pozycję Punkt wejścia z listy rozwijanej Typ pliku . (Jeśli aplikacja zawiera tylko jeden plik wykonywalny, MageUI.exe oznaczy go za Ciebie).

  11. Wybierz kartę Wymagane uprawnienia i wybierz poziom zaufania potrzebny aplikacji do potwierdzenia. Wartość domyślna to FullTrust, która będzie odpowiednia dla większości aplikacji.

  12. Wybierz pozycję Plik, Zapisz jako z menu. Zostanie wyświetlone okno dialogowe Opcje podpisywania z monitem o podpisanie manifestu aplikacji.

  13. Jeśli masz certyfikat przechowywany jako plik w systemie plików, użyj opcji Podpisz z plikiem certyfikatu i wybierz certyfikat z systemu plików przy użyciu przycisku wielokropka (...). Następnie wpisz hasło certyfikatu.

    -lub-

    Jeśli certyfikat jest przechowywany w magazynie certyfikatów dostępnym z komputera, wybierz opcję Podpisz z przechowywanym certyfikatem i wybierz certyfikat z podanej listy.

  14. Wybierz przycisk OK , aby podpisać manifest aplikacji. Zostanie wyświetlone okno dialogowe Zapisz jako .

  15. W oknie dialogowym Zapisz jako określ katalog wersji, a następnie wybierz pozycję Zapisz.

  16. Wybierz pozycję Plik, Nowy, Manifest wdrożenia z menu, aby utworzyć manifest wdrożenia.

  17. Na karcie Nazwa określ nazwę i numer wersji dla tego wdrożenia (w tym przykładzie 1.0.0.0 ). Określ również procesor , dla którego utworzono aplikację, na przykład x86.

  18. Wybierz kartę Opis i określ wartości wydawcy i produktu. (Produkt to nazwa nadana aplikacji w menu Start systemu Windows po zainstalowaniu aplikacji na komputerze klienckim do użytku w trybie offline).

  19. Wybierz kartę Opcje wdrażania , a następnie w polu tekstowym Lokalizacja początkowa określ lokalizację manifestu aplikacji na serwerze sieci Web lub udziale. Na przykład \\myServer\myShare\AppToDeploy.application.

  20. Jeśli rozszerzenie .deploy zostało dodane w poprzednim kroku, wybierz również pozycję Użyj rozszerzenia nazwy pliku wdróż tutaj.

  21. Wybierz kartę Opcje aktualizacji i określ częstotliwość aktualizacji tej aplikacji. Jeśli aplikacja używa UpdateCheckInfo funkcji do sprawdzania dostępności aktualizacji, wyczyść pole wyboru Ta aplikacja powinna zaznaczyć pole wyboru Aktualizacje.

  22. Wybierz kartę Dokumentacja aplikacji , a następnie przejdź do przycisku Wybierz manifest . Zostanie wyświetlone otwarte okno dialogowe.

  23. Wybierz utworzony wcześniej manifest aplikacji, a następnie wybierz pozycję Otwórz.

  24. Wybierz pozycję Plik, Zapisz jako z menu. Zostanie wyświetlone okno dialogowe Opcje podpisywania z monitem o podpisanie manifestu wdrożenia.

  25. Jeśli masz certyfikat przechowywany jako plik w systemie plików, użyj opcji Podpisz z plikiem certyfikatu i wybierz certyfikat z systemu plików przy użyciu przycisku wielokropka (...). Następnie wpisz hasło certyfikatu.

    -lub-

    Jeśli certyfikat jest przechowywany w magazynie certyfikatów dostępnym z komputera, wybierz opcję Podpisz z przechowywanym certyfikatem i wybierz certyfikat z podanej listy.

  26. Przejdź do pozycji OK , aby podpisać manifest wdrożenia. Zostanie wyświetlone okno dialogowe Zapisz jako .

  27. W oknie dialogowym Zapisz jako przenieś w górę jeden katalog do katalogu głównego wdrożenia, a następnie wybierz pozycję Zapisz.

  28. Skopiuj wszystkie pliki w katalogu wdrożenia do miejsca docelowego wdrożenia lub nośnika. Może to być folder w witrynie sieci Web lub witrynie FTP, udziale plików lub cd-ROM.

  29. Podaj użytkownikom adres URL, UNC lub nośnik fizyczny wymagany do zainstalowania aplikacji. Jeśli podasz adres URL lub UNC, musisz przyznać użytkownikom pełną ścieżkę manifestu wdrożenia. Jeśli na przykład aplikacja AppToDeploy zostanie wdrożona http://webserver01/ w katalogu AppToDeploy, pełna ścieżka adresu URL będzie następująca: http://webserver01/AppToDeploy/AppToDeploy.application.

Następne kroki

Gdy musisz wdrożyć nową wersję aplikacji, utwórz nowy katalog o nazwie po nowej wersji — na przykład 1.0.0.1 — i skopiuj nowe pliki aplikacji do nowego katalogu. Następnie należy wykonać poprzednie kroki, aby utworzyć i podpisać nowy manifest aplikacji oraz zaktualizować i podpisać manifest wdrożenia. Należy zachować ostrożność, aby określić tę samą wyższą wersję zarówno w Mage.exe-New , jak i -Update wywołania, ponieważ funkcja ClickOnce aktualizuje tylko wyższe wersje, z najbardziej znaczącą liczbą całkowitą po lewej stronie. Jeśli użyto MageUI.exe, możesz zaktualizować manifest wdrożenia, otwierając go, wybierając kartę Dokumentacja aplikacji , przejdź do przycisku Wybierz manifest , a następnie wybierz zaktualizowany manifest aplikacji.

Zobacz też