Określanie właściwości publikowania ClickOnce

Właściwości Publish ClickOnce można skonfigurować na stronie Publikowanie w Projektancie projektów lub za pomocą Kreatora publikowania. Z tego artykułu dowiesz się, jak określić właściwości, takie jak lokalizacja publikowania, adres URL instalacji, tryb instalacji w trybie online lub offline oraz wersja publikowania.

Uwaga

W technologii ClickOnce dla platformy .NET Core 3.1 i .NET 5 lub nowszej można ustawić właściwości wdrożenia przy użyciu narzędzia Publikuj zamiast kreatora Publikowanie i strony Publikowanie w Projektancie projektów. Aby uzyskać więcej informacji, zobacz Deploy a .NET Windows application using ClickOnce and ClickOnce for .NET (Wdrażanie aplikacji .NET przy użyciu technologii ClickOnce i ClickOnce dla platformy .NET).

Określanie lokalizacji publikowania

Podczas publikowania aplikacji przy użyciu technologii ClickOnce Publish Location właściwość określa lokalizację, w której są umieszczane pliki aplikacji i manifest. Może to być ścieżka pliku lub ścieżka do serwera FTP.

Właściwość można określić Publish Location na stronie Publikowanie projektanta projektu lub za pomocą Kreatora publikowania. Aby uzyskać więcej informacji, zobacz How to: Publish a ClickOnce Application using the Publish Wizard (Instrukcje: publikowanie aplikacji ClickOnce przy użyciu Kreatora publikowania).

Uwaga

Po zainstalowaniu więcej niż jednej wersji aplikacji przy użyciu technologii ClickOnce instalacja przenosi wcześniejsze wersje aplikacji do folderu o nazwie Archive w określonej lokalizacji publikowania. Archiwizowanie wcześniejszych wersji w ten sposób powoduje usunięcie katalogu instalacyjnego folderów z wcześniejszej wersji.

1. Po wybraniu projektu w Eksplorator rozwiązań w menu Projekt kliknij pozycję Właściwości.

2. Kliknij kartę Publikuj .

3. W polu Lokalizacja publikowania wprowadź lokalizację publikowania przy użyciu jednego z następujących formatów:

   • Aby opublikować udział plików lub ścieżkę dysku, wprowadź ścieżkę przy użyciu ścieżki UNC (\\Server\ApplicationName) lub ścieżki pliku (C:\Deploy\ApplicationName).

   • Aby opublikować na serwerze FTP, wprowadź ścieżkę przy użyciu formatu ftp://ftp.microsoft.com/ ApplicationName>.<

     Należy pamiętać, że tekst musi być obecny w polu Lokalizacja publikowania, aby przycisk Przeglądaj (...) działał.

Określanie lokalizacji, z której użytkownicy końcowi będą przeprowadzać instalacje

Podczas publikowania aplikacji ClickOnce lokalizacja, w której użytkownicy przechodzą do pobrania i instalowania aplikacji, nie musi być lokalizacją, w której początkowo publikujesz aplikację. Na przykład w niektórych organizacjach deweloper może opublikować aplikację na serwerze przejściowym, a następnie administrator przeniesie aplikację na serwer sieci Web.

W takim przypadku można użyć Installation URL właściwości , aby określić serwer sieci Web, na którym użytkownicy będą pobierać aplikację. Jest to konieczne, aby manifest aplikacji wiedział, gdzie szukać aktualizacji.

Właściwość Installation URL można ustawić na stronie Publikowanie w Projektancie projektów.

Uwaga

Właściwość Installation URL można również ustawić przy użyciu biblioteki PublishWizard. Aby uzyskać więcej informacji, zobacz How to: Publish a ClickOnce application using the Publish Wizard (Instrukcje: publikowanie aplikacji ClickOnce przy użyciu Kreatora publikowania).

Określanie adresu URL instalacji

1. Po wybraniu projektu w Eksplorator rozwiązań w menu Projekt kliknij pozycję Właściwości.

2. Kliknij kartę Publikuj .

3. W polu Adres URL instalacji wprowadź lokalizację instalacji przy użyciu w pełni kwalifikowanego adresu URL przy użyciu formatu https://www.contoso.com/ApplicationNamelub ścieżki UNC w formacie \Server\ApplicationName.

Określanie trybu instalacji offline lub online w ramach technologii ClickOnce

Element Install Mode dla aplikacji ClickOnce określa, czy aplikacja będzie dostępna w trybie offline, czy w trybie online. Po wybraniu opcji Aplikacja jest dostępna tylko w trybie online, użytkownik musi mieć dostęp do lokalizacji publikowania ClickOnce (strony sieci Web lub udziału plików), aby można było uruchomić aplikację. Po wybraniu opcji Aplikacja jest również dostępna w trybie offline, aplikacja dodaje wpisy do menu Start i okno dialogowe Dodawanie lub usuwanie programów ; użytkownik może uruchomić aplikację, gdy nie są połączone.

Element Install Mode można ustawić na stronie Publikowanie w projektancie projektów.

Uwaga

Można Install Mode go również ustawić za pomocą kreatora publikowania. Aby uzyskać więcej informacji, zobacz How to: Publish a ClickOnce application using the Publish Wizard (Instrukcje: publikowanie aplikacji ClickOnce przy użyciu Kreatora publikowania).

Udostępnianie tylko aplikacji ClickOnce w trybie online

1. Po wybraniu projektu w Eksplorator rozwiązań w menu Projekt kliknij pozycję Właściwości.

2. Kliknij kartę Publikuj .

3. W obszarze Tryb instalacji i ustawienia kliknij przycisk Aplikacja jest dostępna tylko w trybie online.

Udostępnianie aplikacji ClickOnce w trybie online lub offline

1. Po wybraniu projektu w Eksplorator rozwiązań w menu Projekt kliknij pozycję Właściwości.

2. Kliknij kartę Publikuj .

3. W obszarze Tryb instalacji i ustawienia kliknij przycisk Aplikacja jest dostępna w trybie offline.

   Po zainstalowaniu aplikacja dodaje wpisy do menu Start i dodaj lub usuń programy w Panel sterowania.

Ustawianie wersji publikacji technologii ClickOnce

Właściwość ClickOnce Publish Version określa, czy publikowana aplikacja będzie traktowana jako aktualizacja. Za każdym razem, gdy wersja jest zwiększana, aplikacja zostanie opublikowana jako aktualizacja.

Właściwość Publish Version można ustawić na stronie Publikowanie w Projektancie projektów.

Uwaga

Istnieje opcja projektu, która automatycznie zwiększa Publish Version właściwość za każdym razem, gdy aplikacja zostanie opublikowana. Ta opcja jest domyślnie włączona. Aby uzyskać więcej informacji, zobacz Automatyczne zwiększanie wersji publikowania Technologii ClickOnce.

Zmienianie wersji publikowania

1. Po wybraniu projektu w Eksplorator rozwiązań w menu Projekt kliknij pozycję Właściwości.

2. Kliknij kartę Publikuj .

3. W polu Publikuj wersję zwiększ numery wersji głównej, pomocniczej, kompilacji lub poprawki .

   Uwaga

   Nigdy nie należy dekrementować numeru wersji; może to spowodować nieprzewidywalne zachowanie aktualizacji.

Automatyczne zwiększanie wersji publikacji technologii ClickOnce

Podczas publikowania aplikacji ClickOnce zmiana Publish Version właściwości powoduje opublikowanie aplikacji jako aktualizacji. Domyślnie program Visual Studio automatycznie zwiększa Revision liczbę Publish Version za każdym razem, gdy publikujesz aplikację.

To zachowanie można wyłączyć na stronie Publikowanie w projektancie projektów.

Uwaga

Okna dialogowe i polecenia menu mogą się różnić od tych opisanych w Pomocy, w zależności od ustawień aktywnych lub wydania. Aby zmienić ustawienia, wybierz pozycję Importuj i eksportuj ustawienia w menu Narzędzia . Aby uzyskać więcej informacji, zobacz Resetowanie ustawień.

Wyłącz automatyczne zwiększanie wersji publikowania

1. Po wybraniu projektu w Eksplorator rozwiązań w menu Projekt kliknij pozycję Właściwości.

2. Kliknij kartę Publikuj .

3. W sekcji Publikowanie wersji wyczyść pole wyboru Automatycznie zwiększaj poprawkę z każdą wersją.

Określanie strony publikowania dla aplikacji ClickOnce

Podczas publikowania aplikacji ClickOnce domyślna strona sieci Web (publish.htm) jest generowana i publikowana wraz z aplikacją. Ta strona zawiera nazwę aplikacji, link do zainstalowania aplikacji i/lub wszelkich wymagań wstępnych oraz link do tematu Pomocy opisującego usługę ClickOnce. Właściwość Publish Page dla projektu umożliwia określenie nazwy strony sieci Web dla aplikacji ClickOnce.

Po określeniu strony publikowania przy następnym opublikowaniu zostanie ona skopiowana do lokalizacji publikowania; nie zostanie on zastąpiony, jeśli opublikujesz go ponownie. Jeśli chcesz dostosować wygląd strony, możesz to zrobić bez martwienia się o utratę zmian. Aby uzyskać więcej informacji, zobacz Dostosowywanie domyślnej strony sieci Web ClickOnce.

Właściwość Publikuj stronę można ustawić w oknie dialogowym Opcje publikowania dostępne w okienku Publikowanie w projektancie projektów.

Aby określić niestandardową stronę sieci Web dla aplikacji ClickOnce:

1. Po wybraniu projektu w Eksplorator rozwiązań w menu Projekt kliknij pozycję Właściwości.

2. Wybierz okienko Publikowanie.

3. Kliknij przycisk Opcje, aby otworzyć okno dialogowe Opcje publikowania.

4. Kliknij pozycję Wdrożenie.

5. W oknie dialogowym Opcje publikowania upewnij się, że pole wyboru Otwórz stronę internetową wdrażania po opublikowaniu jest zaznaczone (domyślnie powinno być zaznaczone).

6. W polu Strona internetowa Wdrażanie wprowadź nazwę strony sieci Web, a następnie kliknij przycisk OK.

Aby zapobiec uruchamianiu strony publikowania za każdym razem, gdy publikujesz:

1. Po wybraniu projektu w Eksplorator rozwiązań w menu Projekt kliknij pozycję Właściwości.

2. Wybierz okienko Publikowanie.

3. Kliknij przycisk Opcje, aby otworzyć okno dialogowe Opcje publikowania.

4. Kliknij pozycję Wdrożenie.

5. W oknie dialogowym Opcje publikowania wyczyść stronę internetową Otwórz wdrożenie po opublikowaniu.

Dostosowywanie domyślnej strony sieci Web dla aplikacji ClickOnce

Podczas publikowania aplikacji ClickOnce w sieci Web strona sieci Web jest automatycznie generowana i publikowana wraz z aplikacją. Strona domyślna zawiera nazwę aplikacji i linki do instalowania aplikacji, instalowania wymagań wstępnych lub uzyskiwania dostępu do pomocy w witrynie MSDN.

Uwaga

Rzeczywiste linki widoczne na stronie zależą od komputera, na którym jest przeglądana strona, oraz od wymagań wstępnych, które zostały włączone.

Domyślna nazwa strony sieci Web to Publish.htm. Możesz zmienić nazwę w projektancie projektów. Aby uzyskać więcej informacji, zobacz Określanie strony publikowania dla aplikacji ClickOnce.

Strona Publish.htm sieci Web jest publikowana tylko wtedy, gdy zostanie wykryta nowsza wersja.

Uwaga

Zmiany wprowadzone w ustawieniach publikowania nie będą miały wpływu na stronę Publish.htm z jednym wyjątkiem: w przypadku dodania lub usunięcia wymagań wstępnych po początkowym opublikowaniu lista wymagań wstępnych nie będzie już dokładna. Aby odzwierciedlić zmiany, musisz edytować tekst dla linku wymagań wstępnych.

Aby dostosować stronę publikowania w sieci Web:

1. Opublikuj aplikację ClickOnce w lokalizacji sieci Web. Aby uzyskać więcej informacji, zobacz How to: Publish a ClickOnce application using the Publish Wizard (Instrukcje: publikowanie aplikacji ClickOnce przy użyciu Kreatora publikowania).

2. Na serwerze sieci Web otwórz plik Publish.htm w programie Visual Web Designer lub innym edytorze HTML.

3. Dostosuj stronę zgodnie z potrzebami i zapisz ją.

4. Opcjonalny. Aby uniemożliwić programowi Visual Studio zastąpienie dostosowanej strony sieci Web publikowania, usuń zaznaczenie pola wyboru Automatycznie generuj stronę internetową wdrożenia po każdej publikacji w oknie dialogowym Opcje publikowania.

Określanie linku do pomocy technicznej

Podczas publikowania aplikacji ClickOnce właściwość Adres URL pomocy technicznej identyfikuje stronę sieci Web lub udział plików, w którym użytkownicy mogą uzyskać informacje o aplikacji. Ta właściwość jest opcjonalna; Jeśli zostanie podany, adres URL zostanie wyświetlony w wpisie aplikacji Dodaj lub Usuń programy okno dialogowe.

Właściwość Adres URL pomocy technicznej można ustawić na stronie Publikowanie w projektancie projektów.

Aby określić adres URL pomocy technicznej:

1. Po wybraniu projektu w Eksplorator rozwiązań w menu Projekt kliknij pozycję Właściwości.

2. Kliknij kartę Publikuj .

3. Kliknij przycisk Opcje, aby otworzyć okno dialogowe Opcje publikowania.

4. Kliknij pozycję Opis.

5. W polu Adres URL pomocy technicznej wprowadź w pełni kwalifikowaną ścieżkę do witryny sieci Web, strony sieci Web lub udziału UNC.

Określanie adresu URL pomocy technicznej dla poszczególnych wymagań wstępnych we wdrożeniu technologii ClickOnce

Wdrożenie ClickOnce może przetestować szereg wymagań wstępnych, które muszą być dostępne na komputerze klienckim, aby można było uruchomić aplikację ClickOnce. Te zależności obejmują wymaganą minimalną wersję programu .NET Framework, wersję systemu operacyjnego i wszystkie zestawy, które muszą być wstępnie zainstalowane w globalnej pamięci podręcznej zestawów (GAC). ClickOnce nie może jednak zainstalować żadnego z tych wymagań wstępnych; Jeśli nie znaleziono wymagań wstępnych, po prostu zatrzymuje instalację i wyświetla okno dialogowe z wyjaśnieniem, dlaczego instalacja nie powiodła się.

Istnieją dwie metody instalowania wymagań wstępnych. Można je zainstalować przy użyciu aplikacji programu inicjjącego. Alternatywnie można określić adres URL pomocy technicznej dla poszczególnych wymagań wstępnych, który jest wyświetlany użytkownikom w oknie dialogowym, jeśli nie znaleziono wymagań wstępnych. Strona, do którego odwołuje się ten adres URL, może zawierać linki do instrukcji dotyczących instalowania wymaganych wymagań wstępnych. Jeśli aplikacja nie określi adresu URL obsługi dla poszczególnych wymagań wstępnych, clickOnce wyświetla adres URL pomocy technicznej określony w manifeście wdrożenia dla aplikacji jako całości, jeśli jest zdefiniowany.

Chociaż program Visual Studio, Mage.exe i MageUI.exe mogą służyć do generowania wdrożeń technologii ClickOnce, żaden z tych narzędzi nie obsługuje bezpośrednio określenia adresu URL pomocy technicznej dla poszczególnych wymagań wstępnych. W tym dokumencie opisano sposób modyfikowania manifestu aplikacji i manifestu wdrożenia wdrożenia w celu uwzględnienia tych adresów URL obsługi.

Uwaga

W technologii ClickOnce dla platformy .NET Core 3.1 i .NET 5 lub nowszej można ustawić właściwości wdrożenia przy użyciu narzędzia Publikuj zamiast kreatora Publikowanie i strony Publikowanie w Projektancie projektów. Aby uzyskać więcej informacji, zobacz Deploy a .NET Windows application using ClickOnce and ClickOnce for .NET (Wdrażanie aplikacji .NET przy użyciu technologii ClickOnce i ClickOnce dla platformy .NET).

Określanie adresu URL pomocy technicznej dla poszczególnych wymagań wstępnych

1. Otwórz manifest aplikacji (plik manifestu) dla aplikacji ClickOnce w edytorze tekstów.

2. W przypadku wymagań wstępnych systemu operacyjnego dodaj supportUrl atrybut do dependentOS elementu :

    <dependency>
       <dependentOS supportUrl="http://www.adatum.com/MyApplication/wrongOSFound.htm">
         <osVersionInfo>
           <os majorVersion="5" minorVersion="1" buildNumber="2600" servicePackMajor="0" servicePackMinor="0" />
         </osVersionInfo>
       </dependentOS>
     </dependency>
   

3. Aby spełnić wymagania wstępne dotyczące określonej wersji środowiska uruchomieniowego języka wspólnego, dodaj supportUrl atrybut do dependentAssembly wpisu określającego zależność środowiska uruchomieniowego języka wspólnego:

     <dependency>
       <dependentAssembly dependencyType="preRequisite" allowDelayedBinding="true" supportUrl=" http://www.adatum.com/MyApplication/wrongClrVersionFound.htm">
         <assemblyIdentity name="Microsoft.Windows.CommonLanguageRuntime" version="4.0.30319.0" />
       </dependentAssembly>
     </dependency>
   

4. Aby spełnić wymagania wstępne dotyczące zestawu, który musi być wstępnie zainstalowany w globalnej pamięci podręcznej zestawów, ustaw supportUrl dla dependentAssembly elementu, który określa wymagany zestaw:

     <dependency>
       <dependentAssembly dependencyType="preRequisite" allowDelayedBinding="true" supportUrl=" http://www.adatum.com/MyApplication/missingSampleGACAssembly.htm">
         <assemblyIdentity name="SampleGACAssembly" version="5.0.0.0" publicKeyToken="04529dfb5da245c5" processorArchitecture="msil" language="neutral" />
       </dependentAssembly>
     </dependency>
   

5. Opcjonalny. W przypadku aplikacji przeznaczonych dla programu .NET Framework 4 otwórz manifest wdrożenia ( plik aplikacji ) dla aplikacji ClickOnce w edytorze tekstów.

6. W przypadku wymagań wstępnych programu .NET Framework 4 dodaj supportUrl atrybut do compatibleFrameworks elementu:

   <compatibleFrameworks  xmlns="urn:schemas-microsoft-com:clickonce.v2" supportUrl="http://adatum.com/MyApplication/CompatibleFrameworks.htm">
     <framework targetVersion="4.0" profile="Client" supportedRuntime="4.0.30319" />
     <framework targetVersion="4.0" profile="Full" supportedRuntime="4.0.30319" />
   </compatibleFrameworks>
   

7. Po ręcznym zmianie manifestu aplikacji należy ponownie podpisać manifest aplikacji przy użyciu certyfikatu cyfrowego, a następnie zaktualizować i ponownie podpisać manifest wdrożenia. Użyj narzędzi zestawu SDK Mage.exe lub MageUI.exe, aby wykonać to zadanie, ponieważ ponowne generowanie tych plików przy użyciu programu Visual Studio usuwa zmiany ręczne. Aby uzyskać więcej informacji na temat ponownego podpisywania manifestów przy użyciu Mage.exe, zobacz Instrukcje: ponowne podpisywanie manifestów aplikacji i wdrażania.

zabezpieczenia .NET Framework

Adres URL obsługi nie jest wyświetlany w oknie dialogowym, jeśli aplikacja jest oznaczona do uruchamiania w częściowym zaufaniu.

Zmienianie języka publikacji dla aplikacji ClickOnce

Podczas publikowania aplikacji ClickOnce interfejs użytkownika wyświetlany podczas instalacji jest domyślny dla języka i kultury komputera dewelopera. Jeśli publikujesz zlokalizowaną aplikację, musisz określić język i kulturę, aby dopasować ją do zlokalizowanej wersji. Jest to określane przez Publish language właściwość projektu.

Właściwość Publish language można ustawić w oknie dialogowym Opcje publikowania dostępne na stronie Publikowanie w Projektancie projektów.

Uwaga

Okna dialogowe i polecenia menu mogą się różnić od tych opisanych w Pomocy, w zależności od ustawień aktywnych lub wydania. Aby zmienić ustawienia, wybierz pozycję Importuj i eksportuj ustawienia w menu Narzędzia . Aby uzyskać więcej informacji, zobacz Resetowanie ustawień.

Aby zmienić język publikowania:

1. Po wybraniu projektu w Eksplorator rozwiązań w menu Projekt kliknij pozycję Właściwości.

2. Kliknij kartę Publikuj .

   Uwaga

   W technologii ClickOnce dla platformy .NET Core 3.1 i .NET 5 lub nowszej można ustawić właściwości wdrożenia przy użyciu narzędzia Publikuj zamiast kreatora Publikowanie i strony Publikowanie w Projektancie projektów. Aby uzyskać więcej informacji, zobacz Deploy a .NET Windows application using ClickOnce and ClickOnce for .NET (Wdrażanie aplikacji .NET przy użyciu technologii ClickOnce i ClickOnce dla platformy .NET).

3. Kliknij przycisk Opcje, aby otworzyć okno dialogowe Opcje publikowania.

4. Kliknij pozycję Opis.

5. W oknie dialogowym Opcje publikowania wybierz język i kulturę z listy rozwijanej Publikuj język, a następnie kliknij przycisk OK.

Określanie nazwy menu Start dla aplikacji ClickOnce

Po zainstalowaniu aplikacji ClickOnce zarówno w trybie online, jak i w trybie offline wpis zostanie dodany do menu Start i listy Dodaj lub Usuń programy . Domyślnie nazwa wyświetlana jest taka sama jak nazwa zestawu aplikacji, ale można zmienić nazwę wyświetlaną, ustawiając nazwę produktu w oknie dialogowym Opcje publikowania.

Nazwa produktu zostanie wyświetlona na stronie publish.htm . W przypadku zainstalowanej aplikacji w trybie offline będzie to nazwa wpisu w menu Start i będzie również nazwą wyświetlaną w obszarze Dodaj lub Usuń programy.

Nazwa wydawcy zostanie wyświetlona na stronie publish.htm powyżej nazwy produktu, a w przypadku zainstalowanej aplikacji offline będzie również nazwą folderu zawierającego ikonę aplikacji w menu Start .

Skrót lub odwołanie do aplikacji menu Start jest tworzone w folderze %appdata%\Microsoft\Windows\Start Menu\Programs\<publisher.> Odwołanie do skrótu lub aplikacji ma taką samą nazwę jak nazwa produktu.

Właściwości Nazwa produktu i Nazwa wydawcy można ustawić w oknie dialogowym Opcje publikowania dostępne na stronie Publikowanie projektanta projektów.

Aby określić nazwę menu Start:

1. Po wybraniu projektu w Eksplorator rozwiązań w menu Projekt kliknij pozycję Właściwości.

2. Kliknij kartę Publikuj .

3. Kliknij przycisk Opcje, aby otworzyć okno dialogowe Opcje publikowania.

4. Kliknij pozycję Opis.

5. W oknie dialogowym Opcje publikowania wprowadź nazwę do wyświetlenia w polu Nazwa produktu.

6. Opcjonalnie możesz wprowadzić nazwę wydawcy w polu Nazwa wydawcy.

Włączanie autostartu dla instalacji ciągłego wdrażania

Podczas wdrażania aplikacji ClickOnce za pomocą nośnika wymiennego, takiego jak CD-ROM lub DVD-ROM, można włączyć AutoStart , aby aplikacja ClickOnce została automatycznie uruchomiona po wstawieniu nośnika.

AutoStartmożna włączyć na stronie Publikowanie w projektancie projektów.

Aby włączyć autostart:

1. Po wybraniu projektu w Eksplorator rozwiązań w menu Projekt kliknij pozycję Właściwości.

2. Kliknij kartę Publikuj .

3. Kliknij przycisk Opcje.

   Zostanie wyświetlone okno dialogowe Opcje publikowania.

4. Kliknij pozycję Wdrożenie.

5. Zaznacz pole wyboru Dla instalacji ciągłego wdrażania, automatycznie uruchom instalatora po wstawieniu dysku CD.

   Plik Autorun.inf zostanie skopiowany do lokalizacji publikowania po opublikowaniu aplikacji.

Powiązana zawartość

• Publikowanie aplikacji ClickOnce
• Instrukcje: publikowanie aplikacji ClickOnce przy użyciu Kreatora publikowania