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

     这是“ 使用 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 文档上说是随机的，但我发现至少目前来说，是从午夜起的秒数除以二。

---

上一篇： 使用 C# 开发智能手机软件：推箱子(五)
下一篇： 使用 C# 开发智能手机软件：推箱子(七)
返回目录