Android系统下的三、四等水准记录软件开发

ＫＡ　Ｎ　Ｃ　ＨＡ　Ｙ　Ｕ　Ｃ　Ｅ　Ｌ　Ｉ　Ａ　Ｎ　
Ｇ《工程与建设》　２
０１６年第３０卷第１期３３　
收稿日期：２０１５－１２－２５；修改日期：２０１６－０１－
１９作者简介：赵　健（１９８５－）
，男，安徽淮南人，安徽省水利水电勘测设计院勘测分院工程师．Ａｎｄｒｏｉｄ系统下的三、
四等水准记录软件开发赵　健
（安徽省水利水电勘测设计院勘测分院，安徽蚌埠　２３３０００
）摘　要：随着科学技术快速发展，虽然测量设备和测绘方法都发生较大的变化，但是水准记录作为传统的测量手段仍然具有不可替代的精准性，而其相关软件的更新迭代也更容易被人们忽视。

文章使用的ＰＤＡ水准记录软件，在数据处理、资料打印及归档上已有一套成熟的方案，但是ＰＤＡ设备已近淘汰，考虑到智能手机的高度普及和便携性，开发了Ａｎｄｒｏｉｄ系统下的水准记录软件。

关键词：水准记录软件；Ａｎｄｒｏｉｄ系统；
界面设计中图分类号：ＴＰ３１１．５ 文献标识码：Ａ 文章编号：１６７３－５７８１（２０１６）０１－００３３－
０３１　功能介绍
本软件可对三、四等水准测量进行观测数据记录，四等水准路线中支持“单程双转点”模式。

在数据录入时，软件将“监听”用户的输入行为，自动切换输入焦点，
并实时进行数据检查，提示超限的读数，同时可对奈鲍尔法ｉ角检验数据进行检查和记录。

在软件编写过程中着重考虑记录员的操作体验，如最大视距为１００ｍ的情况下，当距离记录到２位数，并且大于１０的时候则自动将光标移到下一个输入框，否则等待用户继续输入。

诸多类似这样的设计将尽可能地减少记录过程中的多余动作。

２　环境搭建
在Ａｎｄｒｏｉｄ开发环境中，较常用的为ＥｃｌｉｐｓｅＩＤＥ，除此之外也可以使用ＩｎｔｅｌｌｉＪ　
ＩＤＥＡ。

本文简单介绍Ｅｃｌｉｐ
ｓｅ开发环境要素组成［１－４］。

（１）ＪＤＫ（Ｊａｖａ　ＳＥ　Ｄｅｖｅｌｏｐ
ｍｅｎｔ　Ｋｉｔ）。

也就是Ｊａｖａ开发工具箱，它是Ｊａｖａ的核心，包含了Ｊａｖａ的运行环境（Ｊａｖａ　Ｒｕｎｔｉｍｅ　Ｅｎｖｉｒｏｎｍｅｎｔ），一堆Ｊａｖａ工具和给开发者开发应用程序时调用的Ｊａｖａ类库。

本文使用的是ＪＤＫ　８Ｕｐｄａｔｅ　６０，安装并为其配置环境变量即可。

（２）Ａｎｄｒｏｉｄ　ＳＤＫ（Ｓｏｆｔｗａｒｅ　Ｄｅｖｅｌｏｐ
ｍｅｎｔ　Ｋｉｔ）。

它包含了模拟器、教程、ＡＰＩ文档和示例代码等内容，为构建、调试Ａｎｄｒｏｉｄ应用程序提供了所需的开发工
具。

打开Ａｎｄｒｏｉｄ　ＳＤＫ安装目录下的ＳＤＫ　Ｍａｎａｇ－ｅｒ，可以为不同版本的安卓系统下载对应的ＳＤＫ包，
以便于在各个不同平台下进行调试。

（３）Ｅｃｌｉｐｓｅ和ＡＤＴ插件。

Ｅｃｌｉｐ
ｓｅ是Ｊａｖａ应用程序及Ａｎｄｒｏｉｄ开发的ＩＤＥ（集成开发环境），ＡＤＴ（Ａｎｄｒｏｉｄ　Ｄｅｖｅｌｏｐｍｅｎｔ　Ｔｏｏｌｓ）是Ｇｏｏｇ
ｌｅ专门为Ｅ－ｃｌｉｐｓｅ定制的一个插件，用来将Ｅｃｌｉｐｓｅ和ＡｎｄｒｏｉｄＳＤＫ关联起来。

为了方便程序员对Ａｎｄｒｏｉｄ开发环境的配置，Ｇｏｏｇ
ｌｅ提供了一种集成式ＩＤＥ：ＡＤＴ－Ｂｕｎｄｌｅ　ｆｏｒＷｉｎｄｏｗｓ，它包含了上述除ＪＤＫ以外的所有东西，直接解压然后更新下Ａｎｄｒｏｉｄ　
ＳＤＫ即可使用。

但是，更新ＳＤＫ时，先在Ｅｃｌｉｐｓｅ－帮助－Ｉｎｓｔａｌｌ　ＮｅｗＳｏｆｔｗａｒｅ－ｗｈａｔ　ｉｓ　ａｌｒｅａｄｙ　ｉｎｓｔａｌｌｅｄ中查看ＡＤＴ版本，确保该版本和ＳＤＫ　Ｍａｎａｇｅｒ安装包列表内的Ｔｏｏｌｓ－Ａｎｄｒｏｉｄ　ＳＤＫ　Ｔｏｏｌｓ版本号一致，否则会有版本不匹配的提示；当Ｉｎｔｅｌ　ＣＰＵ支持ＶＴ虚拟技术时，可以在ＳＤＫ　Ｍａｎａｇ
ｅｒ中下载Ｉｎｔｅｌ　ｘ８６ＥｍｕｌａｔｏｒＡｃｃｅｌｅｒａｔｏｒ
，以使用ＨＡＸＭ技术为模拟器加速［５］。

３　界面及功能实现
３．１　界面设计
Ａｎｄｒｏｉｄ提供了一种非常简单、方便的方法用于控制ＵＩ界面，该方法采用ＸＭＬ文件进行界面布局，从而将布局界面的代码和逻辑控制的Ｊａｖａ代码分离开来，使程序的结构更加清晰、明了。

ＫＡ　Ｎ　Ｃ　ＨＡ　Ｙ　Ｕ　Ｃ　Ｅ　Ｌ　Ｉ　Ａ　Ｎ　
Ｇ３４　
《工程与建设》　２
０１６年第３０卷第１期使用ＸＭＬ布局文件控制ＵＩ界面可以分为以下２个关键步骤：
（１）在Ａｎｄｒｏｉｄ应用的ｒｅｓ＼ｌａｙｏｕｔ目录下编写ＸＭＬ布局文件，可以采用任何符合Ｊａｖａ命名规则的文件名。

创建后，Ｒ．ｊａｖａ会自动收录该布局资源。

（２）在Ａｃｔｉｖｉｔｙ中使用Ｊａｖａ代码实现ＸＭＬ文件中布局的内容：ｓｅｔＣｏｎｔｅｎｔＶｉｅｗ（Ｒ．ｌａｙｏｕｔ．ａｃｔｉｖｉｔｙ＿ｗｅｌｃｏｍ），在代码中，ａｃｔｉｖｉｔｙ＿ｗｅｌｃｏｍｅ是本软件首页面ＸＭＬ布局文件的文件名。

由于Ａｎｄｒｏｉｄ设备的分辨率和屏幕尺寸较为混乱，因此，有必要为不同分辨率的设备单独编写布局文件。

现在多数手机已经采用了１　９２０×１　０８０的分辨率，为了界面能够正常显示，需要在ｒｅｓ目录下新建一个ｌａｙｏｕｔ－ｘｘｈｄｐｉ的文件夹，在里面为软件的每个界面重新编写ＸＭＬ布局文件。

软件运行时将根据手机的分辨率自动调用相应文件夹内的布局文件进行显示
［６－
７］。

在本软件部分代码中布局了一个“选择…”的按钮和显示文件路径的可编辑文本框，
如图１所示。

图１　软件界面
３．２　功能实现
在水准记录过程中，为了提升用户使用体验，软件需要对录入的数据进行分析，并辅助用户进行输入焦点切换和超限提醒。

以水准尺的后视红面读数为例，首先限定该文本框只能输入整数，且长度为４个字符，然后监听这个文本框的字符变化，当其为４个字符（即已经输入完毕）时将焦点切换到下一目标；
然后再为该文本框添加一个焦点切换监听器，并在其内判断读数是否超限。

以下为部分代码：
ＤｈｏｕＨｏｎｇ．ｓｅｔＯｎＦｏｃｕｓＣｈａｎｇｅＬｉｓｔｅｎｅｒ（ｎｅｗ　ＯｎＦｏｃｕｓ－Ｃｈａｎｇ
ｅＬｉｓｔｅｎｅｒ（）｛　ＥｄｉｔＴｅｘｔ　ＤｈｏｕＨｅｉ＝（ＥｄｉｔＴｅｘｔ）ｆｉｎｄＶｉｅｗＢｙＩｄ（Ｒ．ｉｄ．ＤｈｏｕＨｅｉ
）；／／－－后视黑面　ＥｄｉｔＴｅｘｔ　ＤｑｉａｎＨｅｉ＝（ＥｄｉｔＴｅｘｔ）ｆｉｎｄＶｉｅｗＢｙＩｄ（Ｒ．ｉｄ．Ｄｑ
ｉａｎＨｅｉ）；／／－－前视黑面　ＥｄｉｔＴｅｘｔ　ＤｈｏｕＨｏｎｇ＝（ＥｄｉｔＴｅｘｔ）ｆｉｎｄＶｉｅｗＢｙＩｄ（Ｒ．ｉｄ．ＤｈｏｕＨｏｎｇ
）；／／－－后视红面　ＥｄｉｔＴｅｘｔ　ＤｑｉａｎＨｏｎｇ＝（ＥｄｉｔＴｅｘｔ）ｆｉｎｄＶｉｅｗＢｙＩｄ（Ｒ．ｉｄ．ＤｑｉａｎＨｏｎｇ
）；／／－－前视红面　ｐｕｂｌｉｃ　ｖｏｉｄ　ｏｎＦｏｃｕｓＣｈａｎｇｅ（Ｖｉｅｗ　ｖ，ｂｏｏｌｅａｎ　ｈａｓＦｏ－ｃｕｓ）｛ｉｆ（！ＴｅｘｔＵｔｉｌｓ．ｉｓＥｍｐｔｙ（ＤｈｏｕＨｅｉ．ｇｅｔＴｅｘｔ（））＆＆！ＴｅｘｔＵｔｉｌｓ．ｉｓＥｍｐｔｙ（ＤｈｏｕＨｏｎｇ．ｇｅｔＴｅｘｔ（）））／／－－后视读数不为空
　｛
ｄｏｕｂｌｅ　ｄｂｌｈｏｕＨｅｉ＝Ｄｏｕｂｌｅ．ｐａｒｓｅＤｏｕｂｌｅ（ＤｈｏｕＨｅｉ．ｇｅｔＴｅｘｔ（）．ｔｏＳｔｒｉｎｇ
（））； ｄｏｕｂｌｅ　ｄｂｌｈｏｕＨｏｎｇ＝Ｄｏｕｂｌｅ．ｐａｒｓｅＤｏｕｂｌｅ（Ｄｈｏｕ－Ｈｏｎｇ．ｇｅｔＴｅｘｔ（）．ｔｏＳｔｒｉｎｇ（））；ｉｆ（（ｄｂｌｈｏｕＨｅｉ＋ｈｃｃｓ－ｄｂｌｈｏｕ－Ｈｏｎｇ）＞ｃｈｋ３０｜｜（ｄｂｌｈｏｕＨｏｎｇ
－ｄｂｌｈｏｕＨｅｉ－ｈｃｃｓ）＞ｃｈｋ３０） ｛
Ｔｏａｓｔ．ｍａｋｅＴｅｘｔ（ＤａｎＣｈｅｎｇＡｃｔｉｖｉｔｙ．ｔｈｉｓ，“中丝读数超限”，Ｔｏａｓｔ．ＬＥＮＧＴＨ＿ＳＨＯＲＴ）．ｓｈｏｗ（
）；（（ＥｄｉｔＴｅｘｔ）ｆｉｎｄＶｉｅｗＢｙＩｄ（Ｒ．ｉｄ．ＤｈｏｕＨｏｎｇ））．ｓｅｔＴｅｘｔ（＂＂）；
｝ｅｌｓｅ　ｉｆ（！ＴｅｘｔＵｔｉｌｓ．ｉｓＥｍｐｔｙ（ＤｑｉａｎＨｅｉ．ｇｅｔＴｅｘｔ（））＆＆！ＴｅｘｔＵｔｉｌｓ．ｉｓＥｍｐｔｙ（ＤｑｉａｎＨｏｎｇ．ｇ
ｅｔＴｅｘｔ（））） ｛
ｄｏｕｂｌｅ　ｄｂｌｑｉａｎＨｅｉ＝Ｄｏｕｂｌｅ．ｐａｒｓｅＤｏｕｂｌｅ（ＤｑｉａｎＨｅｉ．ｇｅｔ－Ｔｅｘｔ（）．ｔｏＳｔｒｉｎｇ
（））；ｄｏｕｂｌｅ　ｄｂｌｑｉａｎＨｏｎｇ＝Ｄｏｕｂｌｅ．ｐａｒｓｅＤｏｕｂｌｅ（ＤｑｉａｎＨｏｎｇ．ｇｅｔＴｅｘｔ（）．ｔｏＳｔｒｉｎｇ
（））；ｉｆ（（ｄｂｌｈｏｕＨｅｉ－ｄｂｌｑｉａｎＨｅｉ－ｄｂｌｈｏｕＨｏｎｇ＋ｄｂｌｑｉａｎ－Ｈｏｎｇ）＞（ｑｃｃｓ－ｈｃｃｓ＋ｃｈｋ５０）｜｜（ｄｂｌｈｏｕＨｅｉ－ｄｂｌｑｉａｎＨｅｉ－ｄｂｌｈｏｕＨｏｎｇ＋ｄｂｌｑｉａｎＨｏｎｇ）＜（ｑ
ｃｃｓ－ｈｃｃｓ－ｃｈｋ５０））｛
　Ｔｏａｓｔ．ｍａｋｅＴｅｘｔ（ＤａｎＣｈｅｎｇＡｃｔｉｖｉｔｙ．ｔｈｉｓ，“黑红面高差超限”，Ｔｏａｓｔ．ＬＥＮＧＴＨ＿ＳＨＯＲＴ）．ｓｈｏｗ（
）；　（（ＥｄｉｔＴｅｘｔ）ｆｉｎｄＶｉｅｗＢｙＩｄ（Ｒ．ｉｄ．ＤｈｏｕＨｏｎｇ））．ｓｅｔＴｅｘｔ（＂＂）；
｝
在Ａｎｄｒｏｉｄ中，Ａｃｔｉｖｉｔｙ代表着手机屏幕的一屏，每个应用程序内可以有多个Ａｃｔｉｖｉｔｙ
，本软件中就有５个。

当在一个Ａｃｔｉｖｉｔｙ中启动另一个Ａ
ｃｔｉｖｉ－
ＫＡ　Ｎ　Ｃ　ＨＡ　Ｙ　Ｕ　Ｃ　Ｅ　Ｌ　Ｉ　Ａ　Ｎ　
Ｇ《工程与建设》　２０１６年第３０卷第１期３５　
ｔｙ时，
经常需要传递一些数据。

如用户选择好了水准等级，并填写好前、后尺常数等参数，点击“开始”按钮进行记录时，
需要把这些信息“告诉”新打开的水准记录页面，以便进行数据检查。

这时候就可以通过Ｉｎｔｅｎｔ来实现。

因为Ｉｎｔｅｎｔ通常被称为是２个Ａｃ－
ｔｉｖｉｔｙ之间的信使，
通过将要传递的数据保存在Ｉｎ－ｔｅｎｔ中，就可以将其传递到另一个Ａｃｔｉｖｉｔｙ中［８－１０
］。

在Ａｎｄｒｏｉｄ中，
可以先将要保存的数据存放在Ｂｕｎｄｌｅ对象中，然后通过Ｉｎｔｅｎｔ提供的ｐｕｔＥｘｔｒａｓ（）方法将要携带的数据保存在Ｉｎｔｅｎｔ中。

具体步骤如下：
在ＷｅｌｃｏｍｅＡｃｔｉｖｉｔｙ．ｊａｖａ的“开始”按钮单击事件监听器中添加如下代码：
　Ｉｎｔｅｎｔ　ｉｎｔｅｎｔ＝ｎｅｗ　Ｉｎｔｅｎｔ（ＷｅｌｃｏｍｅＡｃｔｉｖｉｔｙ．ｔｈｉｓ，ＤａｎＣｈｅｎｇＡｃｔｉｖｉｔｙ
．ｃｌａｓｓ）；　Ｂｕｎｄｌｅ　ｂｕｎｄｌｅ＝ｎｅｗ　Ｂｕｎｄｌｅ（）；／／－－创建并实例化一个Ｂｕｎｄｌｅ对象
　ｂｕｎｄｌｅ．ｐｕｔＣｈａｒＳｅｑｕｅｎｃｅ（＂ｈｃｃｓ＂，ｈｃｃｓ）；／／－－保存后尺常数
　ｂｕｎｄｌｅ．ｐｕｔＣｈａｒＳｅｑｕｅｎｃｅ（＂ｑｃｃｓ＂，ｑｃｃｓ）；／／－－保存前尺常数
　ｂｕｎｄｌｅ．ｐｕｔＣｈａｒＳｅｑｕｅｎｃｅ（＂ｓｚｄｊ＂，ｓｚｄｊ）；／／－－保存水准等级
　ｂｕｎｄｌｅ．ｐｕｔＣｈａｒＳｅｑｕｅｎｃｅ（＂ｔｑ＂，ｔｑ）；／／－－保存天气　ｂｕｎｄｌｅ．ｐｕｔＣｈａｒＳｅｑｕｅｎｃｅ（＂ｃｘ＂，ｃｘ）；／／－－保存成像　ｉｎｔｅｎｔ．ｐｕｔＥｘｔｒａｓ（ｂｕｎｄｌｅ）；／／－－将Ｂｕｎｄｌｅ对象添加到Ｉｎｔｅｎｔ对象中
　ｓｔａｒｔＡｃｔｉｖｉｔｙ（ｉｎｔｅｎｔ）；／／－－启动新的Ａｃｔｉｖｉｔｙ在ＤａｎＣｈｅｎｇＡｃｉｔｉｖｉｔｙ．ｊａｖａ的ｏｎＣｒｅａｔｅ（）方法中添加如下代码：
　Ｉｎｔｅｎｔ　ｉｎｔｅｎｔ＝ｇｅｔＩｎｔｅｎｔ（）；／／－－获取Ｉｎｔｅｎｔ对象　Ｂｕｎｄｌｅ　ｂｕｎｄｌｅ＝ｉｎｔｅｎｔ．ｇｅｔＥｘｔｒａｓ（）；／／－－获取传递的数据包
　Ｓｔｒｉｎｇ　ｓｔｈｃｃｓ＝ｂｕｎｄｌｅ．ｇｅｔＳｔｒｉｎｇ（＂ｈｃｃｓ＂）；／／－－获取后尺常数
　Ｓｔｒｉｎｇ　ｓｔｑｃｃｓ＝ｂｕｎｄｌｅ．ｇｅｔＳｔｒｉｎｇ（＂ｑｃｃｓ＂）；／／－－获取前尺常数
　ｈｃｃｓ＝Ｉｎｔｅｇｅｒ．ｐａｒｓｅＩｎｔ（ｓｔｈｃｃｓ）；／／－－将后尺常数转换为ｉｎｔ类型
　ｑｃｃｓ＝Ｉｎｔｅｇｅｒ．ｐａｒｓｅＩｎｔ（ｓｔｑｃｃｓ）；／／－－将前尺常数转换为ｉｎｔ类型
　Ｓｔｒｉｎｇ　ｓｚｄｊ＝ｂｕｎｄｌｅ．ｇｅｔＳｔｒｉｎｇ（＂ｓｚｄｊ＂）；／／－－获取水准等级
　ｆｉｎａｌ　Ｓｔｒｉｎｇ　
ｔｑ＝ｂｕｎｄｌｅ．ｇｅｔＳｔｒｉｎｇ（＂ｔｑ＂）；／／－－获取天气
　ｆｉｎａｌ　Ｓｔｒｉｎｇ　ｃｘ＝ｂｕｎｄｌｅ．ｇｅｔＳｔｒｉｎｇ（＂ｃｘ＂）；／／－－获取成像
这样就实现了不同界面中数据的传递，如图２所示的软件操作界面。

图２　水准记录界面
４　结束语
经测试和使用，本软件可方便快捷地进行水准数据记录，并可与本单位现有的平差软件进行无缝衔接，实现野外观测水准数据的资料处理和打印，解决了因旧设备老化和淘汰带来的软件更新迭带问题。

〔参考文献〕
［１］　吴亚峰，
索依娜．Ａｎｄｒｏｉｄ核心技术与实例讲解［Ｍ］．北京：电子工业出版社，２０１０．
［２］　清宏计算机工作室．
ＪＡＶＡ编程技巧［Ｍ］．北京：机械工业出版社，２００４．
［３］　姚昱旻，
刘卫国．Ａｎｄｒｏｉｄ的架构与应用开发研究［Ｊ］．计算机系统应用，２００８，１７（１１）：１１０－１１２．
［４］　汪永松．
Ａｎｄｒｏｉｄ平台开发之旅［Ｍ］．北京：机械工业出版社，２０１１．
［５］　罗海滨，
赵显富．电子手簿在水准测量实践教学中的应用研究［Ｊ］．测绘科学，２０１２（６）：１８７－１８８．
［６］　王　冲．
Ｊ２ＭＥ开发平台上ＸＭＬ解析器的选择［Ｊ］．计算机工程与应用，２００３（３１）：１３３－１３５．
［７］　ＧＢ／Ｔ　
１２８９８－２００９，国家三、四等水准测量规范［Ｓ］．［８］　陈　炜，
张晓蕾，侯燕萍，等．Ｊａｖａ软件开发技术［Ｍ］．北京：人民邮电出版社，２００５．
［９］　熊　刚．
基于Ａｎｄｒｏｉｄ的智能手机的设计与实现［Ｄ］．武汉：武汉理工大学，２０１０．
［１０］　尤宝平，
聂　群．ＤｉＮｉ１１／１２电子水准仪及其使用［Ｊ］．海洋测绘，２００４（４）：５９－６１．。