使用 C＃ 开发智能手机软件：推箱子(六)

2007年10月09日 11:33:00
这是"使用 C＃ 开发智能手机软件：推箱子"系列文章的第六篇。在这篇文章中，介绍 Common/Pub.cs 源程序文件。

1 using System;
2 using System.Drawing;
3 using System.Text;
4 using System.IO;
5 using System.Reflection;
6
7 namespace Skyiv.Ben.PushBox.Common
8 {
9 /// >summary<
10 /// 公共的字段和方法
11 /// >/summary<
12 static class Pub
13 {
14 public const int OverY = 4; // 允许在屏幕(Y)方向超过的像素数
15 public const int DefaultMaxLevelSize = 32; // 缺省的最大关尺寸(宽度和高度)
16 public const int DefaultStepDelay = 100; // 缺省移动时间间隔(毫秒)
17 public const int DefaultReplayDelay = 300; // 缺省回放时间间隔(毫秒)
18 public const int MaxDelay = 1000; // 允许的最大时间间隔(毫秒)
19 public readonly static string ConfigFileName = Path.Combine(baseDirectory, "PushBox.cfg"); // 配置文件全路径名
20 public readonly static Encoding Encode = Encoding.GetEncoding("GB2312"); // Windows Mobile 6.0 不支持 GB18030
21 static string baseDirectory { get { return Path.GetDirectoryName(Pub.CodeBases); } } // 本程序所在的目录
22
23 static Assembly Assembly { get { return Assembly.GetExecutingAssembly(); } }
24 static AssemblyName AssemblyName { get { return Pub.Assembly.GetName(); } }
25 public static Version Version { get { return Pub.AssemblyName.Version; } } // 本程序的版本
26 public static string TextDirectory { get { return Path.Combine(baseDirectory, "text"); } }
27 public static string DataDirectory { get { return Path.Combine(baseDirectory, "data"); } }
28 public static string StepsDirectory { get { return Path.Combine(baseDirectory, "steps"); } }
29 public const string TextExtName = ".bxa"; // 文本文件扩展名
30 public const string DataExtName = ".bxb"; // 数据文件扩展名
31 public const string StepsExtName = ".bxs"; // 通关步骤文件扩展名
32
33 /// >summary<
34 /// 本程序的全路径名
35 /// >/summary<
36 public static string CodeBases
37 {
38 get
39 {
40 string codeBase = Pub.AssemblyName.CodeBase;
41 string uri = "file:///";
42 if (codeBase.StartsWith(uri)) codeBase = codeBase.Substring(uri.Length);
43 return codeBase;
44 }
45 }
46
47 /// >summary<
48 /// 给出指定尺寸的显示字符串，格式为: 宽x高
49 /// >/summary<
50 /// >param name="size"<指定的尺寸>/param<
51 /// >returns<指定尺寸的显示字符串>/returns<
52 public static string ToString(Size size)
53 {
54 return size.Width + "x" + size.Height;
55 }
56
57 /// >summary<
58 /// 将走法步骤转换为字符串
59 /// >/summary<
60 /// >param name="steps"<走法步骤>/param<
61 /// >returns<转换后的字符串>/returns<
62 public static string ToString(Step[] steps)
63 {
64 StringBuilder sb = new StringBuilder();
65 foreach (Step step in steps) sb.Append((char)step);
66 char[] array = sb.ToString().ToCharArray();
67 Array.Reverse(array);
68 return new string(array);
69 }
70
71 /// >summary<
72 /// 给出指定版本的信息，格式为: x.x (build: yyyy-MM-dd)
73 /// >/summary<
74 /// >param name="version"<指定的版本>/param<
75 /// >returns<指定版本的信息>/returns<
76 public static string GetVersionBuildString(Version version)
77 {
78 double days = version.Build + 2 * version.Revision / ((double)TimeSpan.TicksPerDay / TimeSpan.TicksPerSecond);
79 return string.Format("{0} (Build: {1})", version.ToString(2), (new DateTime(2000, 1, 1)).AddDays(days).ToString("yyyy-MM-dd HH:mm:ss"));
80 }
81
82 /// >summary<
83 /// 给出指定异常的信息，包含其内含异常的信息
84 /// >/summary<
85 /// >param name="ex"<指定的异常>/param<
86 /// >param name="isDebug"<是否给出详细信息>/param<
87 /// >returns<指定异常的信息>/returns<
88 public static string GetMessage(Exception ex, bool isDebug)
89 {
90 StringBuilder sb = new StringBuilder();
91 for (Exception e = ex; e != null; e = e.InnerException)
92 {
93 sb.Append(isDebug ? e.ToString() : e.Message);
94 sb.Append(Fcl.NewLine);
95 }
96 return sb.ToString();
97 }
98 }
99 }
100
静态类 Pub 定义了一些全局的常量、只读字段、只读属性和一些静态方法，介绍如下：

baseDirectory 只读属性返回本程序(PushBox.exe)所在的绝对路径。
ConfigFileName 只读字段返回配置文件(PushBox.cfg)的全路径名。
TextDirectory 只读属性返回文本文件(*.bxa)所在目录(text)的绝对路径。
DataDirectory 只读属性返回数据文件(*.bxb)所在目录(data)的绝对路径。
StepsDirectory 只读属性返回通关步骤文件(*.bxs)所在目录(steps)的绝对路径。

注意，Windows CE 操作系统不具有当前目录功能，Directory.GetCurrentDirectory 方法在 .NET Compact Framework 中可用，但是当前并不支持，调用该方法会抛出一个 NotSupportedException 异常。在 Windows CE 下编程，所有的文件名都是从智能手机的根目录算起的，所以在 Pub 静态类给出了以上全路径名。
我提供下载的 zip 文件中包括以下内容：
PushBox.exe 推箱子程序
PushBox.cfg 配置文件
data/*.bxb 数据文件
steps/*.bxs 通关步骤
其实只有 PushBox.exe 就完全可以玩推箱子游戏了，只不过所有的关卡都要自己设计。运行时如下所示：





然后，点击"菜单 -< 数据 -< 配置"：



再点击"菜单 -< 数据 -< 转换"：





程序就会自动生成所需的配置文件和数据文件，画面就正常了：



然后就可以点击"菜单 -< 数据 -< 设计"，随心所欲地设计关卡了。

GetVersionBuildString 方法给出指定版本的信息，格式为: x.x (build: yyyy-MM-dd)，例如本程序目前的版本是 2.1 (Build: 2007-08-19 15:09:44)。这是在 Properties/AssemblyInfo.cs 源程序文件中指定了以下版本信息：
[assembly: AssemblyVersion("2.1.*")]
即：指定主版本为 2，次版本为 1，并接受默认的内部版本号和修订号。默认的内部版本号从2000年1月1日起每日增加，默认修订号据 MSDN 文档上说是随机的，但我发现至少目前来说，是从午夜起的秒数除以二。

Trackback: http://tb.blog.csdn.net/TrackBack.aspx?PostId=1816548