Tentukan properti Terbitkan ClickOnce

Anda bisa mengonfigurasi properti ClickOnce Publish pada halaman Terbitkan Project Designer, atau dengan menggunakan Wizard Terbitkan. Dalam artikel ini, Anda mempelajari cara menentukan properti seperti lokasi penerbitan, URL penginstalan, mode penginstalan online atau offline, dan versi penerbitan.

Catatan

Di ClickOnce untuk .NET Core 3.1 dan .NET 5 atau yang lebih baru, Anda mengatur properti penyebaran menggunakan alat Terbitkan alih-alih panduan Terbitkan dan halaman Terbitkan Desainer Proyek. Untuk informasi selengkapnya, lihat Menyebarkan aplikasi .NET Windows menggunakan ClickOnce dan ClickOnce untuk .NET.

Tentukan lokasi penerbitan

Saat Anda menerbitkan aplikasi dengan menggunakan ClickOnce, Publish Location properti menentukan lokasi tempat file aplikasi dan manifes diletakkan. Ini bisa berupa jalur file atau jalur ke server FTP.

Anda bisa menentukan Publish Location properti pada halaman Terbitkan Perancang Proyek, atau dengan menggunakan Wizard Terbitkan. Untuk informasi selengkapnya, lihat Cara: Menerbitkan Aplikasi ClickOnce menggunakan Wizard Terbitkan.

Catatan

Saat Anda menginstal lebih dari satu versi aplikasi menggunakan ClickOnce, penginstalan akan memindahkan versi aplikasi yang lebih lama ke dalam folder bernama Arsip, di lokasi penerbitan yang Anda tentukan. Pengarsipan versi sebelumnya dengan cara ini membuat direktori penginstalan tetap bersih dari folder dari versi sebelumnya.

1. Dengan proyek yang dipilih di Penjelajah Solusi, pada menu Proyek, klik Properti.

2. Klik tab Terbitkan.

3. Di bidang Terbitkan Lokasi, masukkan lokasi penerbitan dengan menggunakan salah satu format berikut:

   • Untuk menerbitkan ke berbagi file atau jalur disk, masukkan jalur dengan menggunakan jalur UNC (\\Server\ApplicationName) atau jalur file (C:\Deploy\ApplicationName).

   • Untuk menerbitkan ke server FTP, masukkan jalur menggunakan format ftp://ftp.microsoft.com/ ApplicationName>.<

     Perhatikan bahwa teks harus ada di kotak Lokasi Penerbitan agar tombol Telusuri (...) berfungsi.

Menentukan lokasi asal penginstalan pengguna akhir

Saat menerbitkan aplikasi ClickOnce, lokasi tempat pengguna mengunduh dan menginstal aplikasi belum tentu merupakan lokasi di mana Anda awalnya menerbitkan aplikasi. Misalnya, di beberapa organisasi, pengembang mungkin menerbitkan aplikasi ke server penahapan, lalu administrator akan memindahkan aplikasi ke server Web.

Dalam hal ini, Anda dapat menggunakan Installation URL properti untuk menentukan server Web tempat pengguna akan mengunduh aplikasi. Ini diperlukan agar manifes aplikasi tahu di mana mencari pembaruan.

Properti Installation URL dapat disetel pada laman Terbitkan dari Perancang Proyek .

Catatan

Properti Installation URL juga dapat diatur menggunakan PublishWizard. Untuk informasi selengkapnya, lihat Cara: Menerbitkan Aplikasi ClickOnce menggunakan Wizard Terbitkan

Tentukan URL Penginstalan

1. Dengan proyek yang dipilih di Penjelajah Solusi, pada menu Proyek, klik Properti.

2. Klik tab Terbitkan.

3. Di bidang URL Penginstalan, masukkan lokasi penginstalan menggunakan URL yang sepenuhnya memenuhi syarat menggunakan format https://www.contoso.com/ApplicationName, atau jalur UNC menggunakan format \Server\ApplicationName.

Menentukan mode penginstalan offline atau online ClickOnce

Install Mode untuk aplikasi ClickOnce menentukan apakah aplikasi akan tersedia secara offline atau online. Ketika Anda memilih Aplikasi hanya tersedia secara online, pengguna harus memiliki akses ke lokasi penerbitan ClickOnce (baik halaman Web atau berbagi file) untuk menjalankan aplikasi. Saat Anda memilih Aplikasi juga tersedia secara offline, aplikasi menambahkan entri ke menu Mulai dan kotak dialog Tambahkan atau Hapus Program ; pengguna dapat menjalankan aplikasi saat tidak tersambung.

Install Mode dapat diatur pada halaman TerbitkanPerancang Proyek.

Catatan

Install Mode juga dapat diatur menggunakan wizard Terbitkan. Untuk informasi selengkapnya, lihat Cara: Menerbitkan Aplikasi ClickOnce menggunakan Wizard Terbitkan

Membuat aplikasi ClickOnce hanya tersedia secara online

1. Dengan proyek yang dipilih di Penjelajah Solusi, pada menu Proyek, klik Properti.

2. Klik tab Terbitkan.

3. Di area Mode dan Pengaturan Penginstalan, klik tombol opsi Aplikasi hanya tersedia online.

Membuat aplikasi ClickOnce tersedia secara online atau offline

1. Dengan proyek yang dipilih di Penjelajah Solusi, pada menu Proyek, klik Properti.

2. Klik tab Terbitkan.

3. Di area Mode dan Pengaturan Penginstalan, klik tombol opsi Aplikasi tersedia offline serta.

   Ketika dipasang, aplikasi menambahkan entri ke menu Mulai dan untuk Menambahkan atau Menghapus Program di Panel Kontrol.

Mengatur versi penerbitan ClickOnce

Properti ClickOnce Publish Version menentukan apakah aplikasi yang Anda terbitkan akan diperlakukan sebagai pembaruan atau tidak. Setiap kali versi bertambah, aplikasi akan dipublikasikan sebagai pembaruan.

Properti Publish Version dapat disetel pada laman Terbitkan dari Perancang Proyek .

Catatan

Ada opsi proyek yang secara otomatis akan menambah properti Publish Version setiap kali aplikasi dipublikasikan; opsi ini diaktifkan secara default. Untuk informasi selengkapnya, lihat Secara Otomatis Meningkatkan Versi Penerbitan ClickOnce.

Mengubah versi penerbitan

1. Dengan proyek yang dipilih di Penjelajah Solusi, pada menu Proyek klik Properti.

2. Klik tab Terbitkan.

3. Di bidang Terbitkan Versi , tambahkan nomor versi Utama , Kecil , Bangun , atau Revisi .

   Catatan

   Anda tidak boleh mengurangi nomor versi; melakukannya dapat menyebabkan perilaku pembaruan yang tidak terduga.

Secara otomatis meningkatkan versi penerbitan ClickOnce

Saat menerbitkan aplikasi ClickOnce, mengubah Publish Version properti menyebabkan aplikasi diterbitkan sebagai pembaruan. Secara default, Visual Studio secara otomatis menaikkan Revision jumlah Publish Version setiap kali Anda menerbitkan aplikasi.

Anda dapat menonaktifkan perilaku ini di halaman Terbitkan Perancang Proyek.

Catatan

Kotak dialog dan perintah menu yang Anda lihat mungkin berbeda dari yang dijelaskan dalam Bantuan tergantung pada pengaturan atau edisi aktif Anda. Untuk mengubah pengaturan Anda, pilih Pengaturan Impor dan Ekspor pada menu Alat. Untuk mengetahui informasi selengkapnya, lihat Mengatur ulang dan menjalankan ulang.

Menonaktifkan peningkatan versi penerbitan secara otomatis

1. Dengan proyek yang dipilih di Penjelajah Solusi, pada menu Proyek, klik Properti.

2. Klik tab Terbitkan.

3. Di bagian Terbitkan Versi , kosongkan kotak centang Revisi kenaikan secara otomatis dengan setiap rilis .

Menentukan halaman penerbitan untuk aplikasi ClickOnce

Saat menerbitkan aplikasi ClickOnce ke Web, halaman Web secara default (publish.htm) dibuat dan diterbitkan bersama dengan aplikasi. Halaman ini berisi nama aplikasi, tautan untuk menginstal aplikasi dan/atau prasyarat apa pun, dan tautan ke topik Bantuan yang menjelaskan ClickOnce. Properti Terbitkan Halaman untuk proyek Anda memungkinkan Anda menentukan nama untuk halaman Web untuk aplikasi ClickOnce Anda.

Setelah halaman terbitkan ditentukan, saat berikutnya Anda menerbitkan, halaman tersebut akan disalin ke lokasi penerbitan; tidak akan ditimpa jika Anda menerbitkan lagi. Jika Anda ingin menyesuaikan tampilan halaman, Anda dapat melakukannya tanpa khawatir kehilangan perubahan Anda. Untuk informasi selengkapnya, lihat Mengkustomisasi halaman Web default ClickOnce.

Properti Terbitkan Halaman dapat diatur dalam kotak dialog Opsi Penerbitan, dapat diakses dari halaman Terbitkan dari Perancang Proyek.

Untuk menentukan halaman Web kustom untuk aplikasi ClickOnce:

1. Dengan proyek yang dipilih di Penjelajah Solusi, pada menu Proyek klik Properti.

2. Pilih panel Terbitkan.

3. Klik tombol Opsi untuk membuka kotak dialog Terbitkan Opsi.

4. Klik Penyebaran.

5. Dalam kotak dialog Opsi Terbitkan, pastikan bahwa kotak centang Buka halaman web penyebaran setelah penerbitan dipilih (harus dipilih secara default).

6. Dalam kotak Halaman web penyebaran, masukkan nama untuk halaman Web Anda, lalu klik OK.

Untuk mencegah halaman penerbitan diluncurkan setiap kali Anda menerbitkan:

1. Dengan proyek yang dipilih di Penjelajah Solusi, pada menu Proyek klik Properti.

2. Pilih panel Terbitkan.

3. Klik tombol Opsi untuk membuka kotak dialog Terbitkan Opsi.

4. Klik Penyebaran.

5. Dalam kotak dialog Opsi Terbitkan, kosongkan kotak centang Buka halaman web penyebaran setelah terbitkan.

Mengkustomisasi halaman Web default untuk aplikasi ClickOnce

Saat menerbitkan aplikasi ClickOnce ke Web, halaman Web secara otomatis dibuat dan diterbitkan bersama dengan aplikasi. Halaman default berisi nama aplikasi dan tautan untuk menginstal aplikasi, menginstal prasyarat, atau mengakses bantuan di MSDN.

Catatan

Tautan aktual yang Anda lihat di halaman bergantung pada komputer tempat halaman dilihat dan prasyarat apa yang Anda sertakan.

Nama default untuk halaman Web adalah Publish.htm; Anda dapat mengubah nama di Desainer Proyek. Untuk informasi selengkapnya, lihat Menentukan halaman penerbitan untuk aplikasi ClickOnce.

Halaman Web Publish.htm diterbitkan hanya jika versi yang lebih baru terdeteksi.

Catatan

Perubahan yang Anda buat pada pengaturan Terbitkan tidak akan memengaruhi halaman Publish.htm, dengan satu pengecualian: jika Anda menambahkan atau menghapus prasyarat setelah awalnya menerbitkan, daftar prasyarat tidak akan lagi akurat. Anda harus mengedit teks untuk tautan prasyarat untuk mencerminkan perubahan.

Untuk mengkustomisasi halaman terbitkan Web:

1. Terbitkan aplikasi ClickOnce Anda ke lokasi Web. Untuk informasi selengkapnya, lihat Cara: Menerbitkan Aplikasi ClickOnce menggunakan Wizard Terbitkan

2. Di server Web, buka file Publish.htm di Visual Web Designer atau editor HTML lainnya.

3. Sesuaikan halaman sesuai keinginan dan simpan.

4. Opsional. Untuk mencegah Visual Studio menimpa halaman Web terbitan yang dikustomisasi, hapus centang Buat halaman Web penyebaran secara otomatis setelah setiap penerbitan dalam kotak dialog Opsi Terbitkan.

Menentukan tautan untuk Dukungan Teknis

Saat menerbitkan aplikasi ClickOnce, properti URL Dukungan mengidentifikasi halaman Web atau berbagi file tempat pengguna bisa pergi untuk mendapatkan informasi tentang aplikasi. Properti ini bersifat opsional; jika disediakan, URL akan ditampilkan dalam kotak dialog Tambahkan atau Hapus Program entri aplikasi.

Properti URL Dukungan dapat diatur pada halaman TerbitkanProject Designer.

Untuk menentukan URL dukungan:

1. Dengan proyek yang dipilih di Penjelajah Solusi, pada menu Proyek, klik Properti.

2. Klik tab Terbitkan.

3. Klik tombol Opsi untuk membuka kotak dialog Terbitkan Opsi.

4. Klik Deskripsi.

5. Di bidang URL Dukungan, masukkan jalur yang sepenuhnya memenuhi syarat ke situs Web, halaman Web, atau berbagi UNC.

Menentukan URL dukungan untuk prasyarat individual dalam penyebaran ClickOnce

Penyebaran ClickOnce dapat menguji sejumlah prasyarat yang harus tersedia di komputer klien agar aplikasi ClickOnce bisa berjalan. Dependensi ini mencakup versi minimum .NET Framework yang diperlukan, versi sistem operasi, dan rakitan apa pun yang harus diinstal sebelumnya dalam cache rakitan global (GAC). Namun, ClickOnce tidak dapat menginstal prasyarat ini sendiri; jika prasyarat tidak ditemukan, prasyarat hanya menghentikan penginstalan dan menampilkan kotak dialog yang menjelaskan mengapa penginstalan gagal.

Ada dua metode untuk menginstal prasyarat. Anda dapat menginstalnya menggunakan aplikasi bootstrapper. Atau, Anda dapat menentukan URL dukungan untuk prasyarat individual, yang ditampilkan kepada pengguna pada kotak dialog jika prasyarat tidak ditemukan. Halaman yang direferensikan oleh URL tersebut dapat berisi tautan ke instruksi untuk menginstal prasyarat yang diperlukan. Jika aplikasi tidak menentukan URL dukungan untuk prasyarat individual, ClickOnce menampilkan URL dukungan yang ditentukan dalam manifes penyebaran untuk aplikasi secara keseluruhan, jika ditentukan.

Meskipun Visual Studio, Mage.exe, dan MageUI.exe semuanya dapat digunakan untuk menghasilkan penyebaran ClickOnce, tidak satu pun dari alat ini yang secara langsung mendukung penentuan URL dukungan untuk prasyarat individual. Dokumen ini menjelaskan cara mengubah manifes aplikasi penyebaran dan manifes penyebaran Anda untuk menyertakan URL dukungan ini.

Catatan

Di ClickOnce untuk .NET Core 3.1 dan .NET 5 atau yang lebih baru, Anda mengatur properti penyebaran menggunakan alat Terbitkan alih-alih panduan Terbitkan dan halaman Terbitkan Desainer Proyek. Untuk informasi selengkapnya, lihat Menyebarkan aplikasi .NET Windows menggunakan ClickOnce dan ClickOnce untuk .NET.

Tentukan URL dukungan untuk prasyarat individual

1. Buka manifes aplikasi (file .manifest) untuk aplikasi ClickOnce pada editor teks.

2. Untuk prasyarat sistem operasi, tambahkan atribut supportUrl ke elemen dependentOS:

    <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. Untuk prasyarat untuk versi tertentu dari runtime bahasa umum, tambahkan atribut supportUrl ke entri dependentAssembly yang menentukan dependensi runtime bahasa umum:

     <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. Untuk prasyarat rakitan yang harus diinstal sebelumnya dalam cache rakitan global, atur supportUrl untuk elemen dependentAssembly yang menentukan rakitan yang diperlukan:

     <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. Opsional. Untuk aplikasi yang menargetkan .NET Framework 4, buka manifes penyebaran (file .application) untuk aplikasi ClickOnce di editor teks.

6. Untuk prasyarat .NET Framework 4, tambahkan atribut supportUrl ke elemen compatibleFrameworks:

   <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. Setelah mengubah manifes aplikasi secara manual, Anda harus menandatangani ulang manifes aplikasi menggunakan sertifikat digital Anda, lalu memperbarui dan menandatangani ulang manifes penyebaran juga. Gunakan alat SDK Mage.exe atau MageUI.exe untuk menyelesaikan tugas ini, karena meregenerasi file-file ini menggunakan Visual Studio akan menghapus perubahan manual Anda. Untuk informasi selengkapnya tentang menggunakan Mage.exe untuk menandatangani ulang manifes, lihat Cara: Menandatangani Ulang Manifes Aplikasi dan Penyebaran.

.NET Framework Security

URL dukungan tidak ditampilkan pada kotak dialog jika aplikasi ditandai untuk berjalan dalam kepercayaan parsial.

Mengubah bahasa penerbitan untuk aplikasi ClickOnce

Saat menerbitkan aplikasi ClickOnce, antarmuka pengguna ditampilkan selama penginstalan default ke bahasa dan budaya komputer pengembangan Anda. Jika Anda menerbitkan aplikasi yang dilokalkan, Anda harus menentukan bahasa dan budaya agar sesuai dengan versi yang dilokalkan. Ini ditentukan oleh properti Publish language untuk proyek Anda.

Properti Publish language dapat diatur dalam kotak dialog Opsi Terbitkan, dapat diakses dari halaman TerbitkanPerancang Proyek.

Catatan

Kotak dialog dan perintah menu yang Anda lihat mungkin berbeda dari yang dijelaskan dalam Bantuan tergantung pada pengaturan atau edisi aktif Anda. Untuk mengubah pengaturan Anda, pilih Pengaturan Impor dan Ekspor pada menu Alat. Untuk mengetahui informasi selengkapnya, lihat Mengatur ulang dan menjalankan ulang.

Untuk mengubah bahasa penerbitan:

1. Dengan proyek yang dipilih di Penjelajah Solusi, pada menu Proyek, klik Properti.

2. Klik tab Terbitkan.

   Catatan

   Di ClickOnce untuk .NET Core 3.1 dan .NET 5 atau yang lebih baru, Anda mengatur properti penyebaran menggunakan alat Terbitkan alih-alih panduan Terbitkan dan halaman Terbitkan Desainer Proyek. Untuk informasi selengkapnya, lihat Menyebarkan aplikasi .NET Windows menggunakan ClickOnce dan ClickOnce untuk .NET.

3. Klik tombol Opsi untuk membuka kotak dialog Terbitkan Opsi.

4. Klik Deskripsi.

5. Dalam kotak dialog Opsi Terbitkan, pilih bahasa dan budaya dari daftar drop-down Terbitkan bahasa, lalu klik OK.

Menentukan nama menu Mulai untuk aplikasi ClickOnce

Saat aplikasi ClickOnce diinstal untuk penggunaan online dan offline, entri ditambahkan ke menu Mulai dan daftar Tambahkan atau Hapus Program . Secara default, nama tampilan sama dengan nama rakitan aplikasi, tetapi Anda dapat mengubah nama tampilan dengan mengatur Nama produk dalam kotak dialog Opsi Terbitkan.

Nama produk akan ditampilkan di halaman publish.htm ; untuk aplikasi offline yang diinstal, itu akan menjadi nama entri di menu Mulai , dan itu juga akan menjadi nama yang ditampilkan di Tambahkan atau Hapus Program.

Nama penerbit akan muncul di halaman publish.htm di atas Nama produk, dan untuk aplikasi offline yang diinstal, itu juga akan menjadi nama folder yang berisi ikon aplikasi di menu Mulai .

Pintasan menu Mulai atau referensi aplikasi dibuat di %appdata%\Microsoft\Windows\Start Menu\Programs\<publisher name>. Pintasan atau referensi aplikasi memiliki nama yang sama dengan nama produk.

Anda bisa mengatur properti Nama produk dan Nama penerbit dalam kotak dialog Opsi Terbitkan, tersedia di halaman Terbitkan Desainer Proyek.

Untuk menentukan nama menu Mulai:

1. Dengan proyek yang dipilih di Penjelajah Solusi, pada menu Proyek, klik Properti.

2. Klik tab Terbitkan.

3. Klik tombol Opsi untuk membuka kotak dialog Terbitkan Opsi.

4. Klik Deskripsi.

5. Dalam kotak dialog Opsi Terbitkan, masukkan nama yang akan ditampilkan di Nama produk.

6. Secara opsional, Anda bisa memasukkan nama penerbit di Nama penerbit.

Mengaktifkan Mulai Otomatis untuk penginstalan CD

Saat menyebarkan aplikasi ClickOnce melalui media yang dapat dilepas seperti CD-ROM atau DVD-ROM, Anda dapat mengaktifkan AutoStart sehingga aplikasi ClickOnce secara otomatis diluncurkan saat media dimasukkan.

AutoStart dapat diaktifkan pada halaman TerbitkanPerancang Proyek.

Untuk mengaktifkan Mulai Otomatis:

1. Dengan proyek yang dipilih di Penjelajah Solusi, pada menu Proyek klik Properti.

2. Klik tab Terbitkan.

3. Klik tombol Opsi.

   Kotak dialog Opsi Penerbitan muncul.

4. Klik Penyebaran.

5. Pilih kotak centang Untuk penginstalan CD, secara otomatis mulai Penyetelan saat CD disisipkan.

   File Autorun.inf akan disalin ke lokasi penerbitan saat aplikasi diterbitkan.

Konten terkait

• Menerbitkan aplikasi ClickOnce
• Cara: Menerbitkan Aplikasi ClickOnce menggunakan Wizard Publish