एसिंक्रोनस C # प्रोग्राम अपडेट

शुभ दिन, दोस्तों!

अपने पिछले लेखों में ( एक बार और दो बार ) मैंने कार्यक्रम के स्वचालित अपडेट फ़ंक्शन के कार्यान्वयन और कई कमियों के बारे में लिखा था, इसे सुधारने के साथ-साथ कोड को और अधिक "अनुकूल", या कुछ और बनाने का निर्णय लिया गया था। लाइनों को छोटा करके और प्रारूप को अनुकूलित करके, मैं बेहतर एसिंक्रोनस फ़ाइल डाउनलोड प्राप्त करने में सक्षम था, व्यावहारिक रूप से अद्यतन फ़ाइल को खराब करने की संभावना को समाप्त कर रहा था (चेकसम की जाँच), और कई नए विकास भी जोड़े। वहां मैं खुद के पुनर्वास के लिए एक और प्रयास कर रहा हूं।



मेरे काम में, मेरा प्रोग्राम निष्पादन योग्य फ़ाइल के समान फ़ोल्डर में स्थित निम्न फ़ाइलों का उपयोग करता है:

• Ionic.Zip.dll - संग्रह डीबग फ़ाइलों का कार्यान्वयन;
• LanguagePack.dll - अपनी स्वयं की लाइब्रेरी जिसमें वांछित भाषा में फॉर्म तत्वों के नाम का अनुवाद है;
• Newtonsoft.Json.dll - JSON लाइब्रेरी;
• ProcessesLibrary.dll - इसकी अपनी लाइब्रेरी जिसमें प्रक्रियाओं की एक सूची होती है;
• restart.exe - उपयोगिता मुख्य अनुप्रयोग को पुनरारंभ करने के लिए;
• updater.exe - मुख्य एप्लिकेशन को अपडेट करने के लिए उपयोगिता
• settings.xml - सेटिंग्स फ़ाइल।

कोड के पिछले संस्करणों में, प्रत्येक फ़ाइल को अलग से डाउनलोड किया गया था, जिससे डाउनलोड के लिए प्रतीक्षा समय शुरू होने से बहुत असुविधा होती थी। चेकसम की जांच के लिए भी कोई फ़ंक्शन नहीं था, जो उनके उपयोग की सुरक्षा को बहुत अच्छी तरह से प्रभावित नहीं करता था।
तो उस कोड में क्या बदलाव आया है जो मैंने उसी कहानी के बारे में तीसरा लेख लिखने का फैसला किया है?

सबसे पहले, सर्वर पर स्थित संस्करण । Xml फ़ाइल बदल गई:

<?xml version="1.0" encoding="utf-8"?> <version> <myprogram checksumm="05b2b2eb79c4f11834b25095acc047f9">1.0.7.88</myprogram> <updater checksumm="aaef7c8a1f9437138acfc80fb2c4354b">1.0.0.7</updater> <restart checksumm="d3904a3fe5ff2ab3a0f246bdde293345">1.0.1.9</restart> <processesLibrary checksumm="2b999c9eb771374c87490f5dee5da9ec">1.0.1.10</processesLibrary> <languagePack checksumm="d5724f066cea211eb5f0efb6365ba0c9">1.0.0.4</languagePack> <Newtonsoft.Json checksumm="5619e5d4b93e544c7b9174c062f6c40b">6.0.1.17001</Newtonsoft.Json> <Ionic.Zip checksumm="6ded8fcbf5f1d9e422b327ca51625e24">1.9.1.8</Ionic.Zip> </version> 

परिवर्तन

जैसा कि आपने नोटिस किया था, इसके पिछले संस्करण की तुलना में, चेकसम विशेषता को जोड़ा गया था, जिसमें एक विशिष्ट फ़ाइल का एमडी 5 योग है।

कोड का उपयोग करते समय, अनावश्यक के रूप में, बैकग्राउंड वर्कर वर्ग के घटकों को टास्क के पक्ष में हटा दिया गया था, और निम्न पंक्तियों को वर्ग परिभाषा में जोड़ा गया था:

 debug debug = new debug(); private string url = @"http://mysite/"; private ProgressBar downloadPercent = null; 

डीबग वर्ग बेहतर लॉगिंग के लिए फ़ाइल में त्रुटियां लिखता है। लेकिन इस लेख में हम उसके बारे में बात नहीं करेंगे।
यूआरएल स्ट्रिंग पैरामीटर उस साइट पर फ़ोल्डर में पथ सेट करता है जिसमें हमारी सभी फाइलें हैं। इससे पहले, प्रत्येक फ़ाइल के लिए दिए गए पथ को पंजीकृत किया गया था - लेकिन व्यर्थ में।
मुख्य प्रोग्राम फ़ाइल के लिए डाउनलोड अद्यतनों के प्रतिशत को प्रदर्शित करने के लिए ProgressBar वर्ग के डाउनलोडरेंट घटक का उपयोग किया जाता है।

अगला, चेक () अद्यतन प्रक्रिया शुरू करने का कार्य निम्न में से घटा दिया गया:

 public void Check(bool launcher = false, ProgressBar report = null) { try { XmlDocument doc = new XmlDocument(); doc.Load(url + "version.xml"); if (!File.Exists("settings.xml")) { using (var client = new WebClient()) Task.Factory.StartNew(() => client.DownloadFile(new Uri(url + "settings.xml"), "settings.xml")).Wait(); } //     ,    if (File.Exists("settings.xml") && new FileInfo("settings.xml").Length == 0) { File.Delete("settings.xml"); } if (File.Exists("Ionic.Zip.dll") && new FileInfo("Ionic.Zip.dll").Length == 0) { File.Delete("Ionic.Zip.dll"); } if (File.Exists("restart.exe") && new FileInfo("restart.exe").Length == 0) { File.Delete("restart.exe"); } if (File.Exists("updater.exe") && new FileInfo("updater.exe").Length == 0) { File.Delete("updater.exe"); } if (File.Exists("Newtonsoft.Json.dll") && new FileInfo("Newtonsoft.Json.dll").Length == 0) { File.Delete("Newtonsoft.Json.dll"); } if (File.Exists("ProcessesLibrary.dll") && new FileInfo("ProcessesLibrary.dll").Length == 0) { File.Delete("ProcessesLibrary.dll"); } if (File.Exists("LanguagePack.dll") && new FileInfo("LanguagePack.dll").Length == 0) { File.Delete("LanguagePack.dll"); } if (File.Exists("launcher.update") && new FileInfo("launcher.update").Length == 0) { File.Delete("launcher.update"); } if (!launcher) { var task1 = Task.Factory.StartNew(() => DownloadFile("Ionic.Zip.dll", doc.GetElementsByTagName("Ionic.Zip")[0].InnerText, doc.GetElementsByTagName("Ionic.Zip")[0].Attributes["checksumm"].InnerText)); var task2 = Task.Factory.StartNew(() => DownloadFile("restart.exe", doc.GetElementsByTagName("restart")[0].InnerText, doc.GetElementsByTagName("restart")[0].Attributes["checksumm"].InnerText)); var task6 = Task.Factory.StartNew(() => DownloadFile("LanguagePack.dll", doc.GetElementsByTagName("languagePack")[0].InnerText, doc.GetElementsByTagName("languagePack")[0].Attributes["checksumm"].InnerText)); Task.WaitAll(task1, task2, task6); } 

अब सब कुछ और अधिक विस्तार से।
बहुत शुरुआत में, हम जांचते हैं कि क्या प्रोग्राम सेटिंग्स फ़ाइल ( settings.xml ) मौजूद है और यदि यह मौजूद नहीं है, तो इसे डाउनलोड करें
आगे (कभी-कभी ऐसा हुआ), यदि फाइलें शून्य लंबाई की हैं, तो हम उन्हें भी हटा देते हैं। हमें टूटी हुई फ़ाइलों की आवश्यकता क्यों है। सही है ना?
उसके बाद, एक जांच है कि क्या फ़ंक्शन शुरू होने पर लॉन्चर पैरामीटर सेट किया गया था। कोड निष्पादन के अनुक्रम को निर्धारित करने के लिए, साथ ही समाधान का अनुकूलन करने की आवश्यकता है, क्योंकि मुख्य विंडो के रूप को प्रारंभ करते समय उपरोक्त सूची से केवल 3 फाइलें आवश्यक हैं। यदि लॉन्चर पैरामीटर झूठा है , तो हम मुख्य फाइल (Ionic.Zip.dll, LanguagePack.dll, restart.exe) डाउनलोड करते हैं, और फिर मुख्य प्रोग्राम कोड को इनिशियलाइज़ करते हैं।

मुख्य कार्यक्रम के कोड और सहायक फ़ाइलों के अपडेट की जांच करने के लिए, सार्वजनिक फॉर्म 1 () में मुख्य फॉर्म के कोड में, InitializeComponent () फ़ंक्शन को कॉल करने के बाद ; हमारे अद्यतन वर्ग में एक कॉल जोड़ें। हां, वर्ग, चूंकि इसका सभी कोड अलग से (सुविधा के लिए) रखा गया है।

 update_launcher update = new update_launcher(); update.Check(true, pbDownload); 

कॉल अपडेट में। चेक (सही, प्रगतिबेर 1 ); हम, पहले पैरामीटर के रूप में, हम संकेत देते हैं कि अब सहायक फ़ाइलों के अद्यतन और आवेदन की मुख्य फ़ाइल के अपडेट की जाँच की जाएगी। दूसरे के रूप में, हम प्रगतिबार की ओर इशारा करते हैं, जो मुख्य फ़ाइल के प्रतिशत लोड को प्रदर्शित करने के लिए जिम्मेदार है।

चूंकि हमने पैरामीटर लांचर = सही निर्दिष्ट किया है , प्रोग्राम निम्नलिखित कोड को चेक () फ़ंक्शन (कोड को इंगित किए गए जारी रखने ) से निष्पादित करेगा:

  else { try { var task3 = Task.Factory.StartNew(() => DownloadFile("updater.exe", doc.GetElementsByTagName("updater")[0].InnerText, doc.GetElementsByTagName("updater")[0].Attributes["checksumm"].InnerText)); var task4 = Task.Factory.StartNew(() => DownloadFile("Newtonsoft.Json.dll", doc.GetElementsByTagName("Newtonsoft.Json")[0].InnerText, doc.GetElementsByTagName("Newtonsoft.Json")[0].Attributes["checksumm"].InnerText)); var task5 = Task.Factory.StartNew(() => DownloadFile("ProcessesLibrary.dll", doc.GetElementsByTagName("processesLibrary")[0].InnerText, doc.GetElementsByTagName("processesLibrary")[0].Attributes["checksumm"].InnerText)); Task.WaitAll(task3, task4, task5); if (File.Exists("launcher.update") && new Version(FileVersionInfo.GetVersionInfo("launcher.update").FileVersion) > new Version(Application.ProductVersion)) { Process.Start("updater.exe", "launcher.update \"" + Application.ProductName + ".exe\""); Process.GetCurrentProcess().CloseMainWindow(); } else if (new Version(Application.ProductVersion) < new Version(doc.GetElementsByTagName("version")[0].InnerText)) { if (report != null) { downloadPercent = report; downloadPercent.Value = 0; } Task.Factory.StartNew(() => DownloadFile("launcher.exe", doc.GetElementsByTagName("version")[0].InnerText, doc.GetElementsByTagName("version")[0].Attributes["checksumm"].InnerText, "launcher.update", true)).Wait(); } else if (File.Exists("launcher.update")) { File.Delete("launcher.update"); } } catch (Exception ex1) { debug.Save("public void Check(bool launcher = false)", "launcher.update", ex1.Message); } } } catch (Exception ex) { debug.Save("public void Check(bool launcher = false)", "", ex.Message); } } 

हमारे यहाँ क्या है? System.Threading.Tasks का उपयोग करके जोड़ना न भूलें; , हम उन्हें चर नाम ( कार्य 3 , टास्क 4 , टास्क 5 ) असाइन करके टास्क ऑब्जेक्ट को इनिशियलाइज़ करते हैं।
जो लोग जानते नहीं हैं, टास्क क्लास एसिंक्रोनस ऑपरेशन करने के लिए थ्रेड्स पर एक आवरण है, जिससे डेवलपर को यह भूल जाने का मौका मिलता है कि थ्रेड कैसे बनाएं, इसे शुरू करें और अंत में इसे नष्ट कर दें।
सामान्य तौर पर, हमारे मामले में, हम DownloadFile () फ़ंक्शन को एक पैरामीटर के रूप में सेट करते हैं ; इसे आवश्यक मापदंडों को पारित करना, अर्थात्:

 private void DownloadFile(string filename, string xmlVersion, string xmlChecksumm, string localFile = null, bool showStatus = false) 

जहां:

• फ़ाइल नाम - सर्वर पर स्थित फ़ाइल का नाम;
• xmlVersion - सर्वर पर फ़ाइल का संस्करण ( version.xml से पढ़ें);
• xmlChecksumm - फ़ाइल के चेकसम वाला एक स्ट्रिंग ( संस्करण से पढ़ें। xml );
• लोकलफाइल - एक वैकल्पिक पैरामीटर, अगर फ़ाइल को स्थानीय रूप से सहेजा जाता है, तो वह साइट पर स्थित नाम से भिन्न होता है (हमारे मामले में इसका उपयोग केवल मुख्य एप्लिकेशन फ़ाइल में अपडेट डाउनलोड करते समय किया जाता है);
• showStatus एक वैकल्पिक पैरामीटर है जिसका उपयोग यह निर्धारित करने के लिए किया जाता है कि फ़ाइल अपलोड स्थिति प्रगति में प्रदर्शित होगी या नहीं। केवल LocalFile पैरामीटर के साथ संयोजन में उपयोग किया जाता है।

फंक्शन टास्क.फैक्टरी। सार्टन्यू (); आपको किसी भी प्रक्रिया को अतुल्यकालिक रूप से चलाने की अनुमति देता है। यह निर्धारित करने के लिए कि सभी फ़ाइलों को कब डाउनलोड किया गया था, टास्क.ऐटएटल फ़ंक्शन (टास्क 3, टास्क 4, टास्क 5) का उपयोग किया गया था; , सभी निर्दिष्ट तत्वों में कोड निष्पादन की प्रतीक्षा में।
इसलिए, अतिरिक्त फ़ाइलों को डाउनलोड करने के बाद, आप मुख्य एक के अपडेट की जांच करने के लिए जा सकते हैं, और चूंकि अपडेट पहले से ही डाउनलोड किए जा सकते हैं, पहले हम स्थानीय अपडेट फ़ाइल के अस्तित्व और संस्करण की जांच करते हैं, अगर यह मौजूद है।

 if (File.Exists("launcher.update") && new Version(FileVersionInfo.GetVersionInfo("launcher.update").FileVersion) > new Version(Application.ProductVersion)) 

चेकसम की जांच के लिए कोई कार्य क्यों नहीं है, मैं आपको थोड़ी देर बाद बताऊंगा, लेकिन अभी के लिए इस पर वापस आते हैं।
यदि अपडेट फ़ाइल (" लॉन्चर.अपडेट ") मौजूद है और इसका संस्करण अधिक हाल ही में है, तो हम पैरामीटर में फ़ाइल नामों को पास करके अतिरिक्त updater.exe सुविधा चलाते हैं (ऊपर कोड देखें)।

इसके अलावा, यदि अपडेट फाइल गायब है या उसका संस्करण ताजा नहीं है, तो हम निम्नलिखित पत्राचार की जांच का उपयोग करेंगे, जहां हम साइट पर संस्करण के साथ सॉफ्टवेयर संस्करण की जांच करते हैं:

 if (new Version(Application.ProductVersion) < new Version(doc.GetElementsByTagName("version")[0].InnerText)) 

यदि अधिक हाल का संस्करण मिला है, तो इसे डाउनलोड करने के लिए आगे बढ़ें। और फिर इस बारे में बाद में।
तीसरी स्थिति तब मान्य होती है जब पहले दो पूरी नहीं होती हैं, अर्थात्, यदि फ़ाइल मौजूद है और इसका पुराना संस्करण है, तो हम इसे हटा देते हैं।

फंक्शन कॉल डिबग.सेव (); किसी फ़ाइल में त्रुटि हैंडलर के बारे में जानकारी सहेजता है ताकि आप इसे बाद में पढ़ सकें। सॉफ़्टवेयर अद्यतनों के लिए, यह कोड वास्तव में मायने नहीं रखता है, लेकिन इसे रखा जाता है ताकि लोग यह न पूछें कि "आपके पास कैच (अपवाद) {} क्यों है , यह il faut नहीं है।" यहाँ यह है।
आगे बढ़ो।

डाउनलोड

निजी फ़ंक्शन DownloadFile () फ़ाइलों को डाउनलोड करने के लिए ज़िम्मेदार है ; ऊपर वर्णित मापदंडों का एक सेट, और उसका बिल्ली कोड आप नीचे देख सकते हैं:

 private void DownloadFile(string filename, string xmlVersion, string xmlChecksumm, string localFile = null, bool showStatus = false) { localFile = localFile != null ? localFile : filename; if (File.Exists(localFile) && new FileInfo(localFile).Length == 0) { File.Delete(localFile); } try { if ((File.Exists(localFile) && new Version(FileVersionInfo.GetVersionInfo(localFile).FileVersion) < new Version(xmlVersion)) || !File.Exists(localFile)) { using (var client = new WebClient()) { try { if (showStatus && downloadPercent != null) { client.DownloadProgressChanged += new DownloadProgressChangedEventHandler(ProgressChanged); } client.DownloadFileAsync(new Uri(url + filename), localFile); if (!Checksumm(localFile, xmlChecksumm) && File.Exists(localFile)) { File.Delete(localFile); } } catch (Exception ex) { debug.Save("private void DownloadFile(string filename, string xmlVersion, string xmlChecksumm)", "Filename: " + filename + Environment.NewLine + "Localname: " + (localFile != null ? localFile : "null") + Environment.NewLine + "URL: " + url, ex.Message); } } } } catch (Exception ex1) { debug.Save("private void DownloadFile(string filename, string xmlVersion, string xmlChecksumm)", "Filename: " + filename + Environment.NewLine + "Localname: " + (localFile != null ? localFile : "null") + Environment.NewLine + "URL: " + url, ex1.Message); } } 

बहुत शुरुआत में, स्थानीय मान पैरामीटर में पारित मूल्य की जाँच की जाती है और यदि पैरामीटर अशक्त है , तो हम इसे फ़ाइल नाम पैरामीटर के मान को असाइन करते हैं। उसके बाद, फ़ाइल आकार के लिए जाँच की जाती है और यदि यह शून्य है, तो इसे हटा दें।
अगला, फ़ंक्शन का मुख्य भाग शुरू होता है - हम फ़ाइल के अस्तित्व और उसके संस्करण की प्रासंगिकता की जांच करते हैं और यदि फ़ाइल गायब है या एक नया संस्करण पाया जाता है, तो हम डाउनलोड करने के लिए आगे बढ़ते हैं, अन्यथा, हम तदनुसार छोड़ते हैं।
डाउनलोड करने से ठीक पहले, हम शोस्टैटस पैरामीटर की जांच करते हैं, जिसे हमें डाउनलोड स्थिति के प्रदर्शन को सक्षम / अक्षम करना होगा। मैं एक उदाहरण पर विचार करूंगा जब स्थिति की आवश्यकता होगी। इसलिए, यदि शोस्टैटस पैरामीटर अशक्त नहीं है और डाउनलोडपार्टेंट पैरामीटर सेट है, तो हम WebClient () वर्ग के क्लाइंट ऑब्जेक्ट के लिए ProgressChanged () फ़ंक्शन को कनेक्ट करते हैं ; डाउनलोड की स्थिति को ट्रैक करने के लिए।
इसके बाद एसिंक्रोनस रूप से DownloadFileAsync () फ़ाइल डाउनलोड करने की प्रक्रिया है। फ़ाइल डाउनलोड की गई, आगे क्या?
और फिर हम डाउनलोड की गई फ़ाइल के चेकसम को वर्कशॉप में साइट पर value.xml फ़ाइल के साथ चेकसमम () फ़ंक्शन के मापदंडों में देखते हैं, जिसमें स्थानीय फ़ाइल का नाम और साइट से md5 कैश युक्त स्ट्रिंग संचारित होता है।

 private bool Checksumm(string filename, string summ) { try { if (File.Exists(filename) && summ != null && new FileInfo(filename).Length > 0) using (FileStream fs = File.OpenRead(filename)) { System.Security.Cryptography.MD5 md5 = new System.Security.Cryptography.MD5CryptoServiceProvider(); byte[] fileData = new byte[fs.Length]; fs.Read(fileData, 0, (int)fs.Length); byte[] checkSumm = md5.ComputeHash(fileData); return BitConverter.ToString(checkSumm) == summ.ToUpper() ? true : false; } else return false; } catch (Exception ex) { debug.Save("private bool Checksumm(string filename, string summ)", "Filename: " + filename, ex.Message); return false; } } 

यदि स्थानीय फ़ाइल का चेकसम साइट पर मूल्य से मेल खाता है, तो फ़ंक्शन सही है , अन्यथा तर्क की कार्रवाई से।
लेकिन DownloadFile () के बारे में क्या? यदि चेकसम सही है, तो हम फ़ंक्शन को समाप्त करते हैं, यदि नहीं, तो फ़ाइल को हटा दें।

अभी तक क्या संकेत नहीं दिया गया है? उम ... ओह हाँ! डाउनलोड स्थिति प्रसंस्करण समारोह:

 Private void ProgressChanged(object sender, DownloadProgressChangedEventArgs e) { downloadPercent.Value = e.ProgressPercentage; } 

और, मैं लगभग भूल गया, निर्दिष्ट कोड में, मुख्य प्रोग्राम का अपडेट लॉन्चर.अपडेट फाइल में डाउनलोड किया गया है। अद्यतन का आवेदन कार्यक्रम की अगली शुरुआत में स्वचालित रूप से किया जाएगा, अर्थात, उपयोगकर्ता को कोई सूचना प्राप्त नहीं होगी, जो, मेरी राय में, कार्यक्रम की "मित्रता" को बढ़ाती है।

निष्कर्ष

यहां, वास्तव में, संपूर्ण अपडेट कोड, और यह देखते हुए कि इसे एक अलग वर्ग में रखा गया है, इसे आसानी से किसी भी तरह की परियोजना में इस्तेमाल किया जा सकता है, इसके अपडेट के स्रोत और फाइलों की संख्या और नामों का संकेत देता है।
PS: डिबग क्लास में, जब बचत होती है, तो 3 पैरामीटर सेट होते हैं - उनके द्वारा कोड में सही जगह की खोज करना आसान होता है।

यदि किसी को इसकी आवश्यकता है, तो नवंबर 2017 से रिपॉजिटरी को यहां पोस्ट किया गया है।

सादर, एंड्रयू हेलडर!