使用 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