Secara otomatis meningkatkan Versi Minimum yang Diperlukan dalam Aplikasi ClickOnce.

Pengenalan

Deploy ClickOnce membuat publikasi aplikasi .NET menjadi sederhana dan mudah. Salah satu fitur yang bagus adalah memaksa pengguna untuk memperbarui ke versi terbaru yang tersedia. Ini sangat penting pada aplikasi sensitif yang memerlukan segala kemungkinan perbaikan atau patch untuk segera dikirimkan ke pengguna.

Salah satu cara untuk melakukannya adalah dengan mengatur versi minimum yang diperlukan pada halaman publikasi ke versi saat ini. ClickOnce kemudian tahu untuk secara otomatis mengunduh versi terbaru setiap kali pengguna mencoba menjalankan aplikasi. Masalahnya adalah Anda harus mengingat untuk meningkatkan nilai setiap kali melakukan publikasi. Postingan ini akan memudahkan hidup Anda dengan mengotomatisasi peningkatan versi minimum yang diperlukan setiap kali Anda melakukan publikasi.

Kami akan melakukannya dengan menambahkan acara MSBuild ke proyek. Postingan ini berasumsi bahwa Anda tidak memiliki pengalaman dengan MS build dan akan memperkenalkan konsep yang relevan; jika Anda sudah akrab dengan itu, silakan melompat ke Langkah 6 dan menyalin dan menempelkan kode ke file .proj Anda.

Pengenalan ke Editor Proyek

1. di penjelajah solusi, klik kanan pada proyek Anda dan pilih muat proyek.

2. Setelah proyek tidak tersedia, klik kanan lagi dan pilih edit [nama_proyek].csproj.

• Catatan: Ini membuka akses penuh ke set fitur IntelliSense dari MSBuild.

Pengenalan MS Build

3) Notasi MS Build menggunakan properti dengan pasangan kunci / nilai untuk mengekstrak informasi. Kami akan menggunakan notasi $(key) pada bagian implementasi untuk merujuk elemen .proj di Langkah 4.

• contoh: Dengan menggunakan nama properti sebagai alias, Anda dapat menggunakan $(OutputPath) untuk memperoleh nilai untuk elemen <OutputPath> .\bin</OutputPath>. Jadi dalam kasus ini $(OutputPath) = .\bin.

4) Kami akan menggunakan properti berikut yang dihasilkan untuk pengembangan ClickOnce

<MinimumRequiredVersion>1.0.0.6</MinimumRequiredVersion>  <ApplicationRevision>7</ApplicationRevision>  <ApplicationVersion>1.0.0.%2a</ApplicationVersion>  

• Elemen ApplicationVersion menentukan nomor versi. Nilai terakhir dari %2a ditetapkan oleh Visual Studio saat opsi "Otomatis inkrementasi revisi dengan setiap publikasi" dicentang. Dalam hal itu, ia menggantikan plaseholder %2a dengan nilai apa pun yang ada pada elemen ApplicationRevision.
• Elemen MinimumRequiredVersion adalah yang ingin kami tetapkan dengan setiap publikasi sehingga secara otomatis meningkat juga.

5) Tugas MSBuild dapat ditentukan dalam file .proj dan dipanggil selama acara build.

• FormatVersion adalah tugas bawaan untuk .NET 4.0 dan setelahnya yang memformat ApplicationVersion dan ApplicationRevision menjadi satu nomor versi.

Implementasi

6) Salin dan Tempelkan kode berikut ke dalam file proyek yang telah dibuka sebagai elemen anak dari elemen root <Project>:

<Target Name="AutoSetMinimumRequiredVersion"        BeforeTargets="GenerateDeploymentManifest">  <FormatVersion Version="$(ApplicationVersion)"                  Revision="$(ApplicationRevision)">    <Output PropertyName="MinimumRequiredVersion"             TaskParameter="OutputVersion"  />  </FormatVersion>  <FormatVersion Version="$(ApplicationVersion)"                  Revision="$(ApplicationRevision)">    <Output PropertyName="_DeploymentBuiltMinimumRequiredVersion"            TaskParameter="OutputVersion"  />  </FormatVersion></Target>

• Kode ini akan mengambil ApplicationVersion dan ApplicationRevision sebagai parameter dalam tugas Format Version dan akan menyimpan keluarannya dengan menimpa MinimumRequiredVersion dengan versi penerbitan lengkap.

7) Simpan dan muat ulang proyek Anda. Setiap penerbitan ClickOnce sekarang akan secara otomatis diperbarui tanpa peringatan dengan kemampuan untuk melewatinya.

Penutup :

Dalam artikel ini, kita telah membahas cara mengotomatisasi peningkatan versi minimum yang diperlukan untuk setiap publikasi ClickOnce. Dengan menambahkan MSBuild event ke proyek, kita dapat menghindari kesalahan manusia dan secara otomatis mengatur versi minimum yang diperlukan untuk pengguna. Dengan mengikuti langkah-langkah yang dijelaskan di atas, Anda dapat meningkatkan efisiensi dan keandalan pengembangan aplikasi .NET Anda.