银河

SKYIV STUDIO
  博客园 :: 首页 :: 博问 :: 闪存 :: :: :: 订阅 订阅 :: 管理 ::
  268 随笔 :: 2 文章 :: 2616 评论 :: 140万 阅读
< 2025年3月 >
日 一 二 三 四 五 六
23 24 25 26 27 28 1
2 3 4 5 6 7 8
9 10 11 12 13 14 15
16 17 18 19 20 21 22
23 24 25 26 27 28 29
30 31 1 2 3 4 5
应用程序的版本升级

我们写了一个应用程序发布后，以后该应用程序有新版本后如何将升级后的版本部署到客户的机器上去呢？

我目前的做法是：

如果这个升级版本是一个不重要的升级版本，比如说仅针对特定客户增加一些新的功能，可以通知这部分客户按以下方法进行升级：

如上图所示，程序当前版本是 1.225 版，而该程序的更新版本 1.226 版已经发布了。这时可以在程序的“关于”对话框中点击“更新”按钮来升级应用程序。

升级完成后弹出一个对话框，点击“确定”按钮退出本程序后，重新启动该应用程序，发现版本已经更新到 1.226 版了：

此时，由于该程序已经是最新版，无法再升级，所以“更新”按钮不可用。

 

如果要发布一个关键的升级版本，可以将程序最低版本设置为刚发布的版本。

在这个例子中，程序最低版本被设置为 1.225，已经发布的程序更新版本是 1.226，而客户机器上的程序当前版本是 1.206。因此，客户在登录系统时，会得到一个“ 本程序已经过时”的提示，要求升级程序的版本。点击“是”按钮后：

同样更新了程序，版本升级到 1.226，如下图所示：

 

上面讲述的是客户如何升级版本。而我们作为程序开发者又如何发布程序的新版本呢？

这非常简单，开发完成一个新版本，并编译成功后，运行这个应用程序，点击“系统 -> 发布应用程序”菜单项，在弹出的“应用程序发布”对话框中点击“发布”按钮就行了。

如果这个版本是关键版本，还可以设置客户端程序所需的最低版本为此版本。

 

这些功能又是如何实现的呢？

首先，我们的客户端应用程序在运行时需要连接一个 Microsoft SQL Server 数据库服务器。在这个 SQL Server 数据库中有以下数据表:

这个 Adm_Configuration 数据表中的一些记录保存了程序最低版本和程序更新版本的值。

 

这个 Adm_ClientRelease 数据表保存了程序更新版本的具体信息，其中 ReleaseData 字段的数据类型是 varbinary(max)，这个字段中保存着要发布的程序更新版本的二进制代码本身。

 

下面是用于读 Adm_Configuration 数据表的存储过程：

?
1
2
3
4
5
6
7
8
9
10
11
CREATE PROCEDURE [dbo].[prAdm_GetConfiguration]
@TheKey nvarchar(50),
@Value nvarchar(128) output
AS
SELECT @Value=Value FROM Adm_Configuration WHERE TheKey = @TheKey;
IF @@Error = 0 AND @@Rowcount <> 1
BEGIN
  DECLARE @ErrorMessage nvarchar(4000);
  SET @ErrorMessage = N'读数据库配置表错, 无此键: ' + @TheKey;
  RAISERROR (@ErrorMessage, 11, 1);
END

 

下面是用于更新 Adm_Configuration 数据表的存储过程：

?
1
2
3
4
5
6
7
8
9
10
11
12
13
CREATE PROCEDURE [dbo].[prAdm_UpdateConfiguration]
@TheKey nvarchar(50),
@Value nvarchar(128)
AS
UPDATE Adm_Configuration
SET Value = @Value
WHERE TheKey = @TheKey;
IF @@Error = 0 AND @@Rowcount <> 1
BEGIN
  DECLARE @ErrorMessage nvarchar(4000);
  SET @ErrorMessage = N'更新数据库配置表错, 无此键: ' + @TheKey;
  RAISERROR (@ErrorMessage, 11, 1);
END

 

下面是读取和更新 Adm_Configuration 数据表的 C# 源程序(数据层)的部分代码：

?
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
namespace Skyiv.Ben.Icbc.Mis.Adm.Data
{
  sealed class Configuration : DbObject
  {
    public Configuration(string newConnectionString) : base(newConnectionString) { }
 
    public string GetValue(string key)
    {
      SqlParameter[] parameters = {
        new SqlParameter("@TheKey", SqlDbType.NVarChar,  50),
        new SqlParameter("@Value" , SqlDbType.NVarChar, 128)
      };
      parameters[0].Value = key;
      parameters[1].Direction = ParameterDirection.Output;
      RunNonQuery("prAdm_GetConfiguration", parameters);
      return (string)parameters[1].Value;
    }
 
    public void Update(string key, string value)
    {
      SqlParameter[] parameters = {
        new SqlParameter("@TheKey", SqlDbType.NVarChar,  50),
        new SqlParameter("@Value" , SqlDbType.NVarChar, 128)
      };
      parameters[0].Value = key;
      parameters[1].Value = value;
      RunNonQuery("prAdm_UpdateConfiguration", parameters);
    }
  }
}

 

下面是读取 Adm_ClientRelease 数据表中要发布的应用程序更新版本的二进制代码的长度的存储过程：

?
1
2
3
4
5
6
7
8
9
CREATE PROCEDURE [dbo].[prAdm_GetClientReleaseLength]
@ReleaseName nvarchar(128),
@ReleaseVersion varchar(128),
@ReleaseLength int output
AS
SELECT @ReleaseLength = DataLength(ReleaseData)
FROM Adm_ClientRelease
WHERE ReleaseName = @ReleaseName
  AND ReleaseVersion = @ReleaseVersion

 

下面是读取 Adm_ClientRelease 数据表中要发布的应用程序更新版本的二进制代码的存储过程：

?
1
2
3
4
5
6
7
8
9
10
11
12
13
CREATE PROCEDURE [dbo].[prAdm_GetClientReleaseData]
@ReleaseName nvarchar(128),
@ReleaseVersion varchar(128),
@UserID int output,
@ReleaseTime datetime output,
@ReleaseData varbinary(max) output
AS
SELECT @UserID      = UserID,
       @ReleaseTime = ReleaseTime,
       @ReleaseData = ReleaseData
FROM Adm_ClientRelease
WHERE ReleaseName = @ReleaseName
  AND ReleaseVersion = @ReleaseVersion

 

下面是更新 Adm_ClientRelease 数据表的存储过程：

?
1
2
3
4
5
6
7
8
9
10
11
CREATE PROCEDURE [dbo].[prAdm_UpdateClientRelease]
@ReleaseName nvarchar(128),
@ReleaseVersion varchar(128),
@UserID int,
@ReleaseData varbinary(max)
AS
DELETE FROM Adm_ClientRelease
WHERE ReleaseName = @ReleaseName;
INSERT INTO Adm_ClientRelease
(ReleaseName, ReleaseVersion, UserID, ReleaseData) VALUES
(@ReleaseName, @ReleaseVersion, @UserID, @ReleaseData);

 

下面是读取和更新 Adm_ClientRelease 数据表的 C# 源程序(数据层)的部分代码：

?
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
namespace Skyiv.Ben.Icbc.Mis.Adm.Data
{
  sealed class ClientRelease : DbObject
  {
    public ClientRelease(string newConnectionString) : base(newConnectionString) { }
 
    public void Update(string name, string version, int userID, byte[] data)
    {
      SqlParameter[] parameters = {
        new SqlParameter("@ReleaseName"   , SqlDbType.NVarChar , 128),
        new SqlParameter("@ReleaseVersion", SqlDbType.VarChar  , 128),
        new SqlParameter("@UserID"        , SqlDbType.Int      ,   4),
        new SqlParameter("@ReleaseData"   , SqlDbType.VarBinary, data.Length)
      };
      parameters[0].Value = name;
      parameters[1].Value = version;
      parameters[2].Value = userID;
      parameters[3].Value = data;
      RunNonQuery("prAdm_UpdateClientRelease", parameters);
    }
 
    public byte[] GetData(string name, string version)
    {
      return GetData(name, version, GetLength(name, version));
    }
 
    public int GetLength(string name, string version)
    {
      SqlParameter[] parameters = {
        new SqlParameter("@ReleaseName"   , SqlDbType.NVarChar, 128),
        new SqlParameter("@ReleaseVersion", SqlDbType.VarChar , 128),
        new SqlParameter("@ReleaseLength" , SqlDbType.Int     ,   4)
      };
      parameters[0].Value = name;
      parameters[1].Value = version;
      parameters[2].Direction = ParameterDirection.Output;
      RunNonQuery("prAdm_GetClientReleaseLength", parameters);
      return (int)parameters[2].Value;
    }
 
    byte[] GetData(string name, string version, int length)
    {
      SqlParameter[] parameters = {
        new SqlParameter("@ReleaseName"   , SqlDbType.NVarChar , 128),
        new SqlParameter("@ReleaseVersion", SqlDbType.VarChar  , 128),
        new SqlParameter("@UserID"        , SqlDbType.Int      ,   4),
        new SqlParameter("ReleaseTime"    , SqlDbType.DateTime ,   8),
        new SqlParameter("@ReleaseData"   , SqlDbType.VarBinary, length)
      };
      parameters[0].Value = name;
      parameters[1].Value = version;
      parameters[2].Direction = ParameterDirection.Output;
      parameters[3].Direction = ParameterDirection.Output;
      parameters[4].Direction = ParameterDirection.Output;
      RunNonQuery("prAdm_GetClientReleaseData", parameters);
      return (byte[])parameters[4].Value;
    }
  }
}

 

下面是更新应用程序的关键的 C# 源程序的部分代码：

?
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
namespace Skyiv.Ben.Icbc.Mis.Adm.Business
{
  sealed class Configuration : BizObject
  {
    public static Version UpdateClientVersion
    {
      get { return new Version(Db.GetValue("Sys_UpdateClientVersion")); }
      set { Db.Update("Sys_UpdateClientVersion", value.ToString()); }
    }
 
    /// <summary>
    /// 检查是否能够进行登录
    /// </summary>
    public static void CheckLogin()
    {
      if (MaxMinutesForTimeDiffServerAndClient > 0
        && Math.Abs((DbCommon.GetDbTime() - DateTime.Now).TotalMinutes) > MaxMinutesForTimeDiffServerAndClient)
        throw new AppException("客户机系统时钟与服务器不一致");
      if (!Online) throw new AppException("数据库维护中, 暂停使用. 请联系管理员");
      if (DbVersion < Pub.MinDbVersion) throw new AppException("数据库当前版本太低, 请联系管理员");
    }
 
    /// <summary>
    /// 判断是否满足进行应用程序更新的条件
    /// </summary>
    /// <returns>是否能够进行更新</returns>
    public static bool CanUpdate()
    {
      if (Pub.ThePrincipal != null) return false;
      Version updateVersion = null;
      try { updateVersion = Configuration.UpdateClientVersion; }
      catch { }
      if (updateVersion == null) return false;
      return updateVersion > Pub.Version;
    }
 
    public static void UpdateApplicatoin()
    {
      if (!CanUpdate()) throw new AppException("错误: 不满足进行更新的条件");
      string version = UpdateClientVersion.ToString();
      byte[] bs = ClientRelease.GetData(Pub.Assembly.GetName().Name, version);
      string assemblyLocation = Pub.Assembly.Location;
      string oldFileName = assemblyLocation + ".OLD";
      File.Delete(oldFileName);
      File.Move(assemblyLocation, oldFileName);
      using (BinaryWriter bw = new BinaryWriter(new FileStream(assemblyLocation, FileMode.CreateNew)))
      {
        bw.Write(bs);
      }
      MessageBox.Show("更新完成，请按“确定”按钮退出本程序", "更新", MessageBoxButtons.OK, MessageBoxIcon.Information);
      Application.Exit();
    }
  }
}

 

下面是“关于”对话框中涉及“更新”按钮的 C# 源程序的部分代码：

?
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
namespace Skyiv.Ben.Icbc.Mis.Window
{
  public partial class AboutForm : Skyiv.Ben.Icbc.Mis.Window.Base2Form
  {
    private void btnUpdate_Click(object sender, EventArgs e)
    {
      btnUpdate.Enabled = false;
      try
      {
        Configuration.UpdateApplicatoin();
      }
      catch (Exception ex)
      {
        MessageBox.Show(Pub.GetMessage(ex), "更新", MessageBoxButtons.OK, MessageBoxIcon.Error);
      }
    }
  }
}

 

下面是“用户登录”对话框的 C# 源程序的部分代码：

?
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
namespace Skyiv.Ben.Icbc.Mis.Window
{
  public partial class LoginForm : Skyiv.Ben.Icbc.Mis.Window.Base2Form
  {
    private void btnSumbit_Click(object sender, EventArgs e)
    {
      btnSubmit.Enabled = false;
      try
      {
        tbxMessage.Text = "";
        // ((MdiWindow)MdiParent).SetTimerInterval();
        if (Pub.ThePrincipal != null)
        {
          spcMain.Enabled = false;
          tbxMessage.Text = "用户已经登录";
          return;
        }
        Configuration.CheckLogin();
        if (Pub.Version < Configuration.ClientVersion)
        {
          if (!Configuration.CanUpdate()) throw new Exception("本程序已经过时, 而且没有新版本可用, 请联系管理员");
          WaitYesNo(Configuration.UpdateApplicatoin, "本程序已经过时, 有新版本可用, 是否进行更新?");
          btnSubmit.Enabled = true;
          return;
        }
        Pub.ThePrincipal = User.ValidateLoginAndSetLogined(tbxUserid.Text.Trim(),
          isUseKeepedPassword ? loginInfo.DefaultPassword : tbxPassword.Text);
        KeepUserInfo();
        if (Pub.ThePrincipal == null) tbxMessage.Text = string.Format("{0}用户不存在 "
          + "或者{0}密码不正确 或者{0}用户已经登录 或者{0}用户已经被禁用", Environment.NewLine);
        else
        {
          tbxMessage.Text = "用户登录成功";
          ((MdiWindow)MdiParent).UpdateStatus();
          ((MdiWindow)MdiParent).AfterLogin();
        }
      }
      catch (Exception ex) { tbxMessage.Text = Pub.GetMessage(ex); }
      btnSubmit.Enabled = true;
    }
  }
}

 

下面是“应用程序发布”对话框的 C# 源程序的部分代码：

?
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
namespace Skyiv.Ben.Icbc.Mis.Window
{
  public partial class ReleaseApplicationForm : Skyiv.Ben.Icbc.Mis.Window.Base2Form
  {
    private void ReleaseApplicationForm_Load(object sender, EventArgs e)
    {
      releaseFileName = Pub.Assembly.Location;
      UpdateStatus();
    }
 
    private void btnFileName_Click(object sender, EventArgs e)
    {
      OpenFileDialog dlg = new OpenFileDialog();
      dlg.Filter = "程序(*.exe;*.dll)|*.exe;*.dll|所有文件(*.*)|*.*";
      if (dlg.ShowDialog() != DialogResult.OK) return;
      releaseFileName = dlg.FileName;
      UpdateStatus();
    }
 
    void UpdateStatus()
    {
      tbxMessage.Text = "";
      DataTable dt = new DataTable();
      dt.Columns.Add("属性", typeof(string));
      dt.Columns.Add("值", typeof(string));
      try
      {
        btnSubmit.Enabled = false;
        AssemblyName myself = Pub.Assembly.GetName();
        Pub.AddRow(dt, "本程序集的名称", myself.Name);
        Pub.AddRow(dt, "本程序集的版本", myself.Version.ToString());
        Pub.AddRow(dt, "所需的最低版本", Configuration.ClientVersion.ToString());
        Pub.AddRow(dt, "上次已经发布的版本", Configuration.UpdateClientVersion.ToString());
        Pub.AddRow(dt, "要发布的程序的信息", "");
        Pub.AddRow(dt, "文件名称", releaseFileName);
        Pub.AddRow(dt, "文件大小", (new FileInfo(releaseFileName)).Length.ToString("N0") + " bytes");
        toRelease = Assembly.LoadFile(releaseFileName).GetName();
        Pub.AddRow(dt, "程序集名称", toRelease.Name);
        Pub.AddRow(dt, "程序集版本", toRelease.Version.ToString());
        if (myself.Name != toRelease.Name) throw new AppException("要发布的程序集名称不正确");
        tbxMessage.Text = "该程序满足发布条件，请按“发布”按钮进行发布";
        btnSubmit.Enabled = true;
      }
      catch (Exception ex) { tbxMessage.Text = Pub.GetMessage(ex); }
      finally { dgvMain.DataSource = dt; }
    }
 
    private void btnSubmit_Click(object sender, EventArgs e)
    {
      tbxMessage.Text = "";
      btnSubmit.Enabled = false;
      try
      {
        using (BinaryReader br = new BinaryReader(new FileStream(releaseFileName, FileMode.Open, FileAccess.Read)))
        {
          byte[] bs = br.ReadBytes((int)br.BaseStream.Length);
          ClientRelease.Update(toRelease.Name, toRelease.Version.ToString(), bs);
          Configuration.UpdateClientVersion = toRelease.Version;
          dgvMain.DataSource = null;
          tbxMessage.Text = "客户端程序发布成功, 版本: " + toRelease.Version.ToString();
        }
      }
      catch (Exception ex) { tbxMessage.Text = Pub.GetMessage(ex); }
    }
 
    private void btnMinClientVersion_Click(object sender, EventArgs e)
    {
      tbxMessage.Text = "";
      btnMinClientVersion.Enabled = false;
      try
      {
        Version version = new Version(tbxMinClientVersion.Text);
        Configuration.ClientVersion = version;
        tbxMinClientVersion.Text = "";
        dgvMain.DataSource = null;
        btnSubmit.Enabled = false;
        tbxMessage.Text = "客户端程序所需的最低版本已经设置为: " + version.ToString();
      }
      catch (Exception ex) { tbxMessage.Text = Pub.GetMessage(ex); }
      btnMinClientVersion.Enabled = true;
    }
  }
}

 

这就是我目前用于更新客户端应用程序的方法。希望对大家有所启发，起到抛砖引玉的作用。

posted on   银河  阅读(4379)  评论(12)  编辑  收藏  举报
编辑推荐：
· 如何编写易于单元测试的代码
· 10年+ .NET Coder 心语，封装的思维：从隐藏、稳定开始理解其本质意义
· .NET Core 中如何实现缓存的预热？
· 从 HTTP 原因短语缺失研究 HTTP/2 和 HTTP/3 的设计差异
· AI与.NET技术实操系列：向量存储与相似性搜索在 .NET 中的实现
阅读排行：
· 周边上新：园子的第一款马克杯温暖上架
· Open-Sora 2.0 重磅开源！
· 分享 3 个 .NET 开源的文件压缩处理库，助力快速实现文件压缩解压功能！
· Ollama——大语言模型本地部署的极速利器
· [AI/GPT/综述] AI Agent的设计模式综述
历史上的今天：
2009-12-24 也谈在 .NET 平台上使用 Scala 语言(续)
点击右上角即可分享
微信分享提示
AI IDE Trae