Panduan: Menyebarkan aplikasi ClickOnce secara manual

  • Artikel

Jika Anda tidak dapat menggunakan Visual Studio untuk menyebarkan aplikasi ClickOnce, atau Anda perlu menggunakan fitur penyebaran tingkat lanjut, seperti Penyebaran Aplikasi Tepercaya, Anda harus menggunakan Mage.exe alat baris perintah untuk membuat manifes ClickOnce Anda. Panduan ini menjelaskan cara membuat penyebaran ClickOnce dengan menggunakan versi baris perintah (Mage.exe) atau versi grafis (MageUI.exe) dari Pembuatan Manifes dan Alat Pengeditan.

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

Panduan ini memiliki beberapa prasyarat dan opsi yang perlu Anda pilih sebelum membangun penyebaran.

  • Instal Mage.exe dan MageUI.exe.

    Mage.exe dan MageUI.exe merupakan bagian dari Windows Software Development Kit (SDK). Anda harus menginstal Windows SDK atau versi Windows SDK yang disertakan dengan Visual Studio. Untuk informasi selengkapnya, lihat Windows SDK di MSDN.

  • Sediakan aplikasi untuk disebarkan.

    Panduan ini mengasumsikan bahwa Anda memiliki aplikasi Windows yang siap Anda sebarkan. Aplikasi ini akan disebut sebagai AppToDeploy.

  • Tentukan bagaimana penyebaran akan didistribusikan.

    Opsi distribusi meliputi: Web, berbagi file, atau CD. Untuk informasi selengkapnya, lihat Keamanan dan Penyebaran ClickOnce.

  • Tentukan apakah aplikasi memerlukan tingkat kepercayaan yang ditingkatkan.

    Jika aplikasi Anda memerlukan Kepercayaan Penuh—misalnya, akses penuh ke sistem pengguna—Anda dapat menggunakan -TrustLevel opsi Mage.exe untuk mengatur ini. Jika Anda ingin menentukan set izin kustom untuk aplikasi, Anda dapat menyalin bagian izin Internet atau intranet dari manifes lain, memodifikasinya agar sesuai dengan kebutuhan Anda, dan menambahkannya ke manifes aplikasi menggunakan editor teks atau MageUI.exe. Untuk informasi selengkapnya, lihat Gambaran umum Penyebaran Aplikasi Tepercaya.

  • Dapatkan sertifikat Authenticode.

    Anda harus menandatangani penyebaran Anda dengan sertifikat Authenticode. Anda dapat membuat sertifikat pengujian dengan menggunakan Visual Studio, MageUI.exe, atau MakeCert.exe dan Pvk2Pfx.exe alat, atau Anda dapat memperoleh sertifikat dari Otoritas Sertifikat (CA). Jika Anda memilih untuk menggunakan Penyebaran Aplikasi Tepercaya, Anda juga harus melakukan penginstalan sertifikat satu kali ke semua komputer klien. Untuk informasi selengkapnya, lihat Ringkasan Penyebaran Aplikasi Tepercaya.

    Catatan

    Anda juga dapat menandatangani penyebaran dengan sertifikat CNG yang dapat Anda peroleh dari Otoritas Sertifikat.

  • Pastikan bahwa aplikasi tidak memiliki manifes dengan informasi UAC.

    Anda perlu menentukan apakah aplikasi Anda berisi manifes dengan informasi Kontrol Akun Pengguna (UAC), seperti <dependentAssembly> elemen. Untuk memeriksa manifes aplikasi, Anda dapat menggunakan utilitas Windows Sysinternals Sigcheck .

    Jika aplikasi Anda berisi manifes dengan detail UAC, Anda harus membangunnya kembali tanpa informasi UAC. Untuk proyek C# di Visual Studio, buka properti proyek dan pilih tab Aplikasi. Di daftar drop-down Manifes , pilih Buat aplikasi tanpa manifes. Untuk proyek Visual Basic di Visual Studio, buka properti proyek, pilih tab Aplikasi, dan klik Tampilkan UAC Pengaturan. Dalam file manifes yang dibuka, hapus semua elemen dalam elemen tunggal <asmv1:assembly> .

  • Tentukan apakah aplikasi memerlukan prasyarat di komputer klien.

    Aplikasi ClickOnce yang disebarkan dari Visual Studio dapat menyertakan bootstrapper penginstalan prasyarat (setup.exe) dengan penyebaran Anda. Panduan ini membuat dua manifes yang diperlukan untuk penyebaran ClickOnce. Anda dapat membuat bootstrapper prasyarat dengan menggunakan tugas GenerateBootstrapper.

Untuk menyebarkan aplikasi dengan alat baris perintah Mage.exe

  1. Buat direktori tempat Anda akan menyimpan file penyebaran ClickOnce Anda.

  2. Di direktori penyebaran yang baru saja Anda buat, buat subdirektori versi. Jika ini pertama kalinya Anda menyebarkan aplikasi, beri nama subdirektori versi 1.0.0.0.

    Catatan

    Versi penyebaran Anda dapat berbeda dari versi aplikasi Anda.

  3. Salin semua file aplikasi Anda ke subdirektori versi, termasuk file yang dapat dieksekusi, rakitan, sumber daya, dan file data. Jika perlu, Anda dapat membuat subdirektori tambahan yang berisi file tambahan.

  4. Buka prompt perintah Windows SDK atau Visual Studio dan ubah ke subdirektori versi.

  5. Buat manifes aplikasi dengan panggilan ke Mage.exe. Pernyataan berikut membuat manifes aplikasi untuk kode yang dikompilasi untuk dijalankan pada prosesor Intel x86.

    mage -New Application -Processor x86 -ToFile AppToDeploy.exe.manifest -name "My App" -Version 1.0.0.0 -FromDirectory .

    Catatan

    Pastikan untuk menyertakan titik (.) setelah -FromDirectory opsi , yang menunjukkan direktori saat ini. Jika Anda tidak menyertakan titik, Anda harus menentukan jalur ke file aplikasi Anda.

  6. Tanda tangani manifes aplikasi dengan sertifikat Authenticode Anda. Ganti mycert.pfx dengan jalur ke file sertifikat Anda. Ganti passwd dengan kata sandi untuk file sertifikat Anda.

    mage -Sign AppToDeploy.exe.manifest -CertFile mycert.pfx -Password passwd

    Dimulai dengan .NET Framework 4.6.2 SDK, yang didistribusikan dengan Visual Studio dan dengan Windows SDK, mage.exe menandatangani manifes dengan CNG serta dengan sertifikat Authenticode. Gunakan parameter baris perintah yang sama seperti dengan sertifikat Authenticode.

  7. Ubah ke akar direktori penyebaran.

  8. Buat manifes penyebaran dengan panggilan ke Mage.exe. Secara default, Mage.exe akan menandai penyebaran ClickOnce Anda sebagai aplikasi yang diinstal, sehingga dapat dijalankan secara online dan offline. Untuk membuat aplikasi hanya tersedia ketika pengguna online, gunakan -Install opsi dengan nilai false. Jika Anda menggunakan default, dan pengguna akan menginstal aplikasi Anda dari situs Web atau berbagi file, pastikan bahwa nilai -ProviderUrl opsi menunjuk ke lokasi manifes aplikasi di server Web atau berbagi.

    mage -New Deployment -Processor x86 -Install true -Publisher "My Co." -ProviderUrl "\\myServer\myShare\AppToDeploy.application" -AppManifest 1.0.0.0\AppToDeploy.exe.manifest -ToFile AppToDeploy.application

  9. Tanda tangani manifes penyebaran dengan sertifikat Authenticode atau CNG Anda.

    mage -Sign AppToDeploy.application -CertFile mycert.pfx -Password passwd

  10. Salin semua file dalam direktori penyebaran ke tujuan penyebaran atau media. Ini mungkin folder pada situs Web atau situs FTP, berbagi berkas, atau CD-ROM.

  11. Berikan PENGGUNA Anda URL, UNC, atau media fisik yang diperlukan untuk menginstal aplikasi Anda. Jika Anda memberikan URL atau UNC, Anda harus memberi pengguna Jalur lengkap ke manifes penyebaran. Misalnya, jika AppToDeploy disebarkan ke http://webserver01/ di direktori AppToDeploy, jalur URL lengkapnya adalah http://webserver01/AppToDeploy/AppToDeploy.application.

Untuk menyebarkan aplikasi dengan alat grafis MageUI.exe

  1. Buat direktori tempat Anda akan menyimpan file penyebaran ClickOnce Anda.

  2. Di direktori penyebaran yang baru saja Anda buat, buat subdirektori versi. Jika ini pertama kalinya Anda menyebarkan aplikasi, beri nama subdirektori versi 1.0.0.0.

    Catatan

    Versi penyebaran Anda mungkin berbeda dari versi aplikasi Anda.

  3. Salin semua file aplikasi Anda ke subdirektori versi, termasuk file yang dapat dieksekusi, rakitan, sumber daya, dan file data. Jika perlu, Anda dapat membuat subdirektori tambahan yang berisi file tambahan.

  4. MageUI.exe Mulai alat grafis.

    MageUI.exe

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

  6. Pada tab Nama default, ketik nama dan nomor versi penyebaran ini. Tentukan juga Prosesor tempat aplikasi Anda dibangun, seperti x86.

  7. Pilih tab File lalu pilih tombol elipsis (...) di samping kotak teks Direktori aplikasi. Kotak dialog Telusuri Folder muncul.

  8. Pilih subdirektori versi yang berisi file aplikasi Anda, lalu pilih OK.

  9. Jika Anda akan menyebarkan dari Layanan Informasi Internet (IIS), pilih kotak centang Saat mengisi tambahkan ekstensi .deploy ke file apa pun yang tidak memilikinya.

  10. Buka 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.)

  11. Pilih tab Izin diperlukan dan pilih tingkat kepercayaan yang perlu disarankan oleh aplikasi Anda. Defaultnya adalah FullTrust, yang akan cocok untuk sebagian besar aplikasi.

  12. Pilih File, Simpan Sebagai dari menu. Kotak dialog Opsi Penandatanganan muncul yang meminta Anda untuk menandatangani manifes aplikasi.

  13. Jika Anda memiliki sertifikat yang disimpan sebagai file di sistem file Anda, gunakan opsi Tanda tangani dengan file sertifikat, dan pilih sertifikat dari sistem file dengan menggunakan tombol elipsis (...). Kemudian ketik kata sandi sertifikat Anda.

    -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.

  14. Pilih OK untuk menandatangani manifes aplikasi Anda. Kotak dialog Simpan Sebagai muncul.

  15. Dalam kotak dialog Simpan Sebagai , tentukan direktori versi, lalu pilih Simpan.

  16. Pilih File, Baru, Manifes Penyebaran dari menu untuk membuat manifes penyebaran Anda.

  17. Pada tab Nama , tentukan nama dan nomor versi untuk penyebaran ini (1.0.0.0 dalam contoh ini). Tentukan juga Prosesor tempat aplikasi Anda dibangun, seperti x86.

  18. Pilih tab Deskripsi , dan tentukan nilai untuk Penerbit dan Produk. (Produk adalah nama yang diberikan untuk aplikasi Anda di Windows menu Mulai ketika aplikasi Anda diinstal pada komputer klien untuk penggunaan offline.)

  19. Pilih tab Opsi Penyebaran, dan di kotak teks Mulai Lokasi , tentukan lokasi manifes aplikasi di server Web atau bagikan. Misalnya, \\myServer\myShare\AppToDeploy.application.

  20. Jika Anda menambahkan .deploy ekstensi di langkah sebelumnya, pilih juga Gunakan ekstensi nama file .deploy di sini.

  21. Pilih tab Opsi Pembaruan, dan tentukan seberapa sering Anda ingin aplikasi ini diperbarui. Jika aplikasi Anda menggunakan UpdateCheckInfo untuk memeriksa pembaruan itu sendiri, kosongkan kotak centang Aplikasi ini harus memeriksa pembaruan .

  22. Pilih tab Referensi Aplikasi lalu buka tombol Pilih Manifes . Kotak dialog terbuka muncul.

  23. Pilih manifes aplikasi yang Anda buat sebelumnya lalu pilih Buka.

  24. Pilih File, Simpan Sebagai dari menu. Kotak dialog Opsi Penandatanganan muncul yang meminta Anda untuk menandatangani manifes penyebaran.

  25. Jika Anda memiliki sertifikat yang disimpan sebagai file di sistem file Anda, gunakan opsi Tanda tangani dengan file sertifikat, dan pilih sertifikat dari sistem file dengan menggunakan tombol elipsis (...). Kemudian ketik kata sandi sertifikat Anda.

    -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.

  26. Buka OK untuk menandatangani manifes penyebaran Anda. Kotak dialog Simpan Sebagai muncul.

  27. Dalam kotak dialog Simpan Sebagai , pindahkan satu direktori ke akar penyebaran Anda lalu pilih Simpan.

  28. Salin semua file dalam direktori penyebaran ke tujuan penyebaran atau media. Ini mungkin folder pada situs Web atau situs FTP, berbagi berkas, atau CD-ROM.

  29. Berikan PENGGUNA Anda URL, UNC, atau media fisik yang diperlukan untuk menginstal aplikasi Anda. Jika Anda memberikan URL atau UNC, Anda harus memberi pengguna Jalur lengkap manifes penyebaran. Misalnya, jika AppToDeploy disebarkan ke http://webserver01/ di direktori AppToDeploy, jalur URL lengkapnya adalah http://webserver01/AppToDeploy/AppToDeploy.application.

Langkah berikutnya

Saat Anda perlu menyebarkan versi baru aplikasi, buat direktori baru bernama sesuai versi baru—misalnya, 1.0.0.1—dan salin file aplikasi baru ke direktori baru. Selanjutnya, Anda perlu mengikuti langkah-langkah sebelumnya untuk membuat dan menandatangani manifes aplikasi baru, dan memperbarui dan menandatangani manifes penyebaran. Berhati-hatilah untuk menentukan versi yang lebih tinggi yang sama dalam Mage.exe-New panggilan dan -Update , karena ClickOnce hanya memperbarui versi yang lebih tinggi, dengan bilangan bulat paling kiri paling signifikan. Jika Anda menggunakan MageUI.exe, Anda dapat memperbarui manifes penyebaran dengan membukanya, memilih tab Referensi Aplikasi, buka tombol Pilih Manifes , lalu memilih manifes aplikasi yang diperbarui.

Konten terkait