金沙官网线上Cordova打包项目热更新

    公司是做CS产品的, 最近分配给我一个活, 要求:
    1. 公司程序启动时, 检测是否有配置文件, 没有的话则按默认值创建一个
    2. 配置文件要加密, 不能让客户随便看到里面的参数
    3. 配置文件要有配套的GUI配置工具, 因为现场实施人员嫌XML配置麻烦

热更新:当用户初次打开app,它会将所有的web内容复制一份到外部存储。此后从外部存储加载web内容,而并不加载打包在app内部的web内容。app每次启动都会连接服务器检查更新并下载新的web内容。如果下载了更新,此次更新内容将会在下次app启动时生效。

    如果只有一个产品需要这个功能, 把每个配置项的读写功能硬编码写到工具里就完事了, 但公司有好几个产品都需要这个, 不得不写一个通用的工具类

安装cordova

需要安装cordova5.0+

cordova plugin add cordova-hot-code-push-plugin

此命令下会方便生成必需的app配置文件
启动本地服务器,监听开发模式下的web内容变更,并直接部署新版本。

    这个工作还解决了两个问题:
    a. 以前设置项都配置在 app.config 里, 每次升级都会覆盖原来的设置, 所以现场人员都必须先将 app.config复制出来.
    b. app.config 里新增了配置项, 现场实施人员必须仔细对比, 将新增项人工放入原来的app.config

Cordova项目快速向导

1、创建新的Cordova项目,并添加android和ios platform;

cordova create TestProject com.won.testproject TestProject

cordova platform add android

2、添加插件:

cordova plugin add cordova-hot-code-push-plugin

3、添加开发扩展

cordova plugin add cordova-hot-code-push-local-dev-addon

4、安装Cordova Hot Code Push命令行客户端

npm install -g cordova-hot-code-push-cli

5、启动本地服务器

cordova-hcp server

6、打开新的控制台,进入到项目根目录运行app

cordova run android

    现在的做法是, 配置文件ConfigSetting.xml并不在安装包中, 所以卸载升级都不会影响它; 程序第一次启动时, 会按默认值生成一个ConfigSetting.xml; 以后程序启动的时候, 假如有新增的配置项, 则将其加入ConfigSetting.xml

更新机制的流程图

1、用户打开你的app。

2、插件初始化,在后台进程启动升级加载器(update loader)。

3、Update loader从config.xml取config-file配置一个url,并从此url加载一段json配置,然后它把这段json配置中的release版本号和当前的app已经安装的进行比较。如果不同进行下一步。

4、update loader使用app配置(application config)中的content_url,去加载清单文件(manifest)。它会找出自上次升级以来,哪些文件需要更新。

5、update loader从content_url下载更新文件。

6、如果一切顺利,发出一个“升级文件已经准备好,可以安装了”的通知。

7、升级文件已安装,app重新进入更新过的页面。

    我把涉及的两个类都放在了一个文件, 这样引入一个文件即可

web内容是如何存储和更新的

每一个Cordova项目下都有一个www目录,这里存放所有的web内容。当cordova build执行后,www的内容会拷贝到对应的platform的www目录下。于是这些文件被打包到了app,app里的文件是只读的,不可改变,所以在app第一次启动的时候,将内置的web内容(www目录)复制到外部存储。我们不想在拷贝过程中阻塞ui。我们还是会先加载app内置的index.html。但是下一次启动和更新,我们就从外部存储加载index.html。

注:如果app外壳需要增加新的Cordova插件或者原生功能,必须重新上架外壳App到应用商店。

金沙官网线上 1金沙官网线上 2

app配置文件

1、chcp.json里面有个release设置,这个指明了web内容的版本。它由命令行客户端自动生成,格式是年月日
每次发布,插件在外部存储自动生成一个以这个release版本为名字的目录,然后把web内容全部放到这里面。release版本号成了url的一部分。

注:修改了一些文件,重新启动了app,但是看到的是旧的页面,原因是插件用的是旧版本的web内容(外部存储中)。若要清除缓存。

2、我们发布新版之后,插件需要下载新的web文件,发生情况如下

  • 1、在外部存储创建一个以新的release版本号为名字的目录
  • 2、在目录里面,又创建了一个update目录
  • 3、所有根据chcp.manifest更新的文件,都被下载到了这个update目录内
  • 4、新的chcp.manifest和chcp.json也被放到了update目录内
  • 5、新的web内容已准备安装

安装更新

  • 1、将使用的release版本目录内的内容拷贝到新的release版面目录下,新建的www目录下
  • 2、从update目录下拷贝新的web内容和配置文件,到www目录。
  • 3、移除update目录
  • 4、加载新的release版本index.html
    using System;
    using System.Collections.Generic;
    using System.Xml.Linq;
    using System.Security.Cryptography;
    using System.IO;
    /// <summary>
    /// 设置项的帮助类
    /// </summary>
    public class ConfigSettingTool
    {
        /// <summary>
        /// 保存读取时, 是否加密解密; 设为false, 可以方便调试
        /// 其实也只能防小白, 随便反编译一下就啥都漏出来了
        /// </summary>
        private static bool isEncrypt = false;

        /// <summary>
        /// 默认的配置文件名
        /// </summary>
        public static readonly string DefaultXmlFileName = "ConfigSetting.xml";

        /// <summary>
        /// 获取XDocument, 解密失败、XML结构不合理, 都会根据模板重新生成一个
        /// </summary>
        /// <param name="xmlFileName"></param>
        /// <param name="msg"></param>
        /// <returns>确保返回如下格式
        /// <?xml version="1.0" encoding="utf-8" standalone="yes"?>
        /// <Setting>
        ///   <SingleSetting></SingleSetting>
        /// </Setting>
        /// </returns>
        public static XDocument GetXDocument(string xmlFileName, out string msg)
        {
            msg = null;
            if (!System.IO.File.Exists(xmlFileName))
            {
                msg = "配置文件不存在, 创建默认配置文件";
                return new XDocument(new XDeclaration("1.0", "utf-8", "yes"), new XElement("Setting", new XElement("SingleSetting")));
            }
            try
            {
                var textContent = System.IO.File.ReadAllText(xmlFileName);
                textContent = isEncrypt ? Decrypt(textContent) : textContent;
                var xdoc = XDocument.Parse(textContent);
                if (xdoc.Root.Name != "Setting")
                {
                    throw new Exception("根节点不是 Setting");
                }
                if (xdoc.Root.Element("SingleSetting") == null)
                {
                    throw new Exception("没有 SingleSetting 节点");
                }
                return xdoc;
            }
            catch
            {
                msg = "配置文件不是标准格式, 删除后, 创建默认配置文件";
                return new XDocument(new XDeclaration("1.0", "utf-8", "yes"), new XElement("Setting", new XElement("SingleSetting")));
            }
        }


        /// <summary>
        /// 将xml信息读出到settingArray, 如果缺少某项设定则增加到xdoc
        /// </summary>
        /// <param name="xdoc"></param>
        /// <param name="settingList">通常就是GlobalSetting.DefaultGlobalSettingArray</param>
        public static void ReadValueToSettingArray(XDocument xdoc, List<ConfigureItemModel> settingArray)
        {
            var singleSettingElement = xdoc.Root.Element("SingleSetting");
            foreach (var configureItem in settingArray)
            {
                configureItem.ErrorMsg = null;
                var element = singleSettingElement.Element(configureItem.Name);
                if (element == null)
                {
                    element = new XElement(configureItem.Name, configureItem.DefaultValue, new XAttribute("Caption", configureItem.Caption), new XAttribute("Description", configureItem.Description), new XAttribute("DefaultValue", configureItem.DefaultValue), new XAttribute("CanBeEmpty", configureItem.CanBeEmpty));
                    singleSettingElement.Add(element);
                }
                configureItem.Value = string.IsNullOrWhiteSpace(element.Value) ? "" : element.Value.Trim();
            }
        }


        /// <summary>
        /// 将xml信息读出到settingArray
        /// </summary>
        /// <param name="xdoc"></param>
        /// <param name="settingList">通常就是GlobalSetting.DefaultGlobalSettingArray</param>
        public static void ReadConfig(XDocument xdoc, out List<ConfigureItemModel> settingList)
        {
            settingList = new List<ConfigureItemModel>();

            var singleSettingElement = xdoc.Root.Element("SingleSetting");
            foreach (var element in singleSettingElement.Elements())
            {
                var captionAttribute = element.Attribute("Caption");
                var caption = captionAttribute != null ? captionAttribute.Value : "";

                var name = element.Name.ToString();
                var value = element.Value.ToString();

                var descriptionAttribute = element.Attribute("Description");
                var description = descriptionAttribute != null ? descriptionAttribute.Value : "";

                var defaultValueAttribute = element.Attribute("DefaultValue");
                var defaultValue = defaultValueAttribute != null ? defaultValueAttribute.Value : "";

                var canBeEmpty = false;
                try
                {
                    canBeEmpty = bool.Parse(element.Attribute("CanBeEmpty").Value);
                }
                catch { }

                var errorMsgAttribute = element.Attribute("ErrorMsg");
                var errorMsg = errorMsgAttribute != null ? errorMsgAttribute.Value : "";


                var configureItem = new ConfigureItemModel(caption, name, defaultValue, description, canBeEmpty) { Value = value, ErrorMsg = errorMsg };
                settingList.Add(configureItem);
            }
        }


        /// <summary>
        /// 尝试解析设置内容 到 目标class
        /// </summary>
        /// <param name="settingList">通常就是GlobalSetting.DefaultGlobalSettingArray, 配置项设置不合理时, 会将错误信息保存到ErrorMsg</param>
        /// <param name="targetSettingClass">通常就是GlobalSetting</param>
        /// <returns>成功, true; 失败: false</returns>
        public static bool TryParseConfig(List<ConfigureItemModel> settingArray, Type targetSettingClass)
        {
            bool isAllSuccess = true;
            foreach (var configureItem in settingArray)
            {
                configureItem.ErrorMsg = null;
                configureItem.Value = string.IsNullOrWhiteSpace(configureItem.Value) ? "" : configureItem.Value.Trim();
                if (configureItem.Value == "" && configureItem.CanBeEmpty == false)
                {
                    configureItem.ErrorMsg += "该项值不能为空, 请手动填写该值;";
                    isAllSuccess = false;
                    continue;
                }

                var property = targetSettingClass.GetProperty(configureItem.Name);
                //如果 targetSettingClass 没有对应的静态属性, 则跳过
                if (property == null)
                {
                    continue;
                }
                object value = null;
                try
                {
                    value = Convert.ChangeType(configureItem.Value, property.PropertyType);
                    property.SetValue(null, value, null);
                }
                catch
                {
                    configureItem.ErrorMsg += configureItem.Value + "不能转换为" + property.PropertyType.Name + ", 请重新填写该值;";
                    isAllSuccess = false;
                    continue;
                }
            }
            return isAllSuccess;
        }


        /// <summary>
        /// 写入
        /// </summary>
        /// <param name="xmlFileName"></param>
        /// <param name="settingList">通常就是GlobalSetting.DefaultGlobalSettingArray</param>
        /// <returns>成功, null</returns>
        public static bool TrySaveToXML(string xmlFileName, List<ConfigureItemModel> settingArray, out string msg)
        {
            msg = null;
            var xdoc = GetXDocument(xmlFileName, out  msg);//原文件读出错误, 忽略即可, 因为settingArray会自动填充
            var singleSettingElement = xdoc.Root.Element("SingleSetting");

            foreach (var configureItem in settingArray)
            {
                var element = singleSettingElement.Element(configureItem.Name);
                if (element == null)
                {
                    element = new XElement(configureItem.Name, configureItem.Value);
                    singleSettingElement.Add(element);
                }
                else
                {
                    element.Value = configureItem.Value ?? "";
                }
                element.RemoveAttributes();
                element.Add(new XAttribute("Caption", configureItem.Caption));
                element.Add(new XAttribute("Description", configureItem.Description));
                element.Add(new XAttribute("DefaultValue", configureItem.DefaultValue));
                element.Add(new XAttribute("CanBeEmpty", configureItem.CanBeEmpty));
                if (!string.IsNullOrWhiteSpace(configureItem.ErrorMsg))
                {
                    element.Add(new XAttribute("ErrorMsg", configureItem.ErrorMsg));
                }
            }


            var textContent = xdoc.ToString();
            textContent = isEncrypt ? Encrypt(textContent) : textContent;
            try
            {
                System.IO.File.WriteAllText(xmlFileName, textContent);
                return true;
            }
            catch (Exception ex)
            {
                msg= "保存失败:" + ex.Message;
                return false;
            }
        }

        #region 加密解密部分
        private static byte[] DESKey = new byte[] { 11, 69, 93, 102, 172, 41, 18, 12 };
        private static byte[] DESIV = new byte[] { 75, 77, 46, 197, 78, 157, 23, 36 };

        /// <summary>
        /// 加密
        /// </summary>
        private static string Encrypt(string source)
        {
            string reValue = "";
            DESCryptoServiceProvider objDes = new DESCryptoServiceProvider();
            MemoryStream objMemoryStream = new MemoryStream();
            CryptoStream objCrytoStream = new CryptoStream(objMemoryStream, objDes.CreateEncryptor(DESKey, DESIV), CryptoStreamMode.Write);
            StreamWriter objStreamWriter = new StreamWriter(objCrytoStream);
            objStreamWriter.Write(source);
            objStreamWriter.Flush();
            objCrytoStream.FlushFinalBlock();
            objMemoryStream.Flush();
            reValue = Convert.ToBase64String(objMemoryStream.GetBuffer(), 0, (int)objMemoryStream.Length);
            return reValue;
        }

        /// <summary>
        /// 解密
        /// </summary>
        private static string Decrypt(string source)
        {
            string reValue = "";
            DESCryptoServiceProvider objDES = new DESCryptoServiceProvider();
            byte[] Input = Convert.FromBase64String(source);
            MemoryStream objMemoryStream = new MemoryStream(Input);
            CryptoStream objCryptoStream = new CryptoStream(objMemoryStream, objDES.CreateDecryptor(DESKey, DESIV), CryptoStreamMode.Read);
            StreamReader objStreamReader = new StreamReader(objCryptoStream);
            reValue = objStreamReader.ReadToEnd();
            return reValue;
        }
        #endregion
    }

    /// <summary>
    /// 单个设置项
    /// </summary>
    /// <remarks>由于XML中不能保存null, 所以所有属性都不会被设置为null</remarks>
    public class ConfigureItemModel
    {
        /// <summary>
        /// 单个设置项
        /// </summary>
        /// <param name="captionParam">显示名称</param>
        /// <param name="nameParam">参数名称</param>
        /// <param name="defaultValueParam">默认值</param>
        /// <param name="descriptionParam">描述, 该项不设定时候, 显示默认值</param>
        /// <param name="canBeEmptyParam">能否为空字符串</param>
        public ConfigureItemModel(string captionParam, string nameParam, string defaultValueParam, string descriptionParam = "", bool canBeEmptyParam = false)
        {
            Caption = captionParam;
            Name = nameParam;
            Description = descriptionParam;
            DefaultValue = defaultValueParam;
            CanBeEmpty = canBeEmptyParam;
        }



        private string caption = "";
        /// <summary>
        /// 显示名称
        /// </summary>
        public string Caption
        {
            get { return caption; }
            set { caption = string.IsNullOrWhiteSpace(value) ? "" : value; }
        }



        private string name = "";
        /// <summary>
        /// 参数名称
        /// </summary>
        public string Name
        {
            get { return name; }
            set { name = string.IsNullOrWhiteSpace(value) ? "" : value; ; }
        }


        private string description = "";
        /// <summary>
        /// 说明, 如果该值没有赋值, 则显示DefaultValue
        /// </summary>
        public string Description
        {
            get { return string.IsNullOrWhiteSpace(description) ? defaultValue : description; }
            set { description = string.IsNullOrWhiteSpace(value) ? "" : value; }
        }


        private string defaultValue = "";
        /// <summary>
        /// 默认值
        /// </summary>
        public string DefaultValue
        {
            get { return defaultValue; }
            set { defaultValue = string.IsNullOrWhiteSpace(value) ? "" : value; }
        }


        /// <summary>
        /// 能否为空字符串
        /// </summary>
        public bool CanBeEmpty { get; set; }

        /// <summary>
        /// 能否为空字符串 的字符串形式
        /// </summary>
        public string CanBeEmptyString { get { return CanBeEmpty ? "是" : "否"; } }


        private string innerValue = "";
        /// <summary>
        /// 值
        /// </summary>
        public string Value
        {
            get { return innerValue; }
            set { innerValue = string.IsNullOrWhiteSpace(value) ? "" : value; ; }
        }


        private string errorMsg = "";
        /// <summary>
        /// 错误信息
        /// </summary>
        public string ErrorMsg
        {
            get { return errorMsg; }
            set { errorMsg = string.IsNullOrWhiteSpace(value) ? "" : value; ; }
        }

    }

Cordova Hot Code Push 命令行客户端

  • 生成chcp.json和chcp.manifest文件
  • 运行本地服务,开发时可以检测更新,并发布新的release版本,使得可以在设备上实时更新web内容
  • 部署你的web内容到外部服务器上

View Code

本地开发扩展

  • 1、web项目做一些改动
  • 2、执行cordova run 启动app
  • 3、稍等一会查看运行结果

本地配置流程

  • 1、添加cordova插件(Hot Code Push Local Development Add-on)
  • 2、启动本地服务cordova-hcp server
  • 3、在你的项目的config.xml文件中的<chcp />块下添加<local-development enabled='true' />
  • 4、启动app

 

Cordova配置项

在根目录下的config.xml文件进行配置

<chcp>
    <config-file url="https://e4c6b23c.ngrok.io/chcp.json" />
</chcp>

自动加载和安装

<chcp>
<auto-install enabled="false" />
<auto-download enabled="false" />
</chcp>

配置文件
chcp.json和chcp.manifest

本文由金沙官网线上发布于编程,转载请注明出处:金沙官网线上Cordova打包项目热更新

您可能还会对下面的文章感兴趣: