zoukankan      html  css  js  c++  java
  • Unity 游戏框架搭建 2019 (二十三、二十四) 备份与版本号&危险的操作

    先列出上一篇的总结:

    1. 要做的事情:
      • 备份:导出文件,并取一个合理的名字。
    2. 遗留问题:
      • 第八个示例与之前的示例代码重复,功能重复。
    3. 约定和规则:
      • 每个示例在 QFramework 目录下创建一个文件夹,文件夹的格式是: 数字.示例的功能
      • 每个示例写一个脚本,脚本中包含可复用的静态方法和 MenuItem 方法。
      • 每写一个示例进行一次导出,导出的文件名后边加上日期和时间,这个功能已经在导出功能里内置了。
    4. 示例分类:
      1. 知识学习&收集
        • API 收集
        • C# 语法实践
      2. 库本身的功能
        • 规则实现
        • 使用流程提供及优化
        • 效率提升(编码体验、逻辑复用)
        • 项目实用工具收集

    我们先解决第一个问题,备份问题。

    文件命名

    导出文件很容易,但是文件的名字就比较有讲究了。现在我们的库呢第一次进行比较大的整理,未来说不定有很多次这样的整理。所以文件命名应该能够体现库的某一个阶段。

    我们目前的命名规是 QFramework_日期_时,这种命名能够体现库的某个时间点,从而我们能够在多个文件之间找到最后一次更新的库。但是这样还不够。如果现在想找到第一篇文章的库,那要去找到第一篇文章写的时间。找到这个库的难度会随着时间越来越困难。不过这种命名已经完成了它的使命,最起码从第一个示例到现在没出现太大的问题。

    但是有新的要求了。因为示例的代码会被删除,这算是代码的比较大的变更了,而且看专栏的童鞋所在的阶段也不同,有的童鞋刚刚看第一篇而有的童鞋已经完结了。所以要考虑库的各个阶段。

    如何表示库的某个阶段呢?

    有一种比较好的方式,就是按照文章的标题命名,比如这篇文章之前的库名字为 QFramework_19_开始整理,或者按照最新的示例名字,比如 QFramwork_13 GameObject 显示、隐藏简化。但是这样的名字过了很久回过头来找文件还是会要凌乱好一会,所以并不合适。

    比较合适的是用版本号,我们生活中使用的软件都有版本号,比如 Unity 5.6.5 或者 2017.2 等等。对于开发者来说版本号已经是比较熟悉的东西了。

    使用版本号命名的文件格式为: QFramework_vX.Y.Z
    X 是主版本号,用于不向前兼容的更新。
    Y 是中间版本,用于可向前兼容的功能性更新。
    Z 是小版本号,用于功能完善和 bug 修复的更新。

    一般都是从 v0.1.1 这个版本开始发布的,但是这个版本呢叫做 mvp 版本,也就是最小可验证版本。我们的库还没有到这个阶段,而且版本号这个东西刚开始用,是用于方便自己记忆的,也是为了做一个备份而已,还不用发布给别人用。所以我们的备份版本为 v0.0.0 。

    还有一点要注意的是,v0.x.y 这个阶段的版本可以不考虑向前兼容。但是如果已经 v0.1.1 了,就要发布出去了,也有用户在使用了,那就要尽可能要做到向前兼容。

    向前兼容的意思是,用户升级版本不必更改 API 的使用。

    开始备份

    在上一小节得到了结论。

    现在,我们要开始着手导出。使用导出工具导出文件,并手动把文件名字命名为 QFramework_v0.0.0。

    这样备份就算完成了。

    可以把它放到网盘或者硬盘里。这样就可以安心整理代码了。

    小结

    版本号算是约定和规则的内容。

    危险的操作

    今天开始,进行逐个示例的整理。

    第一个示例

    先看第一个。

    #if UNITY_EDITOR
    using UnityEditor;
    #endif
    
    using UnityEngine;
    using System;
    
    namespace QFramework
    {
    	public static class LogFileName 
    	{
    		#if UNITY_EDITOR
    		[MenuItem("QFramework/1.生成 unitypackage 名字")]
    		#endif
    		private static void GenerateUnityPackageName()
    		{
    			Debug.Log("QFramework_" + DateTime.Now.ToString("yyyyMMdd_hh"));
    		}
    	}
    }
    

    因为在第八个示例里给提取成方法了,所以这个示例可以直接删除了。

    删除之后的文件结构如下图所示。
    006tNc79gy1fzfr4kvi6sj30mm0c0q4w.jpg

    第二个示例

    代码如下

    #if UNITY_EDITOR
    using UnityEditor;
    #endif
    
    using UnityEngine;
    
    namespace QFramework
    {
    	public static class CopyText2Clipboard
    	{
    #if UNITY_EDITOR
    		[MenuItem("QFramework/2.复制文本到剪切板")]
    #endif
    		private static void CopyText()
    		{
    			GUIUtility.systemCopyBuffer = "要复制的关键字";
    		}
    	}
    }
    

    这个也在第八个示例中提取成方法了,所以这部分也可以直接删了,
    删除之后的文件结构如下图所示:
    006tNc79gy1fzfr4oojhfj30ma0b475x.jpg

    第三个示例

    代码如下:

    using System;
    #if UNITY_EDITOR
    using UnityEditor;
    #endif
    
    using UnityEngine;
    
    namespace QFramework
    {
    	public class GenerateUnityPackageName2ClipBoard 
    	{
    #if UNITY_EDITOR
    		[MenuItem("QFramework/3.生成文件名到剪切板")]
    #endif
    		private static void MenuClicked()
    		{
    			GUIUtility.systemCopyBuffer = "QFramework_" + DateTime.Now.ToString("yyyyMMdd_hh");		
    		}
    	}
    }
    

    这个示例是是原来示例一和示例二的结合,同样在第八个示例中提取成方法了,果断删。

    第四个示例

    using System;
    #if UNITY_EDITOR
    using UnityEditor;
    #endif
    
    using UnityEngine;
    
    namespace QFramework
    {
    	public class ExportUnityPackage : MonoBehaviour
    	{
    #if UNITY_EDITOR
    		[MenuItem("QFramework/4.导出 UnityPackage")]
    		private static void MenuClicked()
    		{
    			var assetPathName = "Assets/QFramework";
    			var fileName = "QFramework_" + DateTime.Now.ToString("yyyyMMdd_hh") + ".unitypackage";
    			AssetDatabase.ExportPackage(assetPathName, fileName, ExportPackageOptions.Recurse);
    		}
    #endif
    	}
    }
    

    同理,果断删。

    第五个示例

    using System;
    #if UNITY_EDITOR
    using UnityEditor;
    #endif
    
    using UnityEngine;
    
    namespace QFramework
    {
    	public class OpenInFolder
    	{
    #if UNITY_EDITOR
    		[MenuItem("QFramework/5.打开所在文件夹")]
    		private static void MenuClicked()
    		{
    			Application.OpenURL("file:///" +  Application.dataPath);
    		}
    #endif
    	}
    }
    

    同理,果断删。

    第六个示例

    using System.IO;
    #if UNITY_EDITOR
    using UnityEditor;
    #endif
    
    using UnityEngine;
    
    namespace QFramework
    {
    	public class ReuseMenuItem : MonoBehaviour
    	{
    #if UNITY_EDITOR
    		[MenuItem("QFramework/6.MenuItem 复用")]
    		private static void MenuClicked()
    		{
    			EditorApplication.ExecuteMenuItem("QFramework/4.导出 UnityPackage");
    			Application.OpenURL("file:///" + Path.Combine(Application.dataPath, "../"));
    		}
    #endif
    	}
    }
    

    同理果断删

    第七个示例

    #if UNITY_EDITOR
    using UnityEditor;
    #endif
    
    using UnityEngine;
    
    namespace QFramework
    {
    	public class CustomShortCut : MonoBehaviour
    	{
    #if UNITY_EDITOR
    		[MenuItem("QFramework/7.自定义快捷键 %e")]
    		private static void MenuClicked()
    		{
    			EditorApplication.ExecuteMenuItem("QFramework/6.MenuItem 复用");
    		}
    #endif
    	}
    }
    

    第七个示例是快捷键功能,不过我们没有在第八个示例中提取成方法,因为快捷键不可以复用。
    而这个是我们目前导出功能的核心代码,所以比较重要,这个就不能删除了。

    通过观察可知,MenuClicked 方法中的对 MenuItem "QFramework/6.MenuItem 复用" 的复用,已经失效了,因为第六个示例被我们删掉了。

    不过没关系,我们在第八个示例中有提取成方法。而使用方法完成导出功能的代码如下:

    		[MenuItem("QFramework/8.总结之前的方法/4.导出 UnityPackage")]
    		private static void MenuClicked4()
    		{
    			ExportPackage("Assets/QFramework",GenerateUnityPackageName() + ".unitypackage");
    		}
    		
    		[MenuItem("QFramework/8.总结之前的方法/5.打开所在文件夹")]
    		private static void MenuClicked5()
    		{
    			OpenInFolder(Application.dataPath);
    		}
    
    		[MenuItem("QFramework/8.总结之前的方法/6.MenuItem 复用")]
    		private static void MenuClicked6()
    		{
    			CallMenuItem("QFramework/8.总结之前的方法/4.导出 UnityPackage");
    			OpenInFolder(Path.Combine(Application.dataPath, "../"));
    		}
    		
    		[MenuItem("QFramework/8.总结之前的方法/7.自定义快捷键")]
    		private static void MenuClicked7()
    		{
    			Debug.Log("%e 意思是快捷键 cmd/ctrl + e");
    		}
    

    不过在写第八个示例的时候还是在用 MenuItem 进行方法的调用,虽然那时候已经学习了调用 public 方法,但是由于 public 方法的运用没有那么纯熟,想不到是很正常的。但是现在不一样了,我们用 public 方法进行非常多的方法设计练习了,所以直接着手整理就好了。

    整理后的第七个示例代码如下:

    using System.IO;
    
    #if UNITY_EDITOR
    using UnityEditor;
    #endif
    
    using UnityEngine;
    
    namespace QFramework
    {
    	public class CustomShortCut : MonoBehaviour
    	{
    #if UNITY_EDITOR
    		[MenuItem("QFramework/7.自定义快捷键 %e")]
    		private static void MenuClicked()
    		{
    			var generatePackageName = PreviousFunctions.GenerateUnityPackageName();
    
    			PreviousFunctions.ExportPackage("Assets/QFramework",generatePackageName + ".unitypackage");
    
    			PreviousFunctions.OpenInFolder(Path.Combine(Application.dataPath, "../"));
    		}
    #endif
    	}
    }
    

    这些方法都是自己实现的,调用起来比较亲切了吧?

    等待编译之后,再按下快捷键 ctrl/cmd + e,就自动导出成功了,感受到满满的成就感。

    不过命名方式还是 QFramework_日期_时,不过没关系,这不算真正的导出,只是测试而已,我们还没有整理结束。整理这个阶段虽然在文章中要写很久,但是实际过程中可能几分钟就整理完了。但是整理这个过程写文章很久的原因是,因为在整理的候笔者的内心戏份非常多,也就是思考经过会非常多。而笔者呢都要把它们展示出来,这样大家理解了这些,就不难自己再造个 QFramework 了甚至更好,而本系列专栏的亮点就是这个。

    到此呢,我们成功了。

    不过以上代码呢,还存在一些问题:

    1. 方法所在的类名比较奇怪,比如 GenerateUnityPackageName 和 ExportPackage 所在的类都是 PreviousFunctions,PreviousFunctions 意思是之前的方法。是为了配合示例的名字而起的。

    2. 菜单栏的显示顺序问题,目前菜单栏的显示顺序有点混乱,如下。

    006tNc79gy1fzfr4v9zutj30du05b77y.jpg
    这个问题存在了好久了,不过没办法,因为一到七个示例已经写好了,当时没办法更改,在整理阶段是改掉这个问题的比较好的时机。

    因为在本篇文章的开头,有说过我们一个一个示例进行整理,所以这两个问题,我们先记录下来,等每个示例都整理了一遍之后,再看看如何解决。

    除了以上存在的这两个问题,我们还做了一个比较危险的操作,就是先删除了第六个示例,等到第七个示例的时候发现功能失效了,还好在第八个示例中我们有相同的功能实现,否则就要去靠记忆力去恢复功能了,或者靠我们 v0.0.0 版本的备份进行恢复。这样会耗费我们额外的精力和时间,是很不值当的。

    基于这个经验,我们在整理代码的时候,要优先确保功能是有效的,然后再进行一些变更或者删除的操作。

    小结

    把以上两个问题记录下来,我们的总结又可以更新了,更新后如下。

    1. 要做的事情:
      • (完成) 备份:导出文件,并取一个合理的名字。
    2. 遗留问题:
      • (完成一部分) 第八个示例与之前的示例代码重复,功能重复。
      • 方法所在类的命名有问题。
      • 菜单栏显示顺序问题。
    3. 约定和规则:
      • 每个示例在 QFramework 目录下创建一个文件夹,文件夹的格式是: 数字.示例的功能
      • 每个示例写一个脚本,脚本中包含可复用的静态方法和 MenuItem 方法。
      • 每写一个示例进行一次导出,导出的文件名后边加上日期和时间,这个功能已经在导出功能里内置了。
      • 每次有 API 变更的时候做一次备份,备份的名字采用 QFramework_vX.Y.Z 格式。
      • 每次进行整理的时候要确保是在功能有效的情况下进行删除和变更。
    4. 示例分类:
      1. 知识学习&收集
        • API 收集
        • C# 语法实践
      2. 库本身的功能
        • 规则实现
        • 使用流程提供及优化
        • 效率提升(编码体验、逻辑复用)
        • 项目实用工具收集

    除了更新了两个问题以外,又在约定和规则中增加了关于备份的规则,描述得很清楚了,这里不多说了。

    今天的内容就这些,拜拜~

    转载请注明地址:凉鞋的笔记:liangxiegame.com

    更多内容

  • 相关阅读:
    常用代码片段
    《资本论》读书笔记(1)谁偷了我的奶酪
    《资本论》读书笔记(0)为了弄清楚经济学规律
    [转]如何理解矩阵乘法的规则
    Nginx编译安装lua-nginx-module
    Supervisor使用教程
    ELK实践(二):收集Nginx日志
    ELK实践(一):基础入门
    MySQL大批量导入导出实践
    Elasticsearch实践(四):IK分词
  • 原文地址:https://www.cnblogs.com/liangxiegame/p/12665002.html
Copyright © 2011-2022 走看看