Bagikan melalui

Menentukan file mana yang diterbitkan oleh ClickOnce

  • Artikel

Saat menerbitkan aplikasi ClickOnce, semua file yang diperlukan dalam proyek disebarkan bersama dengan aplikasi. Kumpulan default file yang diperlukan ditentukan oleh jenis proyek (misalnya, aplikasi Formulir Windows). Dalam beberapa kasus, Anda mungkin tidak ingin atau perlu menerbitkan file tertentu, atau Anda mungkin ingin menginstal file tertentu berdasarkan kondisi. Visual Studio menyediakan kemampuan untuk menyertakan file, mengecualikan file, menandai file sebagai file data atau prasyarat, dan membuat grup file untuk penginstalan bersyarat.

File untuk aplikasi ClickOnce dikelola dalam kotak dialog File Aplikasi, dapat diakses dari halaman Terbitkan Perancang Proyek.

Awalnya, ada satu grup file bernama (Wajib). Anda dapat membuat grup file tambahan dan menetapkan file ke grup tersebut. Anda tidak dapat mengubah Grup Unduh untuk file yang diperlukan agar aplikasi dapat dijalankan. Misalnya, .exe aplikasi atau file yang ditandai sebagai file data harus termasuk dalam grup (Wajib) .

Nilai status penerbitan default file ditandai dengan (Otomatis). Misalnya, .exe aplikasi memiliki status publikasi Sertakan (Otomatis) secara default.

File dengan properti Tindakan Build diatur ke Konten ditetapkan sebagai file aplikasi dan akan ditandai sebagai disertakan secara default. Mereka dapat disertakan, dikecualikan, atau ditandai sebagai file data. Pengecualiannya adalah sebagai berikut:

  • File data seperti file SQL Database (.mdf dan .mdb) dan file XML akan ditandai sebagai file data secara default.

  • Referensi ke rakitan (.dll file) ditunjuk sebagai berikut ketika Anda menambahkan referensi: Jika Salin Lokalsalah, itu ditandai secara default sebagai rakitan prasyarat (Prasyarat (Otomatis)) yang harus ada di GAC sebelum aplikasi diinstal. Jika Salin Lokal True, rakitan ditandai secara default sebagai rakitan aplikasi (Sertakan (Otomatis)) dan akan disalin ke folder aplikasi saat penginstalan. Referensi COM akan muncul dalam kotak dialog File Aplikasi (sebagai file .ocx ) hanya jika properti Terisolasi diatur ke True. Secara default, itu akan disertakan.

Untuk menambahkan file ke kotak dialog File Aplikasi

  1. Pilih file data di Penjelajah Solusi.

  2. Di jendela Properti, ubah properti Tindakan Build menjadi nilai Konten .

Untuk mengecualikan file dari penerbitan ClickOnce

  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 File Aplikasi untuk membuka kotak dialog File Aplikasi.

  4. Dalam kotak dialog File Aplikasi, pilih file yang ingin Anda kecualikan.

  5. Di bidang Status Terbitkan, pilih Kecualikan dari daftar drop-down.

Untuk menandai file sebagai file data

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

  2. Klik tab Terbitkan.

  3. Klik tombol File Aplikasi untuk membuka kotak dialog File Aplikasi.

  4. Dalam kotak dialog File Aplikasi, pilih file yang ingin Anda tandai sebagai data.

  5. Di bidang Terbitkan Status, pilih File Data dari daftar drop-down.

Untuk menandai file sebagai prasyarat

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

  2. Klik tab Terbitkan.

  3. Klik tombol File Aplikasi untuk membuka kotak dialog File Aplikasi.

  4. Dalam kotak dialog File Aplikasi, pilih rakitan aplikasi (file .dll ) yang ingin Anda tandai sebagai prasyarat. Perhatikan bahwa aplikasi Anda harus memiliki referensi ke perakitan aplikasi agar muncul dalam daftar.

  5. Di bidang Status Terbitkan, pilih Prasyarat dari daftar drop-down.

Untuk menambahkan grup file baru

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

  2. Klik tab Terbitkan.

  3. Klik tombol File Aplikasi untuk membuka kotak dialog File Aplikasi.

  4. Dalam kotak dialog File Aplikasi, pilih bidang Grup untuk file yang ingin Anda sertakan dalam grup baru.

    Catatan

    File harus mengatur properti Tindakan Build ke Konten sebelum nama file muncul dalam kotak dialog File Aplikasi.

  5. Di bidang Unduh Grup, pilih <Baru...> dari daftar drop-down.

  6. Dalam kotak dialog Grup Baru, masukkan nama untuk grup, lalu klik OK.

Untuk menambahkan file ke grup

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

  2. Klik tab Terbitkan.

  3. Klik tombol File Aplikasi untuk membuka kotak dialog File Aplikasi.

  4. Dalam kotak dialog File Aplikasi, pilih bidang Grup untuk file yang ingin Anda sertakan dalam grup baru.

  5. Di bidang Unduh Grup, pilih grup dari daftar drop-down.

    Catatan

    Anda tidak dapat mengubah Grup Unduh untuk file yang diperlukan agar aplikasi dapat dijalankan.

Konten terkait