C# 自动更新(基于FTP)

效果

启动软件后,会自动读取所有的 FTP 服务器文件,然后读取本地需要更新的目录,进行匹配,将 FTP 服务器的文件同步到本地

Winform 界面

一、前言

在去年,我写了一个 C# 版本的自动更新,这个是根据配置文件 + 网站文件等组成的框架,以实现本地文件的新增、替换和删除,虽然实现了自动更新的功能,但用起来过于复杂,代码量也比较大,改起来困难,后面我就想能不能弄一个 FTP 服务器进行版本的更新。平时客户端版本的更新,一般就两个需求,1.将服务器端最新的文件同步到本地,2.版本回退,如果当前版本有bug,可以随意的切换想要的版本号,这个功能在 FTP 服务器实现起来也比较简单,在 FTP 服务器里新建一个对应版本的文件夹,把对应版本的文件放进去就好了,想切换那个版本,就把 FTP 链接地址指向这个文件夹,然后同步到本地就好了,知道了这个原理,那么就来实现吧。

二、功能的实现

新建一个 winform 项目,界面如下

这几个控件分别是文件名,文件下载的进度,下载进度的百分比,具体信息可以在源码中查看

form1 代码

using System;
using System.Collections.Generic;
using System.IO;
using System.Linq;
using System.Security.Cryptography;
using System.Threading.Tasks;
using System.Windows.Forms;

namespace update
{
    public partial class Form1 : Form
    {
        public Form1()
        {
            InitializeComponent();
        }

        #region 字段

        /// <summary>
        /// 需要和FTP服务器对比的本地路径
        /// </summary>
        private string TargetPath = string.Empty;

        /// <summary>
        /// FTP文件夹列表  
        /// </summary>
        private List<string> FTPDirectoryList = new List<string>();
        /// <summary>
        /// FTP文件列表 
        /// </summary>
        private List<FileInfo> FTPFileList = new List<FileInfo>();

        /// <summary>
        /// 本地文件夹列表
        /// </summary>
        private List<string> LocalDirectorysList = new List<string>();
        /// <summary>
        /// 本地文件列表
        /// </summary>
        private List<FileInfo> LocalFilesList = new List<FileInfo>();
        /// <summary>
        /// 本地文件的黑名单(不参与到更新)
        /// </summary>
        private List<string> LocalFileBlacklist = new List<string>();

        /// <summary>
        /// ftp 和本地匹配结果,需要处理的数据
        /// </summary>
        private UpdateResultInfo UpdateResultData = null;

        //读取本地文件完成
        private bool ReadLocalEnd = false;
        //读取ftp文件完成
        private bool ReadFTPEnd = false;

        #endregion

        private void Form1_Load(object sender, EventArgs e)
        {
            TargetPath = Application.StartupPath;
            FTPManager.DownloadProgressAction = DownProgressUpdate;

            //添加黑名单
            AddBlacklist();
            //读取配置文件
            ReadConfiguration();

            Start();
        }

        private async void Start()
        {
            //刚启动就读取,会导致界面无法显示
            await Task.Delay(500);

            //读取 FTP 所有的文件
            ReadFTPFile();
            //读取本地文件
            ReadLocalFile();
        }

        /// <summary>
        /// 添加黑名单
        /// </summary>
        private void AddBlacklist()
        {
            LocalFileBlacklist.Add("update.exe");
            LocalFileBlacklist.Add("update.exe.config");
            LocalFileBlacklist.Add("update.pdb");
        }

        /// <summary>
        /// 显示下载进度
        /// </summary>
        /// <param name="fileName"></param>
        /// <param name="totalBytes"></param>
        /// <param name="totalDownloadBytes"></param>
        /// <param name="percent"></param>
        public void DownProgressUpdate(string fileName, double totalBytes, double totalDownloadBytes, int percent)
        {
            //Console.WriteLine("文件名:{0},总进度:{1},下载进度:{2},百分比:{3}", fileName, totalBytes, totalDownloadBytes, percent);

            FormControlExtensions.InvokeIfRequired(this, () =>
            {
                Label_FileName.Text = fileName;
                Label_Speed.Text = string.Format("{0} / {1}", GetSize(totalBytes), GetSize(totalDownloadBytes));
                Label_Percentage.Text = string.Format("{0}%", percent);
                ProgressBar_DownProgress.Value = percent;
            });
        }

        /// <summary>
        /// 读取 FTP 所有的文件
        /// </summary>
        private void ReadFTPFile()
        {
            FTPDirectoryList.Clear();
            FTPFileList.Clear();

            Console.WriteLine("开始读取 FTP 文件");

            Task.Run(() =>
            {
                Tuple<List<string>, List<FileInfo>> tuple = FTPManager.GetAllFileList();
                FTPDirectoryList = tuple.Item1;
                FTPFileList = tuple.Item2;
                ReadLocalEnd = true;
       
                Console.WriteLine("读取FTP所有的文件完成");

                ReadEnd();
            });
        }

        /// <summary>
        /// 读取本地文件
        /// </summary>
        private void ReadLocalFile()
        {
            LocalDirectorysList.Clear();
            LocalFilesList.Clear();

            Console.WriteLine("开始读取本地文件");

            GetDirectoryFileList(TargetPath);
            ReadFTPEnd = true;
    
            Console.WriteLine("读取本地文件完成");

            ReadEnd();
        }

        /// <summary>
        /// 获取一个文件夹下的所有文件和文件夹
        /// </summary>
        /// <param name="path"></param>
        private void GetDirectoryFileList(string path)
        {
            DirectoryInfo directory = new DirectoryInfo(path);
            FileSystemInfo[] filesArray = directory.GetFileSystemInfos();

            if (filesArray.Length == 0) return;

            foreach (var item in filesArray)
            {
                if (item.Attributes == FileAttributes.Directory)
                {
                    //添加文件夹
                    //string dir = item.FullName.Replace(path, "");
                    LocalDirectorysList.Add(item.FullName);
                    GetDirectoryFileList(item.FullName);
                }
                else
                {
                    //文件名
                    string fileName = Path.GetFileName(item.FullName);

                    //是否在黑名单中
                    if (!LocalFileBlacklist.Any(p => p == fileName))
                    {
                        FileInfo fileType = new FileInfo();
                        fileType.FileName = fileName;
                        //fileType.LastModified = File.GetLastWriteTime(item.FullName);
                        //fileType.FileSize = new System.IO.FileInfo(item.FullName).Length;
                        fileType.Path = item.FullName;
                        fileType.Hash = GetHashs(item.FullName);
                        LocalFilesList.Add(fileType);
                    }
                }
            }
        }

        /// <summary>
        /// 读取配置文件
        /// </summary>
        private void ReadConfiguration()
        {
            string ftpUrl = ConfigHelper.GetAppConfig("FtpUrl");
            string ftpUser = ConfigHelper.GetAppConfig("FtpUser");
            string ftpPassword = ConfigHelper.GetAppConfig("FtpPassword");
            
            if(string.IsNullOrEmpty(ftpUrl) )
            {
                Console.WriteLine("FTP IP地址为空");
                return;
            }
            if(string.IsNullOrEmpty(ftpUser) )
            {
                Console.WriteLine("FTP 用户名地址为空");
                return;
            }
            if(string.IsNullOrEmpty(ftpPassword) )
            {
                Console.WriteLine("FTP 用户密码地址为空");
                return;
            }
            FTPManager.ftpUrl = ftpUrl;
            FTPManager.user = ftpUser; 
            FTPManager.password = ftpPassword;
            Console.WriteLine("读取配置文件完成");
        }

        /// <summary>
        /// 获取字节大小
        /// </summary>
        /// <param name="size"></param>
        /// <returns></returns>
        private string GetSize(double size)
        {
            String[] units = new String[] { "B", "KB", "MB", "GB", "TB", "PB" };
            double mod = 1024.0;
            int i = 0;
            while (size >= mod)
            {
                size /= mod;
                i++;
            }
            return Math.Round(size) + units[i];
        }

        /// <summary>
        /// 获取文件的哈希值
        /// </summary>
        /// <param name="path"></param>
        /// <returns></returns>
        private string GetHashs(string path)
        {
            //创建一个哈希算法对象
            using (HashAlgorithm hash = HashAlgorithm.Create())
            {
                using (FileStream file1 = new FileStream(path, FileMode.Open))
                {
                    //哈希算法根据文本得到哈希码的字节数组
                    byte[] hashByte1 = hash.ComputeHash(file1);
                    //将字节数组装换为字符串
                    return BitConverter.ToString(hashByte1);
                }
            }
        }

        /// <summary>
        /// 所有的文件读取完成后
        /// </summary>
        private void ReadEnd()
        {
            if (!ReadLocalEnd || !ReadFTPEnd)
                return;

            Console.WriteLine("所有的文件读取完成");
            FormControlExtensions.InvokeIfRequired(this, () => ProgressBar_DownProgress.Visible = true );

            Task.Run(() =>
            {
                UpdateResultData = UpdateMatching.DetectUpdates(FTPDirectoryList, FTPFileList, LocalDirectorysList, LocalFilesList, FTPManager.ftpUrl, TargetPath);
                UpdateMatching.StartUpdate(UpdateResultData);
                Console.WriteLine("所有文件更新完成");
                //FormControlExtensions.InvokeIfRequired(this, () => ProgressBar_DownProgress.Visible = true);
            });
        }
    }
}

软件在启动后,就会自动进行文件匹配,判断那些文件是否需要更新,但在做之前,需要先做几件事

1.update.exe 这个文件是放在更新目录的,而且当前已经打开,不能自己删除自己吧,所有有关 update.exe 相关的文件都不能参与到更新中,这个就是本地更新黑名单的效果。

2.读取配置文件

ftp 的链接地址,用户名和密码,这些都是不能在代码中写死的,我一般写在配置文件中,如果你不想你的用户名和密码别人看见,也比较简单,单独写一个程序集,将用户名,密码等写到一个类中,然后用我的教程中的 C# 代码混淆加密的方式把 dll 加密就行了,在 visual studio 中也是看不到的,而且,反编译也是没用的,但是在程序运行时,是能正常的读出来的。

<?xml version="1.0" encoding="utf-8" ?>
<configuration>
    <startup> 
        <supportedRuntime version="v4.0" sku=".NETFramework,Version=v4.8" />
    </startup>

	<appSettings>
		<add key="FtpUrl" value="ftp://127.0.0.1//"/>
		<add key="FtpUser" value="user"/>
		<add key="FtpPassword" value="123456"/>
		<add key="MainProgram" value="CNCMain"/>
	</appSettings>
</configuration>

3.读取 FTP 文件列表

在这里,我一次性将 FTP 链接中对应目录的所有文件的 文件名,文件大小,文件哈希值,文件路径,文件夹,包含子目录文件,都读出来了,这样就没必要 和之前一样,单独去搞配置文件了。

4.读取本地文件

读取本地文件是为了判断那些文件需要替换,删除,那些文件夹需要创建,删除,总之就是让客户端这边和服务器一样,没有多余的文件,也能够保持文件的一致性。

5.匹配更新

有了 FTP 服务器对应目录的文件数据,也有了本地目录的所有文件数据,接下来就是进行匹配了,找出那些 需要创建的文件夹,需要删除的文件夹,需要更新的文件,需要删除的文件,这里匹配文件的用法依然使用哈希值匹配。

using System.Collections.Generic;

internal class UpdateResultInfo
{
    /// <summary>
    /// 需要创建的文件夹列表
    /// </summary>
    public List<string> CreateFolderList { get; set; } = new List<string>();
    /// <summary>
    /// 需要删除的文件夹列表
    /// </summary>
    public List<string> DeleteFolderList { get; set; } = new List<string>();

    /// <summary>
    /// 本地需要更新的文件列表
    /// </summary>
    public List<DownloadFileInfo> LocalUpdateFileList { get;set; } = new List<DownloadFileInfo>();
    /// <summary>
    /// 本地需要删除的文件列表
    /// </summary>
    public List<FileInfo> LocalDeleteFileList { get; set; } = new List<FileInfo>();
}

这里会单独写一个方法来得出想要的结果,然后由单独的方法去处理这些结果。

下面是控制台效果,不喜欢也可以去掉,下面是本地没有需要更新的文件,这会把 ftp 服务器对应目录的所有文件下载下来

界面效果

6.版本的切换

版本的切换也比较简单,在 ftp 链接中改对应的目录就行了

比如:

ftp://127.0.0.1//v1.0.1
ftp://127.0.0.1//v1.0.2
ftp://127.0.0.1//v1.0.3

代码我并没有全部贴出来,有需要的可以去支持一下我,在此谢谢了,有源码有疑问的可以私信我,我看到后会回复的。

源码地址:点击下载

结束

end

猜你喜欢

转载自blog.csdn.net/qq_38693757/article/details/131223450