Bagikan melalui

Panduan: Menyebarkan aplikasi ClickOnce secara manual yang tidak memerlukan penandatanganan ulang dan yang mempertahankan informasi merek

  • Artikel

Saat Anda membuat aplikasi ClickOnce dan kemudian memberikannya kepada pelanggan untuk menerbitkan dan menyebarkannya, pelanggan secara tradisional harus memperbarui manifes penyebaran dan menandatanganinya kembali. Meskipun itu masih merupakan metode yang disukai dalam kebanyakan kasus, .NET Framework 3.5 memungkinkan Anda membuat penyebaran ClickOnce yang dapat disebarkan oleh pelanggan tanpa harus meregenerasi manifes penyebaran baru. Untuk informasi selengkapnya, lihat Menyebarkan aplikasi ClickOnce untuk pengujian dan server produksi tanpa mengundurkan diri.

Saat Anda membuat aplikasi ClickOnce dan kemudian memberikannya kepada pelanggan untuk menerbitkan dan menyebarkan, aplikasi dapat menggunakan branding pelanggan atau dapat mempertahankan branding Anda. Misalnya, jika aplikasi adalah aplikasi kepemilikan tunggal, Anda mungkin ingin mempertahankan branding Anda. Jika aplikasi sangat disesuaikan untuk setiap pelanggan, Anda mungkin ingin menggunakan branding pelanggan. .NET Framework 3.5 memungkinkan Anda mempertahankan merek, informasi penerbit, dan tanda tangan keamanan saat Anda memberikan aplikasi kepada organisasi untuk disebarkan. Untuk informasi selengkapnya, lihat Membuat aplikasi ClickOnce bagi orang lain untuk disebarkan.

Catatan

Dalam panduan ini Anda membuat penyebaran secara manual dengan menggunakan alat baris perintah Mage.exe atau alat grafis MageUI.exe. Untuk informasi selengkapnya tentang penyebaran manual, lihat Panduan: Menyebarkan aplikasi ClickOnce secara manual.

Catatan

Di ClickOnce untuk .NET Core 3.1 dan .NET 5 atau yang lebih baru, gunakan dotnet-mage.exe alih-alih Mage.exe. Untuk informasi selengkapnya, lihat ClickOnce untuk .NET.

Prasyarat

Untuk melakukan langkah-langkah dalam panduan ini, Anda memerlukan hal berikut:

  • Aplikasi Formulir Windows yang siap Anda sebarkan. Aplikasi ini akan disebut sebagai WindowsFormsApp1.

  • Visual Studio atau Windows SDK.

Untuk menyebarkan aplikasi ClickOnce dengan beberapa dukungan penyebaran dan merek menggunakan Mage.exe

  1. Buka prompt perintah Visual Studio atau perintah Windows SDK, dan ubah ke direktori tempat Anda akan menyimpan file ClickOnce Anda.

  2. Buat direktori bernama sesuai versi penyebaran Anda saat ini. Jika ini pertama kalinya Anda menyebarkan aplikasi, Anda mungkin akan memilih 1.0.0.0.

    Catatan

    Versi penyebaran Anda mungkin berbeda dari versi file aplikasi Anda.

  3. Buat subdirektori bernama bin dan salin semua file aplikasi Anda di sini, termasuk file yang dapat dieksekusi, rakitan, sumber daya, dan file data.

  4. Buat manifes aplikasi dengan panggilan ke Mage.exe.

    mage -New Application -ToFile 1.0.0.0\WindowsFormsApp1.exe.manifest -Name "Windows Forms App 1" -Version 1.0.0.0 -FromDirectory 1.0.0.0\bin -UseManifestForTrust true -Publisher "A. Datum Corporation"

  5. Tanda tangani manifes aplikasi dengan sertifikat digital Anda.

    mage -Sign WindowsFormsApp1.exe.manifest -CertFile mycert.pfx

  6. Buat manifes penyebaran dengan panggilan ke Mage.exe. Secara default, Mage.exe akan menandai penyebaran ClickOnce Anda sebagai aplikasi yang diinstal, sehingga dapat dijalankan baik secara online maupun offline. Untuk membuat aplikasi hanya tersedia saat pengguna online, gunakan -i argumen dengan nilai f. Karena aplikasi ini akan memanfaatkan beberapa fitur penyebaran, kecualikan -providerUrl argumen ke Mage.exe. (Dalam versi .NET Framework sebelum versi 3.5, tidak termasuk -providerUrl untuk aplikasi offline akan mengakibatkan kesalahan.)

    mage -New Deployment -ToFile WindowsFormsApp1.application -Name "Windows Forms App 1" -Version 1.0.0.0 -AppManifest 1.0.0.0\WindowsFormsApp1.manifest

  7. Jangan tanda tangani manifes penyebaran.

  8. Berikan semua file kepada pelanggan, yang akan menyebarkan aplikasi di jaringannya.

  9. Pada titik ini, pelanggan harus menandatangani manifes penyebaran dengan sertifikat buatannya sendiri. Misalnya, jika pelanggan bekerja untuk perusahaan bernama Adventure Works, ia dapat membuat sertifikat yang ditandatangani sendiri menggunakan alat MakeCert.exe . Selanjutnya, gunakan alat Pvk2pfx.exe untuk menggabungkan file yang dibuat oleh MakeCert.exe ke dalam file PFX yang dapat diteruskan ke Mage.exe.

    makecert -r -pe -n "CN=Adventure Works" -sv MyCert.pvk MyCert.cer
pvk2pfx.exe -pvk MyCert.pvk -spc MyCert.cer -pfx MyCert.pfx

  10. Pelanggan selanjutnya menggunakan sertifikat ini untuk menandatangani manifes penyebaran.

    mage -Sign WindowsFormsApp1.application -CertFile MyCert.pfx

  11. Pelanggan menyebarkan aplikasi ke pengguna mereka.

Untuk menyebarkan aplikasi ClickOnce dengan beberapa dukungan penyebaran dan merek menggunakan MageUI.exe

  1. Buka perintah Visual Studio atau prompt perintah Windows SDK, dan navigasikan ke direktori tempat Anda akan menyimpan file ClickOnce Anda.

  2. Buat subdirektori bernama bin dan salin semua file aplikasi Anda di sini, termasuk file yang dapat dieksekusi, rakitan, sumber daya, dan file data.

  3. Buat subdirektori bernama sesuai versi penyebaran Anda saat ini. Jika ini pertama kalinya Anda menyebarkan aplikasi, Anda mungkin akan memilih 1.0.0.0.

    Catatan

    Versi penyebaran Anda mungkin berbeda dari versi file aplikasi Anda.

  4. Pindahkan direktori \bin ke direktori yang Anda buat di langkah 2.

  5. Mulai alat grafis MageUI.exe.

    MageUI.exe

  6. Buat manifes aplikasi baru dengan memilih File, Baru, Manifes Aplikasi dari menu.

  7. Pada tab Nama default, masukkan nama dan nomor versi penyebaran ini. Selain itu, berikan nilai untuk Publisher, yang akan digunakan sebagai nama folder untuk tautan pintasan aplikasi di menu Mulai saat disebarkan.

  8. Pilih tab Opsi Aplikasi dan klik Gunakan Manifes Aplikasi untuk Informasi Kepercayaan. Ini akan memungkinkan branding pihak ketiga untuk aplikasi ClickOnce ini.

  9. Pilih tab File dan klik tombol Telusuri di samping kotak teks Direktori Aplikasi.

  10. Pilih direktori yang berisi file aplikasi yang Anda buat di langkah 2, dan klik OK pada kotak dialog pemilihan folder.

  11. Klik tombol Isi untuk menambahkan semua file aplikasi Anda ke daftar file. Jika aplikasi Anda berisi lebih dari satu file yang dapat dieksekusi, tandai file utama yang dapat dieksekusi untuk penyebaran ini sebagai aplikasi startup dengan memilih Titik Masuk dari daftar drop-down Jenis File. (Jika aplikasi Anda hanya berisi satu file yang dapat dieksekusi, MageUI.exe akan menandainya untuk Anda.)

  12. Pilih tab Izin diperlukan dan pilih tingkat kepercayaan yang perlu anda tegaskan pada aplikasi Anda. Defaultnya adalah Kepercayaan Penuh, yang akan sesuai untuk sebagian besar aplikasi.

  13. Pilih File, Simpan dari menu, dan simpan manifes aplikasi. Anda akan diminta untuk menandatangani manifes aplikasi saat menyimpannya.

  14. Jika Anda memiliki sertifikat yang disimpan sebagai file di sistem file Anda, gunakan opsi Tanda tangani sebagai file sertifikat, dan pilih sertifikat dari sistem file menggunakan tombol elipsis (...).

    -atau-

    Jika sertifikat Anda disimpan di penyimpanan sertifikat yang dapat diakses dari komputer Anda, pilih opsi Tanda tangani dengan sertifikat tersimpan, dan pilih sertifikat dari daftar yang disediakan.

  15. Pilih File, Baru, Manifes Penyebaran dari menu untuk membuat manifes penyebaran Anda, lalu pada tab Nama , berikan nama dan nomor versi (1.0.0.0 dalam contoh ini).

  16. Beralih ke tab Perbarui , dan tentukan seberapa sering Anda ingin aplikasi ini diperbarui. Jika aplikasi Anda menggunakan CLICKOnce Deployment API untuk memeriksa pembaruan itu sendiri, kosongkan kotak centang berlabel Aplikasi ini harus memeriksa pembaruan.

  17. Beralih ke tab Referensi Aplikasi. Anda dapat mengisi semua nilai sebelumnya pada tab ini dengan mengklik tombol Pilih Manifes dan memilih manifes aplikasi yang Anda buat di langkah sebelumnya.

  18. Pilih Simpan dan simpan manifes penyebaran ke disk. Anda akan diminta untuk menandatangani manifes aplikasi saat menyimpannya. Klik Batal untuk menyimpan manifes tanpa menandatanganinya.

  19. Berikan semua file aplikasi kepada pelanggan.

  20. Pada titik ini, pelanggan harus menandatangani manifes penyebaran dengan sertifikat buatannya sendiri. Misalnya, jika pelanggan bekerja untuk perusahaan bernama Adventure Works, ia dapat membuat sertifikat yang ditandatangani sendiri menggunakan alat MakeCert.exe . Selanjutnya, gunakan alat Pvk2pfx.exe untuk menggabungkan file yang dibuat oleh MakeCert.exe ke dalam file PFX yang dapat diteruskan ke MageUI.exe.

    makecert -r -pe -n "CN=Adventure Works" -sv MyCert.pvk MyCert.cer
pvk2pfx.exe -pvk MyCert.pvk -spc MyCert.cer -pfx MyCert.pfx

  21. Dengan sertifikat yang dihasilkan, pelanggan sekarang menandatangani manifes penyebaran dengan membuka manifes penyebaran di MageUI.exe, lalu menyimpannya. Saat kotak dialog penandatanganan muncul, pelanggan memilih opsi Tanda tangani sebagai file sertifikat, dan memilih file PFX yang telah disimpannya di disk.

  22. Pelanggan menyebarkan aplikasi ke pengguna mereka.

Konten terkait