MageUI.exe (Pembuatan Manifes dan Alat Pengeditan, Klien Grafis)
MageUI.exe mendukung fungsionalitas yang sama dengan alat baris perintah Mage.exe, tetapi dengan antarmuka pengguna (UI) berbasis Windows. Dengan alat ini Anda dapat membuat, mengedit, dan menandatangani manifes penyebaran dan aplikasi. Manifes baru yang dibuat dengan MageUI.exe menargetkan Profil Klien .NET Framework 4. Versi MageUI.exe sebelumnya harus digunakan untuk menargetkan versi .NET Framework sebelumnya. Saat menambahkan atau menghapus rakitan dari manifes, atau menandatangani ulang manifes yang ada, MageUI.exe tidak memperbarui manifes untuk menargetkan Profil Klien .NET Framework 4. Untuk mengetahui informasi selengkapnya, lihat Mage.exe (Pembuatan Manifes dan Alat Pengeditan).
Alat ini otomatis terpasang dengan Visual Studio. Untuk menjalankan alat ini, gunakan Perintah Pengembang Visual Studio atau PowerShell Pengembang Visual Studio.
Dua versi Mage.exe dan MageUI.exe disertakan sebagai komponen Visual Studio. Untuk melihat informasi versi, jalankan MageUI.exe, pilih Bantuan, dan pilih Tentang. Dokumentasi ini menjelaskan versi 4.0.xx dari Mage.exe dan MageUI.exe.
Catatan
MageUI.exe tidak mendukung elemen compatibleFrameworks saat menyimpan manifes aplikasi yang telah ditandatangani dengan sertifikat menggunakan MageUI.exe. Sebagai gantinya, Anda harus menggunakan Mage.exe.
Daftar UIElement
Tabel berikut ini mencantumkan menu dan item toolbar yang tersedia.
| Perintah | Menu | Pintasan | Deskripsi |
|---|---|---|---|
| Manifes Aplikasi | File, Baru | Buat manifes aplikasi baru. | |
| Manifes penyebaran | File, Baru | Buat manifes penyebaran baru. | |
| Buka | File | CTRL+O | Membuka manifes penyebaran, manifes aplikasi, atau lisensi kepercayaan yang ada untuk pengeditan. |
| Tutup | File | CTRL+F4 | Menutup file yang terbuka. Jika Anda memodifikasi file sebelum menutupnya, MageUI.exe meminta Anda untuk menandatangani ulang file dengan kunci umum, pasangan kunci, atau sertifikat yang disimpan. |
| Simpan | File | CTRL+S | Menyimpan ke disk dokumen yang saat ini memiliki fokus input pengguna. |
| Simpan Sebagai | File | Menyimpan file ke disk, memungkinkan Anda menyediakan nama file dan/atau lokasi baru. | |
| Simpan Semua | File | Menyimpan perubahan yang dilakukan pada semua file yang saat ini terbuka dalam MageUI.exe. | |
| Preferensi | File | Membuka kotak dialog Preferensi. Lihat bagian berikut untuk informasi selengkapnya. | |
| Keluar | File | ALT+F4 | Quits MageUI.exe. |
| Cut | Edit | CTRL+X | Menghapus teks yang saat ini dipilih dari aplikasi dan memindahkannya ke Clipboard sistem. |
| Menyalin | Edit | CTRL+C | Menyalin teks dipilih saat ini ke Clipboard sistem. |
| Tempel | Edit | CTRL+V | Menempelkan teks dari Clipboard sistem ke elemen teks yang saat ini aktif. |
| Delete | Edit | Menghapus elemen yang saat ini dipilih dalam daftar, seperti lisensi kepercayaan pada tab Manifes Penyebaran. | |
| Tutup Semua | Jendela | Menutup semua file yang saat ini dibuka di MageUI.exe. Jika satu atau lebih file perlu disimpan, MageUI.exe meminta Anda untuk menyimpannya. MageUI.exe juga meminta Anda untuk memilih kunci penandatanganan untuk setiap file yang tidak ditandatangani atau diubah. | |
| Tentang | Bantuan | Menampilkan informasi versi dan hak cipta tentang MageUI.exe. |
Kotak Dialog Preferensi
Kotak dialog Preferensi berisi elemen berikut ini.
| Elemen Antarmuka Pengguna | Deskripsi |
|---|---|
| Simpan masuk | Meminta Anda untuk menandatangani file setiap kali Anda menyimpan modifikasi Anda. |
| Gunakan sertifikat penandatanganan default | Menggunakan kunci yang dimasukkan dalam kotak teks File sertifikat untuk menandatangani semua file. Ini menghilangkan perintah penandatanganan yang biasanya muncul saat Anda menyimpan file dan Simpan Masuk dipilih. Gunakan tombol elipsis (...) di samping kotak teks File sertifikat untuk memilih file kunci. |
| Algoritma Digest | Menentukan algoritma untuk menghasilkan digest dependensi. Nilai harus "sha256RSA" atau "sha1RSA". Menggunakan SHA1 sebagai default. Digunakan baik dalam manifes aplikasi maupun penyebaran. Jika pengguna menyediakan sertifikat saat menyimpan manifes, menggunakan algoritma dalam sertifikat untuk menghasilkan digest dependensi. |
Kotak Dialog Opsi Penandatanganan
Kotak dialog Opsi Penandatanganan muncul saat Anda menyimpan lisensi manifes atau kepercayaan untuk pertama kalinya, atau saat Anda mengubah lisensi manifes atau kepercayaan. Ini hanya muncul jika opsi Simpan Masuk di kotak dialog Preferensi dipilih. Anda harus tersambung ke Internet saat menandatangani manifes yang menentukan nilai dalam kotak teks URI TimeStamping.
Kotak dialog ini berisi elemen-elemen berikut.
| Elemen Antarmuka Pengguna | Deskripsi |
|---|---|
| Tanda tangani dengan file sertifikat | Menandatangani manifes dengan sertifikat digital yang disimpan pada sistem file. |
| File | Menyediakan area untuk mengetik jalur ke file .pfx yang mewakili sertifikat. |
| ... | Membuka kotak dialog Pilih File untuk memilih file .pfx yang sudah ada. |
| Baru | Menghasilkan .pfx baru yang tidak dapat diverifikasi melalui Otoritas Sertifikat (CA). Untuk informasi selengkapnya tentang jenis sertifikat yang digunakan untuk menandatangani penyebaran ClickOnce, lihat Gambaran Umum Penyebaran Aplikasi Tepercaya. |
| Kata sandi | Menyediakan area untuk mengetik kata sandi yang digunakan untuk menandatangani dengan sertifikat ini. Jika tidak berlaku, dapat dibiarkan kosong. |
| Tanda tangan dengan sertifikat tersimpan | Menampilkan daftar sertifikat digital yang dapat dipilih yang disimpan di penyimpanan sertifikat komputer Anda. |
| TimeStamping URI | Menampilkan Alamat Web (URI) dari layanan sempel waktu digital. Pemberian stempel waktu pada manifes mencegah Anda dari keharusan menandatangani ulang manifes jika sertifikat digital Anda kedaluwarsa sebelum Anda menyebarkan versi aplikasi berikutnya. Untuk informasi selengkapnya, lihat Anggota program sertifikat akar Windows dan ClickOnce dan Authenticode. |
| Jangan Tanda tangani | Memungkinkan Anda menyimpan manifes tanpa menambahkan tanda tangan dari sertifikat digital. |
Deskripsi Tab dan Panel
Saat Anda membuka dokumen dengan MageUI.exe, dokumen tersebut muncul di dalam halaman tabnya sendiri. Setiap tab berisi sekumpulan panel properti. Panel berisi subset data dokumen yang dikelompokkan.
Tab Manifes Aplikasi
Tab Manifes Aplikasi menampilkan konten manifes aplikasi. Manifes aplikasi menjelaskan semua file yang disertakan dengan penyebaran, dan izin yang diperlukan agar aplikasi dapat berjalan di klien.
Tab Manifes Aplikasi berisi tab berikut.
| Elemen Antarmuka Pengguna | Deskripsi |
|---|---|
| Nama | Menentukan informasi identifikasi tentang penyebaran ini. |
| Deskripsi | Menentukan informasi penerbit, produk, dan dukungan. |
| Opsi Aplikasi | Menentukan apakah ini adalah aplikasi browser, dan apakah manifes ini adalah sumber informasi kepercayaan. |
| File | Menentukan semua file yang merupakan penyebaran ini. |
| Izin yang Diperlukan | Menentukan rangkaian izin minimum yang diperlukan oleh aplikasi untuk dijalankan pada klien. |
Tab Nama
Tab Nama ditampilkan saat Anda pertama kali membuat atau membuka manifes aplikasi. Ini secara unik mengidentifikasi penyebaran, dan secara opsional menentukan platform target yang valid.
| Elemen Antarmuka Pengguna | Deskripsi |
|---|---|
| Nama | Wajib diisi. Nama manifes aplikasi. Biasanya sama dengan nama file. |
| Versi | Wajib diisi. Nomor versi penyebaran dalam bentuk N.N.N.N. Hanya nomor bangun utama pertama yang diperlukan. Misalnya, untuk aplikasi versi 1.0, nilai yang valid akan mencakup 1, 1.0, 1.0.0, dan 1.0.0.0. |
| Prosesor | Opsional. Arsitektur mesin tempat penyebaran ini dapat berjalan. Defaultnya adalah msil, atau Bahasa Perantara Microsoft, yang merupakan format default dari semua rakitan terkelola. Ubah bidang ini jika Anda telah mengompilasi rakitan sebelumnya di aplikasi Anda untuk arsitektur tertentu. Untuk informasi selengkapnya tentang kompilasi sebelumnya, lihat Ngen.exe (Generator Gambar Asli). |
| Kultur | Opsional. Kode negara dan wilayah ISO dua bagian tempat aplikasi ini berjalan. Defaultnya adalah neutral. |
| Token kunci umum | Opsional. Kunci publik tempat manifes aplikasi ini telah ditandatangani. Jika ini adalah manifes baru atau tidak ditandatangani, bidang ini akan muncul sebagai Unsigned. |
Tab Deskripsi
Informasi ini biasanya disediakan dalam manifes penyebaran. Bidang ini hanya dapat dimodifikasi jika kotak centang Gunakan Informasi Kepercayaan Manifes Aplikasi dipilih pada tab Opsi Aplikasi.
| Elemen Antarmuka Pengguna | Deskripsi |
|---|---|
| Publisher | Nama orang atau organisasi yang bertanggung jawab atas aplikasi. Nilai ini digunakan sebagai nama folder menu Mulai. |
| Produk | Nama produk lengkap. Jika Anda memilih Pasang Secara Lokal untuk elemen Jenis Aplikasi pada tab Opsi Penyebaran dari manifes penyebaran, nama ini akan menjadi apa yang muncul di link menu Mulai dan di Tambahkan atau Hapus Program untuk aplikasi ini. |
| Lokasi Dukungan | URL tempat pelanggan dapat memeroleh bantuan dan dukungan untuk aplikasi. |
Tab Opsi Aplikasi
| Elemen Antarmuka Pengguna | Deskripsi |
|---|---|
| Aplikasi Browser Windows Presentation Foundation | Menentukan apakah ini adalah aplikasi WPF yang berjalan di browser sebagai aplikasi browser XAML (XBAP). |
| Menggunakan Informasi Kepercayaan Manifes Aplikasi | Menentukan apakah manifes ini berisi informasi kepercayaan. |
Tab File
| Elemen Antarmuka Pengguna | Deskripsi |
|---|---|
| Direktori aplikasi | Direktori tempat file aplikasi berada. Gunakan tombol elipsis (...) untuk memilih direktori. |
| Mengisi | Menambahkan semua file dalam direktori aplikasi dan subdirektori ke manifes aplikasi. Jika MageUI.exe menemukan satu file yang dapat dieksekusi di direktori, file tersebut secara otomatis menandai ini sebagai Titik Masuk, yang merupakan file yang pertama kali dijalankan ketika aplikasi ClickOnce diluncurkan pada klien. |
| File Aplikasi | Mencantumkan semua file dalam aplikasi. Setiap file memiliki tiga atribut yang dapat diedit, dibahas di bawah ini. |
| Jenis File | Jenis File bisa menjadi salah satu dari empat nilai: - Tidak ada. - Titik Masuk. Aplikasi utama yang dapat dieksekusi. Hanya satu file yang dapat dieksekusi yang dapat ditandai sebagai titik masuk. - File Data. File, seperti file XML, yang memasok data ke aplikasi. - File Ikon. Ikon aplikasi, seperti muncul di desktop atau di sudut jendela aplikasi. |
| Opsional | File yang ditandai opsional tidak diunduh pada pemasangan atau pembaruan awal, tetapi dapat diunduh pada durasi menggunakan API System.Deployment Sesuai Permintaan. Untuk informasi selengkapnya, lihat Panduan: Mengunduh Rakitan sesuai Permintaan dengan API Penyebaran ClickOnce Menggunakan Perancang. |
| Grup | Label untuk serangkaian file opsional. Anda dapat menerapkan label Grup ke serangkaian file, dan menggunakan API Sesuai Permintaan untuk mengunduh batch file dengan satu panggilan API. |
Tab Izin yang Diperlukan
Gunakan tab Izin yang Diperlukan jika Anda perlu memberi aplikasi Anda lebih banyak akses ke komputer lokal daripada yang diberikan secara default. Untuk informasi selengkapnya, lihat Mengamankan aplikasi ClickOnce.
| Elemen Antarmuka Pengguna | Deskripsi |
|---|---|
| Jenis rangkaian izin | Rangkaian izin minimum yang diperlukan oleh aplikasi ini untuk berjalan pada klien. Untuk deskripsi rangkaian izin ini dan izin mana yang sesuai permintaan atau tidak, lihat Rangkaian Izin Bernama. |
| Detail | XML yang dibuat untuk manifes aplikasi untuk mewakili rangkaian izin. Kecuali Anda memiliki pemahaman yang baik tentang format XML manifes aplikasi, Anda tidak boleh mengedit XML ini secara manual. Untuk informasi selengkapnya, lihat Manifes Aplikasi ClickOnce. |
Tab Manifes Penyebaran
Tab Manifes Penyebaran berisi tab berikut.
| Elemen Antarmuka Pengguna | Deskripsi |
|---|---|
| Nama | Menentukan informasi identifikasi tentang penyebaran ini. |
| Deskripsi | Menentukan informasi penerbit, produk, dan dukungan. |
| Opsi Penyebaran | Menentukan informasi tambahan tentang penyebaran, seperti jenis aplikasi dan lokasi mulai. |
| Opsi Pembaruan | Menentukan seberapa sering ClickOnce harus memeriksa pembaruan aplikasi. |
| Referensi Aplikasi | Menentukan manifes aplikasi untuk penyebaran ini. |
Tab Nama
Tab Nama ditampilkan saat Anda pertama kali membuat atau membuka manifes penyebaran. Ini secara unik mengidentifikasi penyebaran, dan secara opsional menentukan platform target yang valid.
| Elemen Antarmuka Pengguna | Deskripsi |
|---|---|
| Nama | Wajib diisi. Nama manifes penyebaran. Biasanya sama dengan nama file. |
| Versi | Wajib diisi. Nomor versi penyebaran dalam bentuk N.N.N.N. Hanya nomor bangun utama pertama yang diperlukan. Misalnya, untuk aplikasi versi 1.0, nilai yang valid akan mencakup 1, 1.0, 1.0.0, dan 1.0.0.0. |
| Prosesor | Opsional. Arsitektur mesin tempat penyebaran ini dapat berjalan. Defaultnya adalah msil, atau Bahasa Perantara Microsoft, format default semua rakitan terkelola. Ubah bidang ini jika Anda telah mengompilasi rakitan dalam aplikasi Anda untuk arsitektur tertentu. |
| Kultur | Opsional. Kode negara/kawasan ISO dua bagian tempat aplikasi ini berjalan. Defaultnya adalah neutral. |
| Token kunci umum | Opsional. Kunci umum yang dengannya manifes penyebaran ini telah ditandatangani. Jika ini adalah manifes baru atau tidak ditandatangani, bidang ini akan muncul sebagai Unsigned. |
Tab Deskripsi
| Elemen Antarmuka Pengguna | Deskripsi |
|---|---|
| Publisher | Wajib diisi. Nama orang atau organisasi yang bertanggung jawab atas aplikasi. Nilai ini digunakan sebagai nama folder menu Mulai. |
| Produk | Wajib diisi. Nama produk lengkap. Jika Anda memilih Pasang Secara Lokal untuk elemen Jenis Aplikasi pada tab Opsi Penyebaran, nama ini akan menjadi apa yang muncul di link menu Mulai dan di Tambahkan atau Hapus Program untuk aplikasi ini. |
| Lokasi Dukungan | Opsional. URL tempat pelanggan dapat memeroleh bantuan dan dukungan untuk aplikasi. |
Tab Opsi Penyebaran
| Elemen Antarmuka Pengguna | Deskripsi |
|---|---|
| Jenis Aplikasi | Opsional. Menentukan apakah aplikasi ini memasang dirinya sendiri ke komputer klien (Pasang Secara Lokal), berjalan online (Hanya Online), atau adalah aplikasi WPF yang berjalan di browser (Aplikasi Browser WPF). Defaultnya adalah Pasang Secara Lokal. |
| Lokasi Mulai | Opsional. URL tempat aplikasi harus benar-benar dimulai. Berguna saat menyebarkan aplikasi dari CD yang harus memperbarui dirinya sendiri dari Web. |
| Sertakan Lokasi Mulai (ProviderURL) dalam manifes | Opsional. Menentukan URL yang akan diperiksa oleh ClickOnce untuk pembaruan aplikasi. |
| Menjalankan aplikasi secara otomatis setelah memasang | Wajib diisi. Menentukan bahwa aplikasi ClickOnce harus berjalan segera setelah penginstalan awal dari URL. Defaultnya adalah kotak centang yang dipilih. |
| Izinkan parameter URL diteruskan ke aplikasi | Wajib diisi. Mengizinkan transfer data parameter ke aplikasi ClickOnce melalui string kueri yang ditambahkan ke URL manifes penyebaran. Defaultnya adalah kotak centang yang dikosongkan. |
| Gunakan ekstensi file .deploy | Wajib diisi. Ketika dipilih, semua file dalam manifes aplikasi harus memiliki ekstensi .deploy. Defaultnya adalah kotak centang yang dikosongkan. |
Tab Opsi Pembaruan
Tab Opsi Pembaruan hanya berisi opsi yang disebutkan di sini saat kotak pilihan Jenis Aplikasi pada tab Nama diatur ke Pasang Secara Lokal.
| Elemen Antarmuka Pengguna | Deskripsi |
|---|---|
| Aplikasi ini harus memeriksa pembaruan | Menentukan apakah ClickOnce harus memeriksa pembaruan aplikasi. Jika kotak centang ini tidak dipilih, aplikasi tidak akan memeriksa pembaruan kecuali Anda memperbaruinya secara terprogram dengan menggunakan API di namespace layanan System.Deployment.Application. |
| Pilih kapan aplikasi harus memeriksa pembaruan | Menyediakan dua opsi untuk pemeriksaan pembaruan: - Sebelum aplikasi dimulai. Pemeriksaan pembaruan dilakukan sebelum eksekusi aplikasi. - Setelah aplikasi dimulai. Pemeriksaan pembaruan dimulai setelah bentuk utama aplikasi telah diinisialisasi, dan akan berjalan saat aplikasi dimulai lagi. |
| Memperbarui frekuensi pemeriksaan | Menentukan seberapa sering ClickOnce harus memeriksa pembaruan: - Periksa setiap kali aplikasi berjalan. ClickOnce akan melakukan pemeriksaan pembaruan setiap kali pengguna membuka aplikasi. - Periksa setiap: Pilih interval waktu dan unit (jam, hari, atau minggu) yang harus berlalu sebelum memeriksa pembaruan. |
| Tentukan versi minimum yang diperlukan untuk aplikasi ini | Opsional. Menentukan bahwa versi tertentu dari aplikasi Anda adalah penginstalan yang diperlukan, mencegah pengguna Anda bekerja dengan versi sebelumnya. |
| Versi | Diperlukan jika kotak centang Tentukan versi minimum yang diperlukan untuk aplikasi ini dipilih. Nomor versi yang disediakan harus dalam bentuk N.N.N.N. Hanya nomor bangun utama pertama yang diperlukan. Misalnya, untuk aplikasi versi 1.0, nilai yang valid akan mencakup 1, 1.0, 1.0.0, dan 1.0.0.0. |
Tab Referensi Aplikasi
Tab Referensi Aplikasi berisi bidang yang sama dengan tab Nama yang dijelaskan sebelumnya dalam topik ini. Satu pengecualian adalah bidang berikut.
| Elemen Antarmuka Pengguna | Deskripsi |
|---|---|
| Pilih Manifest | Memungkinkan Anda memilih manifes aplikasi. Semua bidang lain di halaman ini akan terisi saat Anda memilih manifes aplikasi. |
Lihat juga
Saran dan Komentar
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat: https://aka.ms/ContentUserFeedback.
Kirim dan lihat umpan balik untuk