C# WinForm通用更新器
一、引言
對於C/S架構來說,軟體更新是一個很常用的功能,下面介紹一種非常實用的軟體自動升級方案。
二、示意圖
三、專案說明
3.1、專案建立
新建4個專案,如下所示:
3.2、專案關係
四、LinkTo.Toolkit
LinkTo.Toolkit主要是一些Utility及Helper類檔案,實現轉換擴充套件、檔案讀寫、程序處理等功能。
/// <summary> /// 轉換擴充套件類 /// </summary> public static class ConvertExtension { public static stringConvertExtension.csToString2(this object obj) { if (obj == null) return string.Empty; return obj.ToString(); } public static DateTime? ToDateTime(this string str) { if (string.IsNullOrEmpty(str)) return null; if (DateTime.TryParse(str, outDateTime dateTime)) { return dateTime; } return null; } public static bool ToBoolean(this string str) { if (string.IsNullOrEmpty(str)) return false; return str.ToLower() == bool.TrueString.ToLower(); }public static bool IsNullOrEmpty(this string str) { return string.IsNullOrEmpty(str); } public static int ToInt(this string str) { if (int.TryParse(str, out int intValue)) { return intValue; } return 0; } public static long ToLong(this string str) { if (long.TryParse(str, out long longValue)) { return longValue; } return 0; } public static decimal ToDecimal(this string str) { if (decimal.TryParse(str, out decimal decimalValue)) { return decimalValue; } return 0; } public static double ToDouble(this string str) { if (double.TryParse(str, out double doubleValue)) { return doubleValue; } return 0; } public static float ToFloat(this string str) { if (float.TryParse(str, out float floatValue)) { return floatValue; } return 0; } /// <summary> /// DataRow轉換為實體類 /// </summary> /// <typeparam name="T"></typeparam> /// <param name="dr"></param> /// <returns></returns> public static T ConvertToEntityByDataRow<T>(this DataRow dataRow) where T : new() { Type type = typeof(T); PropertyInfo[] properties = type.GetProperties(); T t = new T(); if (dataRow == null) return t; foreach (PropertyInfo property in properties) { foreach (DataColumn column in dataRow.Table.Columns) { if (property.Name.Equals(column.ColumnName, StringComparison.OrdinalIgnoreCase)) { object value = dataRow[column]; if (value != null && value != DBNull.Value) { if (value.GetType().Name != property.PropertyType.Name) { if (property.PropertyType.IsEnum) { property.SetValue(t, Enum.Parse(property.PropertyType, value.ToString()), null); } else { try { value = Convert.ChangeType(value, (Nullable.GetUnderlyingType(property.PropertyType) ?? property.PropertyType)); property.SetValue(t, value, null); } catch { } } } else { property.SetValue(t, value, null); } } else { property.SetValue(t, null, null); } break; } } } return t; } /// <summary> /// 通用簡單實體型別互轉 /// </summary> public static T ConvertToEntity<T>(this object sourceEntity) where T : new() { T t = new T(); Type sourceType = sourceEntity.GetType(); if (sourceType.Equals(typeof(DataRow))) { //DataRow型別 DataRow dataRow = sourceEntity as DataRow; t = dataRow.ConvertToEntityByDataRow<T>(); } else { Type type = typeof(T); PropertyInfo[] properties = type.GetProperties(); PropertyInfo[] sourceProperties = sourceType.GetProperties(); foreach (PropertyInfo property in properties) { foreach (var sourceProperty in sourceProperties) { if (sourceProperty.Name.Equals(property.Name, StringComparison.OrdinalIgnoreCase)) { object value = sourceProperty.GetValue(sourceEntity, null); if (value != null && value != DBNull.Value) { if (sourceProperty.PropertyType.Name != property.PropertyType.Name) { if (property.PropertyType.IsEnum) { property.SetValue(t, Enum.Parse(property.PropertyType, value.ToString()), null); } else { try { value = Convert.ChangeType(value, (Nullable.GetUnderlyingType(property.PropertyType) ?? property.PropertyType)); property.SetValue(t, value, null); } catch { } } } else { property.SetValue(t, value, null); } } else { property.SetValue(t, null, null); } break; } } } } return t; } /// <summary> /// 通用簡單實體型別互轉 /// </summary> public static List<T> ConvertToEntityList<T>(this object list) where T : new() { List<T> t = new List<T>(); if (list == null) return t; Type sourceObj = list.GetType(); if (sourceObj.Equals(typeof(DataTable))) { var dataTable = list as DataTable; t = dataTable.Rows.Cast<DataRow>().Where(m => !(m.RowState == DataRowState.Deleted || m.RowState == DataRowState.Detached)).Select(m => m.ConvertToEntityByDataRow<T>()).ToList(); } else if (list is IEnumerable) { t = ((IList)list).Cast<object>().Select(m => m.ConvertToEntity<T>()).ToList(); } return t; } /// <summary> /// 轉換為DataTable,如果是集合沒有資料行的時候會拋異常。 /// </summary> /// <param name="list"></param> /// <returns></returns> public static DataTable ConvertToDataTable(this object list) { if (list == null) return null; DataTable dataTable = new DataTable(); if (list is IEnumerable) { var li = (IList)list; //li[0]代表的是一個物件,list沒有行時,會拋異常。 PropertyInfo[] properties = li[0].GetType().GetProperties(); dataTable.Columns.AddRange(properties.Where(m => !m.PropertyType.IsClass || !m.PropertyType.IsInterface).Select(m => new DataColumn(m.Name, Nullable.GetUnderlyingType(m.PropertyType) ?? m.PropertyType)).ToArray()); foreach (var item in li) { DataRow dataRow = dataTable.NewRow(); foreach (PropertyInfo property in properties.Where(m => m.PropertyType.GetProperty("Item") == null)) //過濾含有索引器的屬性 { object value = property.GetValue(item, null); dataRow[property.Name] = value ?? DBNull.Value; } dataTable.Rows.Add(dataRow); } } else { PropertyInfo[] properties = list.GetType().GetProperties(); properties = properties.Where(m => m.PropertyType.GetProperty("Item") == null).ToArray(); //過濾含有索引器的屬性 dataTable.Columns.AddRange(properties.Select(m => new DataColumn(m.Name, Nullable.GetUnderlyingType(m.PropertyType) ?? m.PropertyType)).ToArray()); DataRow dataRow = dataTable.NewRow(); foreach (PropertyInfo property in properties) { object value = property.GetValue(list, null); dataRow[property.Name] = value ?? DBNull.Value; } dataTable.Rows.Add(dataRow); } return dataTable; } /// <summary> /// 實體類公共屬性值複製 /// </summary> /// <param name="entity"></param> /// <param name="target"></param> public static void CopyTo(this object entity, object target) { if (target == null) return; if (entity.GetType() != target.GetType()) return; PropertyInfo[] properties = target.GetType().GetProperties(); foreach (PropertyInfo property in properties) { if (property.PropertyType.GetProperty("Item") != null) continue; object value = property.GetValue(entity, null); if (value != null) { if (value is ICloneable) { property.SetValue(target, (value as ICloneable).Clone(), null); } else { property.SetValue(target, value.Copy(), null); } } else { property.SetValue(target, null, null); } } } public static object Copy(this object obj) { if (obj == null) return null; object targetDeepCopyObj; Type targetType = obj.GetType(); if (targetType.IsValueType == true) { targetDeepCopyObj = obj; } else { targetDeepCopyObj = Activator.CreateInstance(targetType); //建立引用物件 MemberInfo[] memberCollection = obj.GetType().GetMembers(); foreach (MemberInfo member in memberCollection) { if (member.GetType().GetProperty("Item") != null) continue; if (member.MemberType == MemberTypes.Field) { FieldInfo field = (FieldInfo)member; object fieldValue = field.GetValue(obj); if (fieldValue is ICloneable) { field.SetValue(targetDeepCopyObj, (fieldValue as ICloneable).Clone()); } else { field.SetValue(targetDeepCopyObj, fieldValue.Copy()); } } else if (member.MemberType == MemberTypes.Property) { PropertyInfo property = (PropertyInfo)member; MethodInfo method = property.GetSetMethod(false); if (method != null) { object propertyValue = property.GetValue(obj, null); if (propertyValue is ICloneable) { property.SetValue(targetDeepCopyObj, (propertyValue as ICloneable).Clone(), null); } else { property.SetValue(targetDeepCopyObj, propertyValue.Copy(), null); } } } } } return targetDeepCopyObj; } }
public class FileHelper { private readonly string strUpdateFilesPath; public FileHelper(string strDirector) { strUpdateFilesPath = strDirector; } //儲存所有的檔案資訊 private List<FileInfo> listFiles = new List<FileInfo>(); public List<FileInfo> GetAllFilesInDirectory(string strDirector) { DirectoryInfo directory = new DirectoryInfo(strDirector); DirectoryInfo[] directoryArray = directory.GetDirectories(); FileInfo[] fileInfoArray = directory.GetFiles(); if (fileInfoArray.Length > 0) listFiles.AddRange(fileInfoArray); foreach (DirectoryInfo item in directoryArray) { DirectoryInfo directoryA = new DirectoryInfo(item.FullName); DirectoryInfo[] directoryArrayA = directoryA.GetDirectories(); GetAllFilesInDirectory(item.FullName); } return listFiles; } public string[] GetUpdateList(List<FileInfo> listFileInfo) { var fileArrary = listFileInfo.Cast<FileInfo>().Select(s => s.FullName.Replace(strUpdateFilesPath, "")).ToArray(); return fileArrary; } /// <summary> /// 刪除資料夾下的所有檔案但不刪除目錄 /// </summary> /// <param name="dirRoot"></param> public static void DeleteDirAllFile(string dirRoot) { DirectoryInfo directoryInfo = new DirectoryInfo(Path.GetDirectoryName(dirRoot)); FileInfo[] files = directoryInfo.GetFiles("*.*", SearchOption.AllDirectories); foreach (FileInfo item in files) { File.Delete(item.FullName); } } }FileHelper.cs
public static class FileUtility { #region 讀取檔案 /// <summary> /// 讀取檔案 /// </summary> /// <param name="filePath">檔案路徑</param> /// <returns></returns> public static string ReadFile(string filePath) { string result = string.Empty; if (File.Exists(filePath) == false) { return result; } try { using (var streamReader = new StreamReader(filePath, Encoding.UTF8)) { result = streamReader.ReadToEnd(); } } catch (Exception) { result = string.Empty; } return result; } #endregion 讀檔案 #region 寫入檔案 /// <summary> /// 寫入檔案 /// </summary> /// <param name="filePath">檔案路徑</param> /// <param name="strValue">寫入內容</param> /// <returns></returns> public static bool WriteFile(string filePath, string strValue) { try { if (File.Exists(filePath) == false) { using (FileStream fileStream = File.Create(filePath)) { } } using (var streamWriter = new StreamWriter(filePath, true, Encoding.UTF8)) { streamWriter.WriteLine(strValue); } return true; } catch (Exception) { return false; } } #endregion #region 刪除檔案 /// <summary> /// 刪除檔案 /// </summary> /// <param name="filePath">檔案路徑</param> /// <returns></returns> public static bool DeleteFile(string filePath) { try { File.Delete(filePath); return true; } catch (Exception) { return false; } } #endregion 刪除檔案 #region 為檔案新增使用者組的完全控制權限 /// <summary> /// 為檔案新增使用者組的完全控制權限 /// </summary> /// <param name="userGroup">使用者組</param> /// <param name="filePath">檔案路徑</param> /// <returns></returns> public static bool AddSecurityControll2File(string userGroup, string filePath) { try { //獲取檔案資訊 FileInfo fileInfo = new FileInfo(filePath); //獲得該檔案的訪問許可權 FileSecurity fileSecurity = fileInfo.GetAccessControl(); //新增使用者組的訪問許可權規則--完全控制權限 fileSecurity.AddAccessRule(new FileSystemAccessRule(userGroup, FileSystemRights.FullControl, AccessControlType.Allow)); //設定訪問許可權 fileInfo.SetAccessControl(fileSecurity); //返回結果 return true; } catch (Exception) { //返回結果 return false; } } #endregion #region 為資料夾新增使用者組的完全控制權限 /// <summary> /// 為資料夾新增使用者組的完全控制權限 /// </summary> /// <param name="userGroup">使用者組</param> /// <param name="dirPath">資料夾路徑</param> /// <returns></returns> public static bool AddSecurityControll2Folder(string userGroup,string dirPath) { try { //獲取資料夾資訊 DirectoryInfo dir = new DirectoryInfo(dirPath); //獲得該資料夾的所有訪問許可權 DirectorySecurity dirSecurity = dir.GetAccessControl(AccessControlSections.All); //設定檔案ACL繼承 InheritanceFlags inherits = InheritanceFlags.ContainerInherit | InheritanceFlags.ObjectInherit; //新增使用者組的訪問許可權規則--完全控制權限 FileSystemAccessRule usersFileSystemAccessRule = new FileSystemAccessRule(userGroup, FileSystemRights.FullControl, inherits, PropagationFlags.None, AccessControlType.Allow); dirSecurity.ModifyAccessRule(AccessControlModification.Add, usersFileSystemAccessRule, out bool isModified); //設定訪問許可權 dir.SetAccessControl(dirSecurity); //返回結果 return true; } catch (Exception) { //返回結果 return false; } } #endregion }FileUtility.cs
public static class ProcessUtility { #region 關閉程序 /// <summary> /// 關閉程序 /// </summary> /// <param name="processName">程序名</param> public static void KillProcess(string processName) { Process[] myproc = Process.GetProcesses(); foreach (Process item in myproc) { if (item.ProcessName == processName) { item.Kill(); } } } #endregion }ProcessUtility.cs
/// <summary> /// Xml序列化與反序列化 /// </summary> public static class XmlUtility { #region 序列化 /// <summary> /// 序列化 /// </summary> /// <param name="type">型別</param> /// <param name="obj">物件</param> /// <returns></returns> public static string Serializer(Type type, object obj) { MemoryStream Stream = new MemoryStream(); XmlSerializer xml = new XmlSerializer(type); try { //序列化物件 xml.Serialize(Stream, obj); } catch (InvalidOperationException) { throw; } Stream.Position = 0; StreamReader sr = new StreamReader(Stream); string str = sr.ReadToEnd(); sr.Dispose(); Stream.Dispose(); return str; } #endregion 序列化 #region 反序列化 /// <summary> /// 反序列化 /// </summary> /// <param name="type">型別</param> /// <param name="xml">XML字串</param> /// <returns></returns> public static object Deserialize(Type type, string xml) { try { using (StringReader sr = new StringReader(xml)) { XmlSerializer xmldes = new XmlSerializer(type); return xmldes.Deserialize(sr); } } catch (Exception ex) { return ex.Message; } } /// <summary> /// 反序列化 /// </summary> /// <param name="type"></param> /// <param name="xml"></param> /// <returns></returns> public static object Deserialize(Type type, Stream stream) { XmlSerializer xmldes = new XmlSerializer(type); return xmldes.Deserialize(stream); } #endregion 反序列化 }XmlUtility.cs
五、AutoUpdaterTest
5.1、實體類
作用:本地配置AutoUpdateConfig.xml檔案的序列化及反序列化實體物件。
public class AutoUpdateConfig { /// <summary> /// 自動升級模式:當前僅支援HTTP /// </summary> public string AutoUpdateMode { get; set; } /// <summary> /// HTTP自動升級模式時的URL地址 /// </summary> public string AutoUpdateHttpUrl { get; set; } }AutoUpdateConfig.cs
5.2、通用類
作用:應用程式全域性靜態常量。全域性引數都在此設定,方便統一管理。注:客戶端是否檢測更新,也是在此設定預設值。
/// <summary> /// 應用程式全域性靜態常量 /// </summary> public static class GlobalParam { #region 自動更新引數 /// <summary> /// 是否檢查自動更新:預設是true /// </summary> public static string CheckAutoUpdate = "true"; /// <summary> /// 本地自動更新配置XML檔名 /// </summary> public const string AutoUpdateConfig_XmlFileName = "AutoUpdateConfig.xml"; /// <summary> /// 本地自動更新下載臨時存放目錄 /// </summary> public const string TempDir = "Temp"; /// <summary> /// 遠端自動更新資訊XML檔名 /// </summary> public const string AutoUpdateInfo_XmlFileName = "AutoUpdateInfo.xml"; /// <summary> /// 遠端自動更新檔案存放目錄 /// </summary> public const string RemoteDir = "AutoUpdateFiles"; /// <summary> /// 主執行緒名 /// </summary> public const string MainProcess = "AutoUpdaterTest"; #endregion }GlobalParam.cs
作用:應用程式上下文。
/// <summary> /// 應用程式上下文 /// </summary> public class AppContext { /// <summary> /// 客戶端配置檔案 /// </summary> public static AutoUpdateConfig AutoUpdateConfigData { get; set; } }AppContext.cs
作用:應用程式配置。
public class AppConfig { private static readonly object _lock = new object(); private static AppConfig _instance = null; #region 自動更新配置 /// <summary> /// 自動更新配置資料 /// </summary> public AutoUpdateConfig AutoUpdateConfigData { get; set; } private AppConfig() { AutoUpdateConfigData = new AutoUpdateConfig(); } public static AppConfig Instance { get { if (_instance == null) { lock (_lock) { if (_instance == null) { _instance = new AppConfig(); } } } return _instance; } } /// <summary> /// 本地自動更新下載臨時資料夾路徑 /// </summary> public string TempPath { get { return string.Format("{0}\\{1}", Application.StartupPath, GlobalParam.TempDir); } } /// <summary> /// 初始化系統配置資訊 /// </summary> public void InitialSystemConfig() { AutoUpdateConfigData.AutoUpdateMode = AppContext.AutoUpdateConfigData.AutoUpdateMode; AutoUpdateConfigData.AutoUpdateHttpUrl = AppContext.AutoUpdateConfigData.AutoUpdateHttpUrl; } #endregion }AppConfig.cs
5.3、本地配置檔案
作用:配置自動更新模式及相關。
注1:複製到輸出目錄選擇始終複製。
注2:主程式執行時,先讀取此配置更新檔案,然後給AppContext上下文賦值,接著給AppConfig配置賦值。
<?xml version="1.0" encoding="utf-8" ?> <AutoUpdateConfig> <!--自動升級模式:當前僅支援HTTP--> <AutoUpdateMode>HTTP</AutoUpdateMode> <!--HTTP自動升級模式時的URL地址--> <AutoUpdateHttpUrl>http://127.0.0.1:6600/AutoUpdateDir</AutoUpdateHttpUrl> </AutoUpdateConfig>AutoUpdateConfig.xml
5.4、主程式
新建一個Windows窗體MainForm,此處理僅需要一個空白窗體即可,作測試用。
public partial class MainForm : Form { private static MainForm _Instance; /// <summary> /// MainForm主窗體例項 /// </summary> public static MainForm Instance { get { if (_Instance == null) { _Instance = new MainForm(); } return _Instance; } } public MainForm() { InitializeComponent(); } }MainForm.cs
5.5、應用程式主入口點
作用:檢測應用程式是否需要自動更新,如裡需要則檢測遠端服務端的版本號。假如遠端服務端有新版本,則呼叫自動更新器AutoUpdater並向其傳遞4個引數。
internal static class Program { /// <summary> /// 應用程式的主入口點 /// </summary> [STAThread] private static void Main(string[] args) { //嘗試設定訪問許可權 FileUtility.AddSecurityControll2Folder("Users", Application.StartupPath); //未捕獲的異常處理 Application.ThreadException += Application_ThreadException; Application.SetUnhandledExceptionMode(UnhandledExceptionMode.CatchException); AppDomain.CurrentDomain.UnhandledException += CurrentDomain_UnhandledException; //是否檢查自動更新賦值 if (args.Length > 0) { GlobalParam.CheckAutoUpdate = args[0]; } //載入自動更新配置檔案,給上下文AppServiceConfig物件賦值。 var config = AutoUpdateHelper.Load(); AppContext.AutoUpdateConfigData = config; //窗體互斥體 var instance = new Mutex(true, GlobalParam.MainProcess, out bool isNewInstance); if (isNewInstance == true) { if (GlobalParam.CheckAutoUpdate.ToBoolean()) { if (CheckUpdater()) ProcessUtility.KillProcess(GlobalParam.MainProcess); } Application.EnableVisualStyles(); Application.SetCompatibleTextRenderingDefault(false); Application.Run(MainForm.Instance); instance.ReleaseMutex(); } else { MessageBox.Show("已經啟動了一個程式,請先退出。", "提示", MessageBoxButtons.OK, MessageBoxIcon.Error); Application.Exit(); } } /// <summary> /// 自動更新檢測 /// </summary> /// <returns></returns> private static bool CheckUpdater() { if (GlobalParam.CheckAutoUpdate.ToBoolean() == false) return false; #region 檢查版本更新 Stopwatch stopwatch = new Stopwatch(); stopwatch.Start(); bool blFinish = false; AppConfig.Instance.InitialSystemConfig(); var helper = new AutoUpdateHelper(AppConfig.Instance.AutoUpdateConfigData.AutoUpdateMode); string fileVersion = FileVersionInfo.GetVersionInfo(Application.ExecutablePath).FileVersion; long localVersion = 0; long remoteVersion = 0; try { localVersion = fileVersion.Replace(".", "").ToLong(); remoteVersion = helper.GetRemoteAutoUpdateInfoVersion().Replace(".", "").ToLong(); if ((localVersion > 0) && (localVersion < remoteVersion)) { blFinish = true; string autoUpdateConfigXmlPath = helper.WriteLocalAutoUpdateInfoXml(); string autoUpdateInfoXmlPath = Path.Combine(AppConfig.Instance.TempPath, GlobalParam.AutoUpdateInfo_XmlFileName); string argument1 = autoUpdateConfigXmlPath; string argument2 = autoUpdateInfoXmlPath; string argument3 = GlobalParam.MainProcess; string argument4 = GlobalParam.RemoteDir; string arguments = argument1 + " " + argument2 + " " + argument3 + " " + argument4; Process.Start("AutoUpdater.exe", arguments); Application.Exit(); } } catch (TimeoutException) { blFinish = false; } catch (WebException) { blFinish = false; } catch (Exception) { blFinish = false; } return blFinish; #endregion } /// <summary> /// UI執行緒未捕獲異常處理 /// </summary> /// <param name="sender"></param> /// <param name="e"></param> private static void Application_ThreadException(object sender, ThreadExceptionEventArgs e) { string strError = "", strLog = "", strDateInfo = DateTime.Now.ToString() + " 出現應用程式未處理的異常:\r\n"; var error = e.Exception; if (error != null) { strError = strDateInfo + $"異常型別:{error.GetType().Name}\r\n異常訊息:{error.Message}"; strLog = strDateInfo + $"異常型別:{error.GetType().Name}\r\n異常訊息:{error.Message}\r\n堆疊資訊:{error.StackTrace}\r\n來源資訊:{error.Source}\r\n"; } else { strError = $"Application ThreadException:{e}"; } WriteLog(strLog); MessageBox.Show(strError, "系統錯誤", MessageBoxButtons.OK, MessageBoxIcon.Error); } /// <summary> /// 非UI執行緒未捕獲異常處理 /// </summary> /// <param name="sender"></param> /// <param name="e"></param> private static void CurrentDomain_UnhandledException(object sender, UnhandledExceptionEventArgs e) { string strError = "", strLog = "", strDateInfo = DateTime.Now.ToString() + " 出現應用程式未處理的異常:\r\n"; if (e.ExceptionObject is Exception error) { strError = strDateInfo + $"異常訊息:{error.Message}"; strLog = strDateInfo + $"異常訊息:{error.Message}\r\n堆疊資訊:{error.StackTrace}"; } else { strError = $"Application UnhandledError:{e}"; } WriteLog(strLog); MessageBox.Show(strError, "系統錯誤", MessageBoxButtons.OK, MessageBoxIcon.Error); } /// <summary> /// 寫入日誌 /// </summary> /// <param name="strLog"></param> private static void WriteLog(string strLog) { string dirPath = @"Log\MainProcess", fileName = DateTime.Now.ToString("yyyy-MM-dd") + ".txt"; string strLine = "----------------------------------------------------------------------------------------------------"; FileUtility.WriteFile(Path.Combine(dirPath, fileName), strLog); FileUtility.WriteFile(Path.Combine(dirPath,fileName), strLine); } }Program.cs
六、AutoUpdater
6.1、實體類
作用:配置自動更新模式及相關。
/// <summary> /// 自動更新配置資訊 /// </summary> public class AutoUpdateConfig { /// <summary> /// 自動升級模式:當前僅支援HTTP /// </summary> public string AutoUpdateMode { get; set; } /// <summary> /// HTTP自動升級模式時的URL地址 /// </summary> public string AutoUpdateHttpUrl { get; set; } }AutoUpdateConfig.cs
作用:自動更新內容資訊。
/// <summary> /// 自動更新內容資訊 /// </summary> [Serializable] public class AutoUpdateInfo { /// <summary> /// 新版本號 /// </summary> public string NewVersion { get; set; } /// <summary> /// 更新日期 /// </summary> public string UpdateTime { get; set; } /// <summary> /// 更新內容說明 /// </summary> public string UpdateContent { get; set; } /// <summary> /// 更新檔案列表 /// </summary> public List<string> FileList { get; set; } }AutoUpdateInfo.cs
6.2、通用類
作用:應用程式全域性靜態常量。全域性引數都在此設定,方便統一管理。
/// <summary> /// 應用程式全域性靜態常量 /// </summary> public static class GlobalParam { /// <summary> /// 呼叫程式主執行緒名稱 /// </summary> public static string MainProcess = string.Empty; /// <summary> /// 遠端更新程式所在資料夾的名稱 /// </summary> public static string RemoteDir = string.Empty; }GlobalParam.cs
6.3、Window窗體
新建一個Windows窗體HttpStartUp。
public partial class HttpStartUp : Form { private bool _blSuccess = false; private string _autoUpdateHttpUrl = null; private AutoUpdateInfo _autoUpdateInfo = null; public HttpStartUp(string autoUpdateHttpUrl, AutoUpdateInfo autoUpdateInfo) { InitializeComponent(); _autoUpdateHttpUrl = autoUpdateHttpUrl; _autoUpdateInfo = autoUpdateInfo; _blSuccess = false; } /// <summary> /// 窗體載入事件 /// </summary> /// <param name="sender"></param> /// <param name="e"></param> private void Main_Load(object sender, EventArgs e) { Text = GlobalParam.MainProcess + "-更新程式"; lblUpdateTime.Text = _autoUpdateInfo.UpdateTime; lblNewVersion.Text = _autoUpdateInfo.NewVersion; txtUpdate.Text = _autoUpdateInfo.UpdateContent; } /// <summary> /// 立即更新 /// </summary> /// <param name="sender"></param> /// <param name="e"></param> private void btnRun_Click(object sender, EventArgs e) { ProcessUtility.KillProcess(GlobalParam.MainProcess); btnRun.Enabled = false; btnLeave.Enabled = false; Thread thread = new Thread(() => { try { var downFileList = _autoUpdateInfo.FileList.OrderByDescending(s => s.IndexOf("\\")); foreach (var fileName in downFileList) { string fileUrl = string.Empty, fileVaildPath = string.Empty; if (fileName.StartsWith("\\")) { fileVaildPath = fileName.Substring(fileName.IndexOf("\\")); } else { fileVaildPath = fileName; } fileUrl = _autoUpdateHttpUrl.TrimEnd(new char[] { '/' }) + @"/" + GlobalParam.RemoteDir + @"/" + fileVaildPath.Replace("\\", "/"); //替換檔案目錄中的路徑為網路路徑 DownloadFileDetail(fileUrl, fileName); } _blSuccess = true; } catch (Exception ex) { BeginInvoke(new MethodInvoker(() => { throw ex; })); } finally { BeginInvoke(new MethodInvoker(delegate () { btnRun.Enabled = true; btnLeave.Enabled = true; })); } if (_blSuccess) { Process.Start(GlobalParam.MainProcess + ".exe"); BeginInvoke(new MethodInvoker(delegate () { Close(); Application.Exit(); })); } }) { IsBackground = true }; thread.Start(); } private void DownloadFileDetail(string httpUrl, string filename) { string fileName = Application.StartupPath + "\\" + filename; string dirPath = GetDirPath(fileName); if (!Directory.Exists(dirPath)) { Directory.CreateDirectory(dirPath); } HttpWebRequest request = (HttpWebRequest)WebRequest.Create(httpUrl); HttpWebResponse response = (HttpWebResponse)request.GetResponse(); Stream httpStream = response.GetResponseStream(); long totalBytes = response.ContentLength; if (progressBar != null) { BeginInvoke(new MethodInvoker(delegate () { lblDownInfo.Text = "開始下載..."; progressBar.Maximum = (int)totalBytes; progressBar.Minimum = 0; })); } FileStream outputStream = new FileStream(fileName, FileMode.Create); int bufferSize = 2048; int readCount; byte[] buffer = new byte[bufferSize]; readCount = httpStream.Read(buffer, 0, bufferSize); int allByte = (int)response.ContentLength; int startByte = 0; BeginInvoke(new MethodInvoker(delegate () { progressBar.Maximum = allByte; progressBar.Minimum = 0; })); while (readCount > 0) { outputStream.Write(buffer, 0, readCount); readCount = httpStream.Read(buffer, 0, bufferSize); startByte += readCount; BeginInvoke(new MethodInvoker(delegate () { lblDownInfo.Text = "已下載:" + startByte / 1024 + "KB/" + "總長度:"+ allByte / 1024 + "KB" + " " + " 檔名:" + filename; progressBar.Value = startByte; })); Application.DoEvents(); Thread.Sleep(5); } BeginInvoke(new MethodInvoker(delegate () { lblDownInfo.Text = "下載完成。"; })); httpStream.Close(); outputStream.Close(); response.Close(); } public static string GetDirPath(string filePath) { if (filePath.LastIndexOf("\\") > 0) { return filePath.Substring(0, filePath.LastIndexOf("\\")); } return filePath; } /// <summary> /// 暫不更新 /// </summary> /// <param name="sender"></param> /// <param name="e"></param> private void btnLeave_Click(object sender, EventArgs e) { if (MessageBox.Show("確定要放棄此次更新嗎?", "提示", MessageBoxButtons.YesNo, MessageBoxIcon.Question) == DialogResult.Yes) { Process.Start(GlobalParam.MainProcess + ".exe", "false"); Close(); Application.Exit(); } } }HttpStartUp.cs
七、AutoUpdateXmlBuilder
7.1、實體類
作用:自動更新內容資訊。
/// <summary> /// 自動更新內容資訊 /// </summary> [Serializable] public class AutoUpdateInfo { /// <summary> /// 新版本號 /// </summary> public string NewVersion { get; set; } /// <summary> /// 更新日期 /// </summary> public string UpdateTime { get; set; } /// <summary> /// 更新內容說明 /// </summary> public string UpdateContent { get; set; } /// <summary> /// 更新檔案列表 /// </summary> public List<string> FileList { get; set; } }AutoUpdateInfo.cs
7.2、通用類
作用:應用程式全域性靜態常量。全域性引數都在此設定,方便統一管理。
/// <summary> /// 應用程式全域性靜態常量 /// </summary> public static class GlobalParam { /// <summary> /// 遠端自動更新資訊XML檔名 /// </summary> public const string AutoUpdateInfo_XmlFileName = "AutoUpdateInfo.xml"; /// <summary> /// 遠端自動更新目錄 /// </summary> public const string AutoUpdateDir = "AutoUpdateDir"; /// <summary> /// 遠端自動更新檔案存放目錄 /// </summary> public const string RemoteDir = "AutoUpdateFiles"; /// <summary> /// 主執行緒名 /// </summary> public const string MainProcess = "AutoUpdaterTest"; }GlobalParam.cs
7.3、Window窗體
1)新建一個Windows窗體Main。
public partial class Main : Form { //自動更新目錄路徑 private static readonly string AutoUpdateDirPath = Application.StartupPath + @"\" + GlobalParam.AutoUpdateDir; //自動更新資訊XML檔案路徑 private static readonly string AutoUpdateInfoXmlPath = Path.Combine(AutoUpdateDirPath, GlobalParam.AutoUpdateInfo_XmlFileName); //自動更新檔案目錄路徑 private static readonly string RemoteDirPath = Application.StartupPath + @"\" + GlobalParam.AutoUpdateDir + @"\" + GlobalParam.RemoteDir; public Main() { InitializeComponent(); } /// <summary> /// 窗體載入 /// </summary> /// <param name="sender"></param> /// <param name="e"></param> private void Main_Load(object sender, EventArgs e) { if (!Directory.Exists(RemoteDirPath)) { Directory.CreateDirectory(RemoteDirPath); } LoadBaseInfo(); LoadDirectoryFileList(); } /// <summary> /// 重新整理 /// </summary> /// <param name="sender"></param> /// <param name="e"></param> private void btnRefresh_Click(object sender, EventArgs e) { LoadBaseInfo(); LoadDirectoryFileList(); } /// <summary> /// 初始化 /// </summary> private void LoadBaseInfo() { dtUpdateTime.Text = DateTime.Now.ToString("yyyy-MM-dd"); txtNewVersion.Text = GetMainProcessFileVersion(); CreateHeaderAndFillListView(); } /// <summary> /// 獲取主程式檔案版本 /// </summary> /// <returns></returns> private string GetMainProcessFileVersion() { string fileVersion = ""; if (File.Exists(RemoteDirPath + "\\" + GlobalParam.MainProcess + ".exe")) //如果更新中有主程式檔案 { FileVersionInfo info = FileVersionInfo.GetVersionInfo(RemoteDirPath + "\\" + GlobalParam.MainProcess + ".exe"); fileVersion = info.FileVersion; } return fileVersion; } /// <summary> /// 新增ListView列名 /// </summary> private void CreateHeaderAndFillListView() { lstFileList.Columns.Clear(); int lvWithd = lstFileList.Width; ColumnHeader columnHeader; //First Header columnHeader = new ColumnHeader { Text = "#", Width = 38 }; lstFileList.Columns.Add(columnHeader); //Second Header columnHeader = new ColumnHeader { Text = "檔名", Width = (lvWithd - 38) / 2 }; lstFileList.Columns.Add(columnHeader); //Third Header columnHeader = new ColumnHeader { Text = "更新路徑", Width = (lvWithd - 38) / 2 }; lstFileList.Columns.Add(columnHeader); } /// <summary> /// 載入目錄檔案列表 /// </summary> private void LoadDirectoryFileList() { if (!Directory.Exists(RemoteDirPath)) { Directory.CreateDirectory(RemoteDirPath); } FileHelper fileHelper = new FileHelper(RemoteDirPath); var fileArrary = fileHelper.GetUpdateList(fileHelper.GetAllFilesInDirectory(RemoteDirPath)).ToList(); var lastFile = fileArrary.FirstOrDefault(s => s == GlobalParam.MainProcess + ".exe"); //exe作為最後的檔案更新,防止更新過程中出現網路錯誤,導致檔案未全部更新。 if (lastFile != null) { fileArrary.Remove(lastFile); fileArrary.Add(lastFile); } PopulateListViewWithArray(fileArrary.ToArray()); } /// <summary> /// 使用路徑字元陣列填充列表 /// </summary> /// <param name="strArray"></param> private void PopulateListViewWithArray(string[] strArray) { lstFileList.Items.Clear(); if (strArray != null) { //只過濾根目錄下的特殊檔案 strArray = strArray.Where(s => !new string[] { GlobalParam.AutoUpdateInfo_XmlFileName }.Contains(s.Substring(s.IndexOf('\\') + 1))).ToArray(); for (int i = 0; i < strArray.Length; i++) { ListViewItem lvi = new ListViewItem { Text = (i + 1).ToString() }; int intStart = strArray[i].LastIndexOf('\\') + 1; lvi.SubItems.Add(strArray[i].Substring(intStart, strArray[i].Length - intStart)); lvi.SubItems.Add(strArray[i]); lstFileList.Items.Add(lvi); } } } /// <summary> /// 生成更新XML檔案 /// </summary> /// <param name="sender"></param> /// <param name="e"></param> private void btnBuild_Click(object sender, EventArgs e) { if (string.IsNullOrEmpty(txtNewVersion.Text)) { MessageBox.Show("更新版本號不能為空。", "提示", MessageBoxButtons.OK, MessageBoxIcon.Information); txtNewVersion.Focus(); return; } if (string.IsNullOrEmpty(txtMainProcessName.Text)) { MessageBox.Show("主程序名不能為空。", "提示", MessageBoxButtons.OK, MessageBoxIcon.Information); txtMainProcessName.Focus(); return; } AutoUpdateInfo info = new AutoUpdateInfo() { NewVersion = txtNewVersion.Text.Trim(), UpdateTime = dtUpdateTime.Value.ToString("yyyy-MM-dd"), UpdateContent = txtUpdateContent.Text, FileList = lstFileList.Items.Cast<ListViewItem>().Select(s => s.SubItems[2].Text).ToList() }; string xmlValue = XmlUtility.Serializer(typeof(AutoUpdateInfo), info); using (StreamWriter sw = new StreamWriter(AutoUpdateInfoXmlPath)) { sw.WriteLine(xmlValue); sw.Flush(); sw.Close(); } MessageBox.Show("生成成功。", "提示", MessageBoxButtons.OK, MessageBoxIcon.Information); } /// <summary> /// 開啟本地目錄 /// </summary> /// <param name="sender"></param> /// <param name="e"></param> private void btnOpen_Click(object sender, EventArgs e) { ProcessStartInfo psi = new ProcessStartInfo("Explorer.exe") { Arguments = AutoUpdateDirPath }; Process.Start(psi); } }Main.cs
2)在bin\Debug\下新建一個AutoUpdateDir資料夾,然後再在AutoUpdateDir下新建一個AutoUpdateFiles資料夾。
3)在AutoUpdaterTest中,將程式集版本及檔案版本都改成1.0.0.1並重新生成,接著將AutoUpdaterTest.exe拷貝到AutoUpdateFiles下,最後將程式集版本及檔案版本都改回1.0.0.0。
4)此時執行AutoUpdateXmlBuilder,點選生成更新XML檔案即打包成功。程式會自動在AutoUpdateDir下生成打包資訊檔案AutoUpdateInfo.xml。
八、遠端服務端配置
注:此處為本機測試。
1)在某個碟符如E盤下新建一個AutoUpdate資料夾,將AutoUpdateXmlBuilder打包資料夾AutoUpdateDir拷貝到AutoUpdate資料夾下。
2)在IIS中新建一個網站,對應的虛擬目錄為E:\AutoUpdate,同時將埠設定為6600。
3)執行AutoUpdaterTest,如出現自動更新器即代表成功。