大家好,欢迎来到IT知识分享网。
在上一篇我们整理到了第七个示例,我们今天再接着往下整理。我们来看第八个示例:
#if UNITY_EDITOR
using UnityEditor;
#endif
using UnityEngine;
using System;
using System.IO;
namespace QFramework
{
public class PreviousFunctions : MonoBehaviour
{
public static string GenerateUnityPackageName()
{
return "QFramework_" + DateTime.Now.ToString("yyyyMMdd_hh");
}
public static void CopyText(string text)
{
GUIUtility.systemCopyBuffer = text;
}
public static void OpenInFolder(string folderPath)
{
Application.OpenURL("file:///" + folderPath);
}
#if UNITY_EDITOR
public static void CallMenuItem(string menuPath)
{
EditorApplication.ExecuteMenuItem(menuPath);
}
public static void ExportPackage(string assetPathName,string fileName)
{
AssetDatabase.ExportPackage(assetPathName, fileName, ExportPackageOptions.Recurse);
}
#endif
#if UNITY_EDITOR
[MenuItem("QFramework/8.总结之前的方法/1.获取文件名")]
private static void MenuClicked()
{
Debug.Log(GenerateUnityPackageName());
}
[MenuItem("QFramework/8.总结之前的方法/2.复制文本到剪切板")]
private static void MenuClicked2()
{
CopyText("要复制的关键字");
}
[MenuItem("QFramework/8.总结之前的方法/3.生成文件名到剪切板")]
private static void MenuClicked3()
{
CopyText(GenerateUnityPackageName());
}
[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");
}
#endif
}
}
其实代码量还是比较多的。
而在上一篇中,我们就知道了,这个示例有类命名的问题。我们运气比较好,刚好可以试着解决一下。
关于类,我们在写第一个示例的时候就去接触了,不过笔者并没有讲它,是因为作为一个代码设计的工具,类是非常重要的一个概念,它比方法复杂得多,不过今天我们不用全部了解,只需要了解对本示例有用的部分就好了。
我们都知道,在 C# 中方法都是需要在类中实现的。所以类的第一个作用就是方法的集合。
而我们的问题是,对于 OpenInFinder 、ExportPackage 这些方法所在的类的名字比较奇怪。
之所以能意识到问题的存在,是因为笔者知道一个库不可能仅仅这几个方法的。如果是仅仅这几个方法,我们还是可以叫 PreviousFunctions 。因为方法数量比较小,所以用人脑就可以记住了。就算忘记了再去看一遍也很容易记住的。但是到目前为止我们收集了 13 个示例,那么至少有 13 个方法,在未来随着时间增长,我们要收集的方法会越来越多。所以给方法进行合理地分类,并把它们放在合适的地方是必须要做的。
不过我们对于对方法分类还是新手,因为到目前为止,笔者没有在此专栏中提过方法分类这件事,
我们先来看下这些方法是干嘛的,以及用在哪里的?
- GenerateUnityPackageName:自动生成文件名,是属于导出功能的一部分,属于定制方法。
- CopyText:复制文本,比较通用。
- OpenInFolder:打开所在文件夹,在 UnityEditor 里比较通用。
- CallMenuItem:复用菜单,在 UnityEditor 里比较通用。
- ExportPackage:导出 Package,在 UnityEditor 比较通用。
很自然地,根据用处可以分为三类,一个是定制方法,GenerateUnityPackageName,它只能用在导出功能里。在其他的情况下很少适用。
第二种则是 UnityEditor 通用,比如 OpenInFolder 和 CallMenuItem。
第三种则是可能全平台通用的,比如 CopyText。
基于以上我们就按照这种方式去分类。如何分呢?
答案就是使用类,给类起一个类型名字就好。
在之前我们提过,类的第一个作用是方法的集合,它可以放若干个方法。而我们方法已经分好类型了,现在就差给类起一个合适的名字。我们先叫做 Exporter (导出器) 、EditorUtil (编辑器工具)和 CommonUtil (通用工具)。
代码如下:
CommonUtil 类
public class CommonUtil
{
public static void CopyText(string text)
{
GUIUtility.systemCopyBuffer = text;
}
}
Exporter 类
public class Exporter
{
public static string GenerateUnityPackageName()
{
return "QFramework_" + DateTime.Now.ToString("yyyyMMdd_hh");
}
}
EditorUtil 类
public class EditorUtil
{
#if UNITY_EDITOR
public static void CallMenuItem(string menuPath)
{
EditorApplication.ExecuteMenuItem(menuPath);
}
public static void OpenInFolder(string folderPath)
{
Application.OpenURL("file:///" + folderPath);
}
public static void ExportPackage(string assetPathName,string fileName)
{
AssetDatabase.ExportPackage(assetPathName, fileName, ExportPackageOptions.Recurse);
}
#endif
}
这样就算给方法分好类了,这三个类放在了 PreviousFunctions 类定义位置的上方。
如下代码所示:
#if UNITY_EDITOR
using UnityEditor;
#endif
using UnityEngine;
using System;
using System.IO;
namespace QFramework
{
public class CommonUtil
{
...
}
public class Exporter
{
...
}
public class EditorUtil
{
...
}
public class PreviousFunctions : MonoBehaviour
{
...
}
}
那么,PreviousFunctions 里以前实现的方法怎么办?要进行删除嘛?
已经删了的童鞋可能知道,直接删除会造成编译问题。因为在第七个示例里,已经用了 PreviousFunctions 里的方法。所以保险起见,不能马上进行删除,而是做一步方法的中转。
例如 PreviousFunction.CopyText 实现如下所示:
public static void CopyText(string text)
{
CommonUtil.CopyText(text);
}
这样就可以了,ok 了,我们把其他的部分也照着这样做,代码如下。
public static string GenerateUnityPackageName()
{
return Exporter.GenerateUnityPackageName();
}
public static void CopyText(string text)
{
CommonUtil.CopyText(text);
}
public static void OpenInFolder(string folderPath)
{
EditorUtil.OpenInFolder((folderPath));
}
#if UNITY_EDITOR
public static void CallMenuItem(string menuPath)
{
EditorUtil.CallMenuItem(menuPath);
}
public static void ExportPackage(string assetPathName,string fileName)
{
EditorUtil.ExportPackage(assetPathName, fileName);
}
#endif
这样,可以保证功能不失效,也就是遵循了我们的约定和规则之一。
但是这样还不够,因为我们逐个整理完示例之后,回过头来可能会忘记。在这里笔者介绍一个 C# 的标签属性 [System.Obselete(“方法以过时”)] ,只要在方法上加上这个标签,编译器就会在使用这个方法的地方报出警告,而警告的内容则是 Obselete 括号中的 “方法以过时”。
我们先给这五个方法加上,然后观察下 Unity 的控制台的警告。
代码如下:
PreviousFunctions.cs
[Obsolete("方法以过时,请使用 Exporter.GenerateUnityPackageName();")]
public static string GenerateUnityPackageName()
{
return Exporter.GenerateUnityPackageName();
}
[Obsolete("方法以过时,请使用 CommonUtil.CopyText(text);")]
public static void CopyText(string text)
{
CommonUtil.CopyText(text);
}
[Obsolete("方法以过时,请使用 EditorUtil.OpenInFolder(folderPath);")]
public static void OpenInFolder(string folderPath)
{
EditorUtil.OpenInFolder(folderPath);
}
#if UNITY_EDITOR
[Obsolete("方法以过时,请使用 EditorUtil.CallMenuItem(menuPath);")]
public static void CallMenuItem(string menuPath)
{
EditorUtil.CallMenuItem(menuPath);
}
[Obsolete("方法以过时,请使用 EditorUtil.ExportPackage(assetPathName, fileName);"]
public static void ExportPackage(string assetPathName,string fileName)
{
EditorUtil.ExportPackage(assetPathName, fileName);
}
#endif
编译之后的结果如下:
信息给得非常详细,这样我们之后就不会忘记了,只要在方法上有 Obsolete 的方法,在进行整理的时候如果它没有被引用的时候就可以删掉了。
现在这几个方法被第七个示例引用了,所以还不能删除,而是这一轮示例整理过后,回过头再整理。
今天新的内容够多了,我们直接列出完整的 PreviousFuctions.cs 代码。
如下:
#if UNITY_EDITOR
using UnityEditor;
#endif
using UnityEngine;
using System;
using System.IO;
namespace QFramework
{
public class CommonUtil
{
public static void CopyText(string text)
{
GUIUtility.systemCopyBuffer = text;
}
}
public class Exporter
{
public static string GenerateUnityPackageName()
{
return "QFramework_" + DateTime.Now.ToString("yyyyMMdd_hh");
}
}
public class EditorUtil
{
#if UNITY_EDITOR
public static void CallMenuItem(string menuPath)
{
EditorApplication.ExecuteMenuItem(menuPath);
}
public static void OpenInFolder(string folderPath)
{
Application.OpenURL("file:///" + folderPath);
}
public static void ExportPackage(string assetPathName,string fileName)
{
AssetDatabase.ExportPackage(assetPathName, fileName, ExportPackageOptions.Recurse);
}
#endif
}
public class PreviousFunctions : MonoBehaviour
{
[Obsolete("方法以过时,请使用 Exporter.GenerateUnityPackageName();")]
public static string GenerateUnityPackageName()
{
return Exporter.GenerateUnityPackageName();
}
[Obsolete("方法以过时,请使用 CommonUtil.CopyText(text);")]
public static void CopyText(string text)
{
CommonUtil.CopyText(text);
}
[Obsolete("方法以过时,请使用 EditorUtil.OpenInFolder(folderPath);")]
public static void OpenInFolder(string folderPath)
{
EditorUtil.OpenInFolder(folderPath);
}
#if UNITY_EDITOR
[Obsolete("方法以过时,请使用 EditorUtil.CallMenuItem(menuPath);")]
public static void CallMenuItem(string menuPath)
{
EditorUtil.CallMenuItem(menuPath);
}
[Obsolete("方法以过时,请使用 EditorUtil.ExportPackage(assetPathName, fileName);")]
public static void ExportPackage(string assetPathName,string fileName)
{
EditorUtil.ExportPackage(assetPathName, fileName);
}
#endif
#if UNITY_EDITOR
[MenuItem("QFramework/8.总结之前的方法/1.获取文件名")]
private static void MenuClicked()
{
Debug.Log(Exporter.GenerateUnityPackageName());
}
[MenuItem("QFramework/8.总结之前的方法/2.复制文本到剪切板")]
private static void MenuClicked2()
{
CommonUtil.CopyText("要复制的关键字");
}
[MenuItem("QFramework/8.总结之前的方法/3.生成文件名到剪切板")]
private static void MenuClicked3()
{
CommonUtil.CopyText(GenerateUnityPackageName());
}
[MenuItem("QFramework/8.总结之前的方法/4.导出 UnityPackage")]
private static void MenuClicked4()
{
EditorUtil.ExportPackage("Assets/QFramework",GenerateUnityPackageName() + ".unitypackage");
}
[MenuItem("QFramework/8.总结之前的方法/5.打开所在文件夹")]
private static void MenuClicked5()
{
EditorUtil.OpenInFolder(Application.dataPath);
}
[MenuItem("QFramework/8.总结之前的方法/6.MenuItem 复用")]
private static void MenuClicked6()
{
EditorUtil.CallMenuItem("QFramework/8.总结之前的方法/4.导出 UnityPackage");
EditorUtil.OpenInFolder(Path.Combine(Application.dataPath, "../"));
}
#endif
}
}
大家发现 PreviousFunctions 这个类里的所有的 MenuItem 方法里的实现,都改成了新的方法。
而笔者删除了以下方法,原因是知识点和第七个示例重复了,有了第七个示例就不需要这个方法了。
[MenuItem("QFramework/8.总结之前的方法/7.自定义快捷键")]
private static void MenuClicked7()
{
Debug.Log("%e 意思是快捷键 cmd/ctrl + e");
}
小结
- 要做的事情:
- (完成) 备份:导出文件,并取一个合理的名字。
- 遗留问题:
- (完成一部分) 第八个示例与之前的示例代码重复,功能重复。
- (完成) 方法所在类的命名有问题。
- 菜单栏显示顺序问题。
- 约定和规则:
- 每个示例在 QFramework 目录下创建一个文件夹,文件夹的格式是: 数字.示例的功能
- 每个示例写一个脚本,脚本中包含可复用的静态方法和 MenuItem 方法。
- 每写一个示例进行一次导出,导出的文件名后边加上日期和时间,这个功能已经在导出功能里内置了。
- 每次有 API 变更的时候做一次备份,备份的名字采用 QFramework_vX.Y.Z 格式。
- 每次进行整理的时候要确保是在功能有效的情况下进行删除和变更。
- 示例分类:
- 知识学习&收集
- API 收集
- C# 语法实践
- 库本身的功能
- 规则实现
- 使用流程提供及优化
- 效率提升(编码体验、逻辑复用)
- 项目实用工具收集
- 知识学习&收集
今天的内容就写到这里,下一篇再见,拜拜~
转载请注明地址:凉鞋的笔记:liangxiegame.com
更多内容
-
QFramework 地址:https://github.com/liangxiegame/QFramework
-
QQ 交流群:623597263
-
Unity 进阶小班:
- 主要训练内容:
- 框架搭建训练(第一年)
- 跟着案例学 Shader(第一年)
- 副业的孵化(第二年、第三年)
- 权益、授课形式等具体详情请查看《小班产品手册》:https://liangxiegame.com/master/intro
- 主要训练内容:
-
关注公众号:liangxiegame 获取第一时间更新通知及更多的免费内容。
免责声明:本站所有文章内容,图片,视频等均是来源于用户投稿和互联网及文摘转载整编而成,不代表本站观点,不承担相关法律责任。其著作权各归其原作者或其出版社所有。如发现本站有涉嫌抄袭侵权/违法违规的内容,侵犯到您的权益,请在线联系站长,一经查实,本站将立刻删除。 本文来自网络,若有侵权,请联系删除,如若转载,请注明出处:https://yundeesoft.com/29036.html