Budowanie aplikacji ClickOnce z wiersza polecenia

W Visual Studio, można tworzyć projektów z wiersza polecenia, nawet jeśli są one tworzone w zintegrowane środowisko programistyczne (IDE).W rzeczywistości można odbudować projektu utworzonych za pomocą Visual Studio na innym komputerze, który ma tylko .NET Framework zainstalowane.Pozwala to na kompilacji przy użyciu automatycznego procesu reprodukcji, na przykład w centralnej kompilacji lab lub przy użyciu zaawansowanych skryptów technik poza zakres budowania sam projekt.

Za pomocą programu MSBuild do odtworzenia wdrożeń aplikacji ClickOnce

Podczas wywoływania /target:publish msbuild w wierszu polecenia nakazuje systemowi MSBuild do budowania projektu i utworzyć ClickOnce aplikacji w folderze publikowania.Jest to równoważne z wybraniem Publikuj polecenia w IDE.

To polecenie wykonuje msbuild.exe, który znajduje się na ścieżce w środowisku Visual Studio w wierszu polecenia.

"Miejsce docelowe" jest wskaźnik MSBuild o sposobach przetwarzania polecenia.Główne cele są docelowych "build" i "Publikuj" docelowych.Cel kompilacji jest równoważne do zaznaczania budowanie polecenia (lub naciskając F5) w IDE.Jeśli chcesz zbudować projektu, można osiągnąć, wpisując msbuild.To polecenie działa, ponieważ docelowy kompilacji jest docelowych domyślne dla wszystkich projektów, generowane przez Visual Studio.Oznacza to, że nie jawnie trzeba określić lokalizację docelową kompilacji.W związku z tym, wpisując msbuild jest tej samej operacji, jak po wpisaniu msbuild /target:build.

/Target:publish polecenie nakazuje MSBuild wywoływanie docelowe publikowania.Docelowe publikowania zależy od docelowego kompilacji.Oznacza to, że operacja publikowania jest nadzbiór operacji budowania.Na przykład jeśli wprowadzono zmiany do jednego z plików źródłowych języka Visual Basic lub języka C# odpowiedniego zestawu będzie automatycznie zrekonstruować za Operacja publikowania.

Aby uzyskać informacje dotyczące generowania pełne ClickOnce wdrażania przy użyciu narzędzia wiersza polecenia Mage.exe, aby utworzyć użytkownika ClickOnce manifestu, zobacz Instruktaż: Ręcznie wdrażanie aplikacji ClickOnce.

Tworzenie i budowania podstawowych aplikacji ClickOnce przy użyciu programu MSBuild

Tworzenie i publikowanie projektu ClickOnce

  1. Kliknij przycisk Nowy projekt z pliku menu.Nowy projekt pojawi się okno dialogowe.

  2. Wybierz Aplikacji Windows i nadaj mu nazwę CmdLineDemo.

  3. Z budować menu, kliknij przycisk Publikuj polecenia.

    Ten krok gwarantuje, że projekt jest poprawnie skonfigurowany do produkcji ClickOnce wdrażanie aplikacji.

    Pojawi się Kreator publikowania.

  4. W Kreatorze publikowania kliknij Zakończenie.

    Visual Studio generuje i wyświetla domyślną stronę sieci Web o nazwie Publish.htm.

  5. Zapisz swój projekt, a następnie zanotuj lokalizację folderu, w którym jest przechowywany.

Powyższe kroki tworzenia ClickOnce projektu, który został opublikowany po raz pierwszy.Teraz można odtworzyć kompilacji poza IDE.

Aby odtworzyć kompilacji z wiersza polecenia

  1. Exit Visual Studio.

  2. Z systemu Windows uruchomić menu, kliknij przycisk Wszystkie programy, następnie Programu Microsoft Visual Studio, następnie Visual Studio Tools, następnie wiersza polecenia usługi programu Visual Studio.Powinno to otwórz wiersz polecenia w folderze głównym bieżącego użytkownika.

  3. W wiersza polecenia usługi programu Visual Studio, zmień bieżący katalog do lokalizacji projektu, po prostu zbudowany powyżej.Na przykład wpisz chdir Moje Documents\Visual Studio\Projects\CmdLineDemo.

  4. Aby usunąć istniejące pliki, wyprodukowanych w "Tworzenie I publikowanie ClickOnce projektu," typ opublikować rmdir /s.

    Ten krok jest opcjonalny, ale daje pewność, że nowe pliki były wszystkie produkowane przez build wiersza polecenia.

  5. Typ msbuild/target: publikowanie.

Powyższe kroki da pełne ClickOnce wdrażanie aplikacji w podfolderze projektu o nazwie publikuj.Jest CmdLineDemo.application ClickOnce wdrażania manifestu.Folder CmdLineDemo_1.0.0.0 zawiera pliki CmdLineDemo.exe i CmdLineDemo.exe.manifest, ClickOnce manifest aplikacji.Program Setup.exe jest program inicjujący, który domyślnie jest skonfigurowana do instalowania .NET Framework.DotNetFX folder zawiera redistributables dla .NET Framework.Jest to cały zbiór plików, należy wdrożyć aplikację za pośrednictwem sieci Web lub za pośrednictwem UNC lub dysk CD i DVD.

Właściwości publikacji

Podczas publikowania aplikacji w powyższych procedur, następujące właściwości są wstawiane do pliku projektu za pomocą Kreatora publikowania.Właściwości te mają bezpośredni wpływ jak ClickOnce aplikacji jest produkowany.

W CmdLineDemo.vbproj / CmdLineDemo.csproj:

<AssemblyOriginatorKeyFile>WindowsApplication3.snk</AssemblyOriginatorKeyFile>
<GenerateManifests>true</GenerateManifests>
<TargetZone>LocalIntranet</TargetZone>
<PublisherName>Microsoft</PublisherName>
<ProductName>CmdLineDemo</ProductName>
<PublishUrl>https://localhost/CmdLineDemo</PublishUrl>
<Install>true</Install>
<ApplicationVersion>1.0.0.*</ApplicationVersion>
<ApplicationRevision>1</ApplicationRevision>
<UpdateEnabled>true</UpdateEnabled>
<UpdateRequired>false</UpdateRequired>
<UpdateMode>Foreground</UpdateMode>
<UpdateInterval>7</UpdateInterval>
<UpdateIntervalUnits>Days</UpdateIntervalUnits>
<UpdateUrlEnabled>false</UpdateUrlEnabled>
<IsWebBootstrapper>true</IsWebBootstrapper>
<BootstrapperEnabled>true</BootstrapperEnabled>

Można zastąpić żadnej z tych właściwości w wierszu polecenia bez zmieniania w samym pliku projektu.Na przykład, następujące czynności zbuduje ClickOnce wdrażanie aplikacji bez program inicjujący:

msbuild /target:publish /property:BootstrapperEnabled=false

Właściwości publikacji są kontrolowane w Visual Studio z Publikuj, zabezpieczeń, i Podpisywanie stron właściwości Project Designer.Poniżej przedstawiono opis właściwości publikacji, wraz ze wskazaniem, jak każdy jest ustawiana na różnych stronach właściwości projektanta aplikacji:

  • AssemblyOriginatorKeyFileOkreśla plik klucza, używany do podpisywania your ClickOnce manifesty aplikacji.Tego samego klucza może również przypisać silnej nazwy użytkownika zestawów.Ta właściwość jest ustawiona na Podpisywanie stronę Project Designer.

Następujące właściwości są ustawiane na zabezpieczeń stronę:

  • Włącz ustawienia zabezpieczeń ClickOnce Określa, czy ClickOnce manifesty są generowane.Podczas tworzenia projektu, ClickOnce generacji manifestu jest domyślnie wyłączona.Kreator automatycznie włączy się tej flagi na po opublikowaniu po raz pierwszy.

  • TargetZone określa poziom zaufania do emitowane na ClickOnce manifest aplikacji.Możliwe wartości to "Internet", "LocalIntranet" i "Niestandardowy".Internet i LocalIntranet spowoduje, że uprawnienia domyślne do emitowane na ClickOnce manifest aplikacji.LocalIntranet jest wartością domyślną, i zasadniczo oznacza to pełne zaufanie.Niestandardowy określa tylko uprawnienia zostały jawnie określone w pliku app.manifest podstawowych mają być emitowane w ClickOnce manifest aplikacji.Plik app.manifest jest częściowe pliku manifestu, który zawiera tylko definicje informacje zaufania.Jest plikiem ukrytym, automatycznie dodane do projektu, podczas konfigurowania uprawnień na zabezpieczeń strony.

Następujące właściwości są ustawiane na Publikuj stronę:

  • PublishUrljest to lokalizacja, gdzie aplikacja będzie opublikowany w IDE.Dodaje się do ClickOnce manifest aplikacji, jeśli ani InstallUrl lub UpdateUrl właściwość została określona.

  • ApplicationVersionOkreśla wersję ClickOnce aplikacji.Jest to numer czterocyfrowy wersji.Jeśli ostatnia cyfra jest "*", a następnie ApplicationRevision , jest podstawiany za wartość wstawiony manifest w czasie kompilacji.

  • ApplicationRevisionOkreśla rewizji.Jest to liczba całkowita, która zwiększa każdorazowo publikować w IDE.Należy zauważyć, że nie jest automatycznie zwiększana dla buduje wykonanych w wierszu polecenia.

  • InstallOkreśla, czy aplikacja jest zainstalowanej aplikacji lub aplikacji Uruchamianie z sieci Web.

  • InstallUrl(nie wyświetlany) jest lokalizacja, w których użytkownicy będą instalować aplikacji z.Jeśli określony, wartość ta jest wypalony na program inicjujący setup.exe, jeśli IsWebBootstrapper właściwość jest włączona.Również zostanie wstawiony jeżeli manifest aplikacji UpdateUrl nie jest określony.

  • SupportUrl(nie wyświetlany) lokalizacji połączony jest w Dodaj lub usuń programy okno dialogowe dla zainstalowanej aplikacji.

Następujące właściwości są ustawiane Aktualizacji aplikacji okno dialogowe, dostępnym z Publikuj strony.

  • UpdateEnabledWskazuje, czy aplikacja powinna Sprawdź aktualizacje.

  • UpdateModeOkreśla pierwszego planu aktualizacje lub aktualizacje w tle.

  • UpdateIntervalOkreśla, jak często aplikacji należy sprawdzić aktualizacje.

  • UpdateIntervalUnitsOkreśla, czy UpdateInterval wartość jest wyrażona w jednostkach, godzin, dni lub tygodni.

  • UpdateUrl(nie wyświetlany) jest lokalizacja, z której aplikacja będzie otrzymywać aktualizacje.Jeśli określony, wartość ta jest wstawiany do manifest aplikacji.

  • Następujące właściwości są ustawiane Opcje publikowania okno dialogowe, dostępnym z Publikuj strony.

  • PublisherNameOkreśla nazwę wydawcy, wyświetlane w wierszu polecenia wyświetlane podczas instalowania lub uruchamiania aplikacji.W przypadku stosowania zainstalowany, również służy do należy określić nazwę folderu na uruchomić menu.

  • ProductNameOkreśla nazwę produktu, wyświetlane w wierszu polecenia wyświetlane podczas instalowania lub uruchamiania aplikacji.Z zainstalowaną aplikację, również służy do określenia nazwy skrótu na uruchomić menu.

  • Następujące właściwości są ustawiane Warunki wstępne okno dialogowe, dostępnym z Publikuj strony.

  • BootstrapperEnabledOkreśla, czy do generowania pliku setup.exe program inicjujący.

  • IsWebBootstrapperOkreśla, czy program inicjujący setup.exe działa w sieci Web lub w trybie opartej na dysku.

InstallURL, SupportUrl, PublishURL i UpdateURL

W poniższej tabeli przedstawiono cztery opcje wdrażania ClickOnce adresu URL.

Adres URL, opcja

Opis

PublishURL

Wymagane w przypadku publikowania aplikacji ClickOnce do witryny sieci Web.

InstallURL

Opcjonalne.Ustaw tę opcję adres URL, jeśli witryna instalacji jest inny niż PublishURL.Na przykład, można ustawić PublishURL ścieżka FTP i zestaw InstallURL do adresu URL w sieci Web.

SupportURL

Opcjonalne.Ustaw tę opcję adres URL, jeśli witryna pomocy technicznej jest inny niż PublishURL.Na przykład, można ustawić SupportURL do witryny sieci Web obsługi klienta firmy.

UpdateURL

Opcjonalne.Ustaw tę opcję adres URL, jeśli lokalizacja aktualizacji jest inna niż InstallURL.Na przykład, można ustawić PublishURL ścieżka FTP i zestaw UpdateURL do adresu URL w sieci Web.

Zobacz też

Zadania

Instruktaż: Ręcznie wdrażanie aplikacji ClickOnce

Informacje

GenerateBootstrapper

GenerateApplicationManifest

GenerateDeploymentManifest

Koncepcje

ClickOnce zabezpieczeń i wdrażania