目录 1. 引言 INTRODUCTION 编写目的 PURPOSE 1.2 定义 DEFINITION AND SCOPE...5 AND ABBREVIATIONS 乐 PHONE 产品介绍 硬件参数说明 软件系统介绍 软件

Transcription

1 乐 Phone 开发指南 V1.0 联想研究院 1

2 目录 1. 引言 INTRODUCTION 编写目的 PURPOSE 1.2 定义 DEFINITION AND SCOPE...5 AND ABBREVIATIONS 乐 PHONE 产品介绍 硬件参数说明 软件系统介绍 软件系统架构 ARCHITECTURE OVERVIEW 应用开发框架 APPLICATION FRAMEWORK PUSH Push 简介 Introduction 联想推送服务(Lenovo Push Service, 简称 LPS)介绍 WIDGET Overview 开发接口概述 APIs Widget 尺寸规范 示例 公共控件 CONTROLS Overview 开发接口概述 APIs CustomeTitleIcon GruopListAdapter ToolBarButton BottomTabActivity TabButtonTop TabButtonBottom 显示/隐藏 AlertDialog 按钮 SlideButton ContentTop 区域背景设置 ContentBottom 区域背景设置 带图标的 TextEdit 字体的使用 Popup menu 提示效果 Context 新增函数 JAVA 支持 JAVA SUPPORT Overview JSR 规范支持列表 Java 程序安装 Java 程序卸载和设置 Java 程序通过 AMS 进行内存设置 Setting the memory in AMS

3 4.4.6 Java 程序通过配置文件进行内存设置 Pre-set a memory throgh extract the jad attribute Java 程序通过 AMS 进行运行方向设置 Setting the orientation in AMS Java 程序通过配置文件进行运行方向设置 Pre-set a oritentation throgh extract the jad attribute 下载管理器 DOWNLOAD MANAGER Overview 开发接口概述 APIs 开发示例 存储管理 STORAGE MANAGEMENT 支付接口说明 目的和适用范围 定义 缩写和术语 支付的基本过程和模型 三方应用支付处理开发建议 签名机制 签名方式 签名示例代码 接口定义 视频播放器接口 视频播放器截图 接口调用方法 图片管理应用接口 查看图片 调用图片作为附件 CAMERA 接口 Overview 开发接口概述 APIs 开发示例 图片管理应用接口 查看图片 调用图片作为附件 乐 PHONE 的 HTTP 代理设置和使用 自动设置 http 代理的类: 使用 webview 的应用请注意 用户交互设计准则 UI GUIDELINE LCA 软件全生命周期管理 LCA SOFTWARE LIFECYCLE MANAGEMENT 应用开发规约 软件内容合规性 交互设计规范 技术规约 开发者的注册和管理 企业开发者

4 6.2.2 个人开发者 软件开发 DEVELOPING 安装 SDK 在 Eclipse 上开发 Android 应用程序 使用其他 IDE 环境 软件发布与升级 PUBLISHING AND UPGRADING 开发者发布一个 LCA 应用到应用商城 开发者发布一个 LCA 应用的升级版本到应用商城 终端上已装 LCA 软件通过应用商城客户端升级途径 乐 Phone 上应用商城客户端提供的调用接口 附录 APPENDIX 支持的多媒体格式 SUPPORTED MEDIA FORMATS 模拟器 开发板 常见问题 FAQ 参考资料 REFERENCE

5 1. 引言 Introduction 1.1编写目的 Purpose and scope 本文档通过对乐 Phone 的体系结构以及应用开发框架的详细介绍 帮助开发人员更高效的 开发基于乐 Phone 的应用软件和服务 文档的各章节说明如下 乐 Phone 产品介绍 介绍了乐 Phone 主要的软硬件规格 软件系统架构 介绍了基于 android 1.6 改进的软件系统架构 应用开发框架 是本文档的重点 结合示例分模块介绍了乐 Phone 新增的应用编程接口 需要提醒读者的是 具体的接口实现应以 SDK 包中的 API reference 文档为准 用户交互设计准则 对软件开发的 UI 设计给出建议 软件全生命周期管理 介绍了开发者如何安装 SDK 利用 SDK 开发软件 如何发布软件以 及软件如何被部署到终端设备上 1.2定义 Definition and abbreviations 乐 Phone 乐 Phone Lenovo Push Push LCA Lenovo_ID 第三方支付账号 商户 联想基于 android 开发的互联网移动终端设备 适用于乐 Phone 终端的内容推送平台 Lenovo Centificated Application 联想认证应用 程序 用户在使用 Lenovo Service 时注册的账户 用户在与联想手机支付系统合作的第三方支付系统 中的账户 例如支付宝账户 使用联想手机支付系统收费的联想合作伙伴 5

6 2乐 Phone 产品介绍 乐 Phone 是一款支持 WCDMA/WAPI 等无线互联技术的移动互联网设备 借助于 Lenovo Push Lenovo Appstore 等应用平台 乐 Phone 可以为用户提供无限扩展的互联网应用和体验 2.1硬件参数说明 Application Processors & System QCM8xxxx WCDMA/HSPA: GSM/GPRS/EDGE: Snapdragon processor OS 1-GHz Android 1.6 Memory & Storage ROM 512M RAM 512M SDCard 8G Embedded Peripherals LCD Touch Panel 3.7"WVGA, 800*480 16bit Capacitive Touch Panel Camera - 3M camera for still image & video capturing -0.3M for video phone, - AF not supported Keyboard 纯软件触摸键盘 可附加 QWERT 硬件键盘 加速度传感器 有 光线传感器 有 近距传感器 GPS 有 有 2.2软件系统介绍 SW Key Features Video Player Music Player - *.3gp, *.mp4,*.rm, *.rmvb, *.avi, *.wmv, *.asf, *.mov, *.mpg, *.mpeg, *.m4v, *.f4v - MP3, WMA, WAV, Midi, AMR NB,AAC, AAC+, OGG, OGM, F4A, M4A 6

7 Image Viewer - Camera application *.jpg, *.bmp, *.gif, *.png,*.wbmp Zoom in/out Full screen Image and video take & playback Send via mail, mms etc Save as contact's portrait Performance Video Playback MP3 Playback >6h Chinese Support English Support >16h Language 3软件系统架构 Architecture Overview 乐 Phone 的操作系统采用 Android 1.6 并在此基础上进行了改进 因此 乐 Phone 能兼容 绝大多数的 Android 1.6 应用 下图是乐 Phone 软件系统架构 其中绿色框部分 是新增加或者有较大改动的模块 Applications Home Contacts Phone Push apps Widget apps Application Framework Activity Manager View System Telephony Manager Push Widget Windows Manager Package Manager Resource Manager AppStore UC Content Providers Telephony Manager Location Manager Notification Manager Mail Libraries Surface Manager Android Runtime Media Framework SQLite OpenGL ES Free Type WebKit SGL SSL Libc Java Support Core Libraries Dalvik VM Linux Kernel Memory Management Process Management Security Management Drivers Power Management 各新增模块的具体介绍参见 应用开发框架 一章 旧有模块的介绍 参见[1]android SDK v1.6 或者参见乐 Phone SDK 包中附带的文档 4应用开发框架 Application Framework 此章节重点介绍新增的以及修改过的模块 其它旧有模块请参考[1]Android v1.6 SDK 7

8 4.1Push Push 为第三方内容供应商提供一个信息推送平台 能帮助第三方把有价值的信息主动即 时地发送到乐 Phone 手机上 以便于持有用户尽快阅读到新的信息 比如系统中的 Push Mail 就是此技术的典型应用 与 Mail 类似 可以即时准确发送重要的信息包括 但不限于 IM 消息 新闻 SNS 信息 音视频信息等 4.1.1Push 简介 Introduction Push 技术总说 Push 即信息推送技术服务 作为技术来说 Push是相对于传统的第二代浏览器核心技 术服务而言的 两者之间最大的不同是用户和信息之间的关系 浏览器的核心技术是信息拉取 即在 拉 的技术作用下 用户找信息 而Push是在 推 的技术作用下 信息找用 户 Push是根据用户对信息的需求 有针对性 有目的性地将用户所需的信息主动送达用户 其基本工作流程是 首先用户填写订阅单 其中包括用户个人档案 所需信息类型以及需要推送的时间等相关 内容 并提交给信息提供商 然后信息提供商按用户订阅单收集相关内容 并由Push服务器推送给客户端 客户端获 取信息完毕后告知用户可读取信息 其内容包括两类 第一类是直接将信息源中的信息本身发送给用户 第二类是只将有关信息的目录或索引通知发送给用户 由用户根据通知去查询相应的信息 Push 技术特点 主动性 当有新的信息需要提交或到达时 依据传送信息的类型和重要性的不同 Push应用会在 用户不发出信息查询请求的情况下 以各种方式通知用户 如 播放一种声音 在屏幕 上显示一条消息等 用户可以及时得到获得到自己感兴趣的信息的 个性化 Push服务的前提之一就是根据用户的特定信息需求为用户量身定制 把为特定用户而搜 集整理的信息通过一定的机制将信息推送至用户 充分体现了用户个性化信息的需求 与此同 时 用户避免了为了搜索自己关心的数据而被迫下载更多冗余的数据 集成化 对于一个特定用户来说 在某一个时期关心的往往是与某一主题相关的来自不同渠道 不 同载体的相关信息 信息加工人员可将各种渠道 各种载体的特定信息集成于同一信息频道中为 用户提供服务 8

9 易获性 对用户来讲 只需根据Push技术的基本工作流程设定自身特点 定制的信息资源类型 设定自己所需的信息频道 此后定制的信息将自动传递给用户 用户无需每次提出查询请求 无需网上漫游 可以节省大量的时间和精力 智能化 Push技术服务系统中的信息是高速流动的 不是停留在一个地方等人去寻找 而是有目 标地主动寻找合适的信息用户 为了提高Push的准确性 还可以控制搜索的深度和广度 过滤 掉不必要的信息 因而网络环境下的信息Push技术服务具有较高的智能化 高效性 由于信息推送技术采用了信息代理机制 一方面可降低重复的 无关的信息在网上传递 避免垃圾信息对网络资源的大量占用 另一方面 浏览器定期检查频道的更新信息 如遇到变 化信息 浏览器自动下载并缓存新内容 使用户可以离线浏览而减少网络开支 移动终端上的 Push 服务 在移动终端上 Push 服务更体现出巨大的生命力和特别的优越性 首先 移动终端有如下特点 1 能耗敏感 特别是使用网络应用 能耗十分可观 而且电池容量小 2 网络流量费用较高 除了在小范围活动可以使用 WiFi 运营商的 3G 或者 gprs 网络使 用费用比家用的 ADSL 小区宽带要贵许多倍 3 网络传输速率较有线网络低 网络稳定性较有线网络差 4 移动终端操作的便捷性较差 移动终端的输入输出系统较 PC 笔记本弱很多 特别是 输入系统 速度慢 不适合长时间输入数据 由此可见 移动终端获取数据 Push 技术就是用户的不二选择 Push 技术不仅为用户节 省时间 金钱 结合移动设备的高移动性 强随身性 Push 技术更是能为用户很好的服务 当前 最常见的 Push 服务是 PushMail 服务 随时随地 邮件总是及时到达 让用户总是 在第一时间得到信息 4.1.2联想推送服务 (Lenovo Push Service, 简称 LPS)介绍 联想搭建了 Push 服务平台 所有乐 Phone 用户都可以使用联想的 Push 服务 Push 当 前 联 想 拥 有 的 服 务 有 PushMail PushNews PushVideo PushMusic PushSNS PushApp 等 用户在乐 Phone 的终端上每天收到自己关注的邮件 新闻 视频 音乐 应用 SNS 等 再不必为了看个邮 件打开 PC 或笔记本 再不必为了找自己关心的内容而在网络上游弋 再不必为听一首自己喜 欢的歌星的新曲而费神 再不必为偷不到好友的菜而苦恼了 取而代之的是 一个随时随地 的自我世界 在这里 都是我想要的 Push 服务有很大潜力可挖 以后 联想同其合作伙伴将推出更多的 Push 服务 联想欢迎 Push 服务的参与者 联想将和所有参与者在移动互联网时代共同分享移动互联网的繁荣 9

10 4.2Widget 4.2.1Overview 在乐 Phone 以及 Android1.6 中 应用程序存在三种用户交互形态 标准形态/widget 态/icon 态 Icon 态通常存在于程序组或者开始菜单中 用户通过选中图标来打开一个应用程序 通常 应用程序安装后都会在开始菜单或者 程序 文件夹中生成相应的图标 Widget 态通常存在于 home screen 上 用户可以通过 widget 来快速获知重要的信息 Widget 因为只有简单的交互功能 所以往往还有相应的标准形态的应用程序与之对应 以为 用户提供更丰富的交互能力 标准形态则是应用程序运行的一般形态 提供完整的用户交互 更直观的 Widget 示例如下 上图中 用户手机的 home screen 上有四个不同尺寸和功能的 widget 分别提供 搜索 音乐播放 日历 以及 相框 的功能 可以看到 这些 widget 只提供有限的信息以及很 少的交互 但用户可以通过简单的操作 比如单击 widget 中的某个信息条目 来切换到应用程 序的标准形态 10

11 4.2.2开发接口概述 APIs 乐 Phone 的 Widget 架构与 Android1.6 完全一致 仅对可视控件作了改动 以提供更具竞 争力的用户体验 具体如下 类或接口 成员方法和变量 描述 RemoteViews 修改 Package: android.app setimageviewanimationstar 新增 ImageView 上开始播放动画 t(int viewid, int srcid) setimageviewanimationstop 新增 ImageView 上停止播放动画 (int viewid) setimageviewalpha(int viewid, int alphanum) settabhostcontent(int viewid,string title,string indicator,int drawid,int srcid){ setlistviewadapter(int viewid, int layoutid,int arrayid){ setlistviewanimation(int viewid, int animid){ setframelayoutanimation(in t viewid, int animid){ setgalleryadapter(int viewid, int[] arrayid) setbackgroundcolor(int viewed,int color) setbackgroundresource(int viewed,int srcid) 新增 设置 ImageView 背景透明度 新增 支持显示 Tab 页 新增 设置 listview 显示数据 新增 设置 listview 显示动效 新增 设置 FrameLayout 显示动效 新增 设置 Gallery 显示图片数据 新增 设置 view 的背景颜色 新增 设置 view 的背景图片 setonclickpendingintent(i nt layoutid, PendingIntent pendingintent) setonclickpendingintentwi thextra (int view, PendingIntent pendingintent, String key, long value) setonitemclickpendinginte nt(int viewid, PendingIntent pendingintent) setonitemclickpendingurli ntent (int viewid, PendingIntent pendingintent, String[] urls) 新增 响应元素 click 事件 新增 响应元素 click 事件 并附带 更多的数据 新增 响应 item click 事件 新增 相应 item click 事件 并调用 浏览器打开该 item 对应的 URL 链接 viewid 控 件 ID 比 如 11

12 listview id pendingintent: intent urls: 与 控件 中的 item 对应 的 url 字符串数组 更详细的描述请参见 APIs Reference 的相应部分 其它关于 Widget 的开发框架和接口介绍 请参见[1] Android v1.6 SDK Widget 尺寸规范 乐 Phone 遵循 android 的 4*4 布局 具体尺寸如下 竖屏 Cells Pixels 4*4 480*650 4*1 480*162 2*2 240*325 1*1 120*162 下图为一个 4*4 的竖屏 widget 示例 12

13 横屏 Cells Pixels 4*4 705*410 4*1 705*102 2*2 352*204 1*1 176*102 下图为一个 4*4 的横屏 widget 示例 13

14 4.2.4示例 一般的 app widget 由以下几部分构成 1 标准的 AndroidManifest.xml 文件 <?xml version="1.0" encoding="utf-8"?> <manifest xmlns:android=" <receiver android:name="demowidgetprovider" android:label="@string/app_name" android:icon="@drawable/icon"> <intent-filter> <action android:name="android.appwidget.action.appwidget_update" /> </intent-filter> <meta-data android:name="android.appwidget.provider" android:resource="@xml/appwidget_info" /> </receiver> </manifest> 2 widget layout 布局文件 R.layout.appwidget,此文件以 XML 格式表示 widget 的布局 示例为一个符合乐 Phone UIguideline 的全屏 widget layout 文件 <?xml version="1.0" encoding="utf-8"?> <LinearLayout xmlns:android=" android:layout_width="fill_parent" android:layout_height="fill_parent" > 14

15 <AbsoluteLayout android:layout_marginleft="30dip" android:layout_width="420dip" android:layout_height="653dip" <TextView android:textstyle="bold" android:layout_width="wrap_content" android:layout_height="fill_parent" android:gravity="left center_vertical" android:paddingleft="6px" /> <ImageView android:layout_width="wrap_content" android:layout_height="wrap_content" /> </AbsoluteLayout> </LinearLayout> 3 Widget 主体实现 public class DemoWidgetProvider extends AppWidgetProvider public void onupdate(context context, AppWidgetManager appwidgetmanager, int[] appwidgetids) { RemoteViews views = new RemoteViews(context.getPackageName(), R.layout. appwidget); views.settextviewtext(r.id.city_name, String text ); views.setimageviewresource(r.id.my_image, loadimgae); if(appwidgetids==null){ appwidgetmanager.updateappwidget(packagename+classname, views); }else{ appwidgetmanager.updateappwidget(appwidgetids, views); } } 4 AppwidgetProviderInfo 对于全屏 4cells * 4 cells 的 widget 应如下设置 android:minwidth = 400dp android:minheight = 400dp 计算方式为 number of cells * 其他资源文件 res/ layout 布局 图片资源 字符资源 AppwidgetProviderInfo 资 源 动效资源等等 当以上工作完成后 编译生成相应 apk,然后在 widgethost 中可以看到新生成项 点击后 即在桌面生成了相应的 widget. 15

16 4.3公共控件 Controls 4.3.1Overview 为上层应用提供有别于 android 的新的 UI 控件和特性 New feature list 全屏设置 提供统一接口 设置全屏 应用程序标题栏按钮控件 位于标题栏左侧 可自定义文字 图标和功能 支持组标签的 listview 控件 应用程序底部工具栏菜单 固定于应用程序底部的快捷工具栏 应用程序底部的 Tab 页签控件 SlideButton 控件 4.3.2开发接口概述 APIs 类或接口 Activity 成员方法和变量 enablefullscreen(boo lean full) customtitleicon() settitleclicklistene r 修改 新增 描述 Package: android.app 使能全屏模式 新增 新增 设置标题栏左侧按钮的图标 自定义点击标题事件的处理 系统默认 不做任何响应 Activity.OnTitle ClickListener 新增 Package: android.app. 标题被点击时的回调接口 Activity.OnTitle IconClickListene r 新增 Package: android.app. 标题栏左侧按钮被点击时的回 调 BottomTabActivit y 新增 Package: android.app 该类与 TabActivity 的对外接 口和调用方式完全相同 不同在于 TabActivity 的 Tabs 显 示 在 视 图 顶 部 而 BottomTabActivity 显 示 在 视 图底部 GroupListAdapter 新增 Package: android.widget 与 GroupHeader 结合 实现带 Group Label 的 list view GroupHeader 新增 Package: android.widget 与 GroupListAdapter 结合 实 16

17 现 带 Group Label 的 list view ToolBarButton 新增 Package:android.widget 放置在应用底部的 快捷操作 button TabButtonTop 新增 Package:android.widget 放置在顶部 增加一种保持的 状态 当应用需要类似 Tab 的 效果时 可以采用这种 button 来模拟 该 Button 有类似 RadioButton 的属性 比如可以放入 RadioGroup 中 这样可以实现 自动的互斥 可以设置 Checked 属性等 TabButtonBottom 新增 Package:android.widget 放置在底部 增加一种保持的 状态 当应用需要类似 Tab 的 效果时 可以采用这种 button 来模拟 SlideButton 新增 Package:android.widget 更详细的描述请参见 APIs Reference 的相应部分 4.3.3CustomeTitleIcon 乐 Phone 提供了允许开发者自定义外观和响应事件的程序标题栏左侧按钮 接口的具体说明如下 public void customtitleicon(int pressresid, int releaseresid, int lefttext,ontitleiconclicklistener l); 功能说明 用于自定义标题栏左侧按钮的图标 文字和事件 未进行自定义的 Activity 使用系 统默认的返回图标 图标上无文字提示 点击图标则退出 Activity 参数说明 17

18 pressresid 用户点击时 按钮的图片资源 ID 值为零 采用系统默 认图片 releaseresid 用户放开时 按钮的图片资源 ID 值为零 采用系统默 认图片 lefttext 显示于图标上的文字资源 ID 值为零 无文字提示 不 为零 图标上显示用户设定文字 此时按钮图标默认为 黑色背景图 l 处理点击 按钮事件 为 null 采用系统 默认的 退出 Activity 动作 返回值 补充说明 public interface OnTitleIconClickListener { /** * 标题栏左侧按钮被点击时的回调 */ void ontitleiconclick(); } 4.3.4GruopListAdapter Overview 类名称 效果图 E1.bmp android.widget. GroupListAdapter 18

19 示意图 S1a.bm p 矢量图 V1 具体描述 /widget/listview.html 重要说明 GrouHeader:: GroupHeader 格式定义 19

20 public GroupHeader(String content, int position) 功能说明 GroupHeader 构造函数 参数说明 content GroupHeader 附带的文本 position header 在整个列表中所对应的位置 例如 如果将 10 个 数据归为两个 groups 分别在第一个和第五个 那么对应 的 position 就是 1 和 5 返回值 补充说明 环境 运行环境 版本 Android 1.6 声明 连接库 Framework.jar 相关函数 GrouHeader:: getposition 格式定义 public int getposition() 功能说明 返回该 group header 对应的位置,该值在构造函数中指定 参数说明 返回值 返回该 group header 对应的位置,该值在构造函数中指定 补充说明 环境 20

21 运行环境 版本 Android 1.6 声明 连接库 Framework.jar 相关函数 GrouHeader:: gettext 格式定义 public String gettext() 功能说明 返回该 group header 对应 参数说明 返回值 返回该 group header 对应 补充说明 环境 运行环境 版本 Android 1.6 声明 连接库 Framework.jar 相关函数 ListView list; ArrayAdapter adapter = new ArrapAdapter(context, simletext, strlist); CustomListAdapter container = new CustomListAdapter(adapter); List.setAdapter(container); GroupListAdapter:: GroupListAdapter 格式定义 public GroupListAdapter(Adapter adapter) 功能说明 创建 GroupListAdapter, 因为 GroupListAdapter 实际是做桥梁作用 在 ListView 和 21

22 Adapter 中间做衔接 显示 GroupHeader 因此 adapter 是原始需要表示的数据 参数说明 adapter 原始数据 adapter 返回值 补充说明 环境 运行环境 版本 Android 1.6 声明 连接库 Framework.jar 相关函数 GroupListAdapter:: creategroups 格式定义 public void creategroups() 功能说明 创建 Groups 列表 参数说明 返回值 补充说明 环境 运行环境 版本 Android 1.6 声明 连接库 Framework.jar 相关函数 GroupListAdapter:: getgroupheaderview 格式定义 22

23 public View getgroupheaderview(context context, GroupHeader header) 功能说明 创建 Header 视图 参数说明 context 上下文 context header 需要创建视图的 GroupHeader 返回值 View 补充说明 环境 运行环境 版本 Android 1.6 声明 连接库 Framework.jar 相关函数 GroupListAdapter:: getadapter 格式定义 public Adapter getadapter() 功能说明 返回作为构造函数初始值传入的 Adapter 参数说明 返回值 补充说明 环境 运行环境 版本 Android 1.6 声明 连接库 Framework.jar 23

24 相关函数 GroupListAdapter:: getgroupheaderlist 格式定义 public ArrayList<GroupHeader> getgroupheaderlist() 功能说明 返回 GroupHeader 数组 参数说明 返回值 ArrayList<GroupHeader> 补充说明 环境 运行环境 版本 Android 1.6 声明 连接库 Framework.jar 相关函数 使用示例 基于 GroupListAdapter 派生子类 Public class CustomListAdapter extends GroupListAdapter { Public CustomListAdapter(Context context) { Super(context); } //创建 Group Headers 数组 Public void creategroups() { // 每个 Group Header 需要对应一个 GroupHeader 对象 所有的 GroupHeader 对象保存在 GroupHeaderList 中 通过调用 getgroupheaderlist 返回 ArrayList<GroupHeader> groupheaders = getgroupheaderlist(); //创建一个 GroupHeader GroupHeader header = new GroupHeader CONTENTSTRING POSITION ; 24

25 //将 Header 加入到数组中 groupheaders.add(header); } } //创建 Header 的视图 Public View getgroupheaderview(context context, GroupHeader header) { } 而在一个普通 ListView 中 使用 CustomListAdapter ListView list; ArrayAdapter adapter = new ArrapAdapter(context, simletext, strlist); CustomListAdapter container = new CustomListAdapter(adapter); List.setAdapter(container); 4.3.5ToolBarButton 类名称 android.widget.toolbarbutton 25

26 效果图 E1.bmp 示意图 S1a.bm p 矢量图 V1 具体描述 重要说明 放置在应用底部的 快捷操作 button 系统定义了一个全局公共变量 rockettoolbarheight 可用于设置该 TabButton 的高 在 Layout.XML 用法 如下 android:layout_height="? android:attr/rockettoolbarheight" 26

27 4.3.6BottomTabActivity 类名称 效果图 E1.bmp android.app. BottomTabActivity 示意图 S1a.bm p 矢量图 V1 具体描述 重要说明 该 Activity 与 TabActivity 的使用方式完全一致 不同 在 于 TabActivity 的 Tabs 显 示 在 视 图 顶 部 而 BottomTabActivity 显示在视图底部 关于 TabActivity 和 BottomTabActivity 的说明 27

28 TabActivity 中可以得到控件 TabHost, TabWidget BottomTabActivity 中 可 以 得 到 控 件 BottomTabWidget,BottomTabHost 如 果 在 实 现 的 时 候 不 通 过 TabActivity 或 者 BottomTabActivity 的方式 那么需要使用对应的正确控 件 4.3.7TabButtonTop Overview 类名称 效果图 E1.bmp android.widget.tabbuttontop 28

29 示意图 S1a.bm p 矢量图 V1 具体描述 放置在顶部 增加一种保持的状态 当应用需要类似 Tab 的效果时 可以采用这种 button 来模拟 该 Button 有类似 RadioButton 的属性 比如可以放 入 RadioGroup 中 这样可以实现自动的互斥 可以 设置 Checked 属性等 重要说明 使用方式和普通的 Button 一样 但是需要用户自己调 整宽高 系统定义了一个全局公共变量 rockettabheight 可用 于设置该 TabButton 的高 在 Layout.XML 用法如下 android:layout_height="? android:attr/rockettabheight" 使用示例 <LinearLayout xmlns:android=" android:orientation="vertical" android:layout_width="fill_parent" android:layout_height="fill_parent"> <RadioGroup android:layout_width="fill_parent" android:layout_height="wrap_content" android:orientation="horizontal" > <TabButtonTop android:id="@+id/tabbtn1" android:layout_width="50dip" android:layout_height="wrap_content" android:text="@string/linear_layout_9_button" /> <TabButtonTop android:id="@+id/tabbtn2" android:layout_width="50dip" android:layout_height="wrap_content" android:text="@string/linear_layout_9_button" /> <TabButtonTop android:id="@+id/tabbtn3" android:layout_width="50dip" android:layout_height="wrap_content" android:text="@string/linear_layout_9_button" /> 29

30 <TabButtonTop android:layout_width="50dip" android:layout_height="wrap_content" /> </RadioGroup> <ListView android:layout_width="fill_parent" android:layout_height="wrap_content" android:layout_weight="1.0" /> </LinearLayout> 4.3.8TabButtonBottom Overview 类名称 效果图 E1.bmp android.widget.tabbuttonbottom 30

31 示意图 S1a.bm p 矢量图 V1 具体描述 放置在底部 增加一种保持的状态 当应用需要类似 Tab 的效果时 可以采用这种 button 来模拟 重要说明 使用方式和普通的 Button 一样 系统定义了一个全局 公共变量 rockettabheight 可用于设置该 TabButton 的高 在 Layout.XML 用法如下 android:layout_height="? android:attr/rockettabheight" 31

32 使用示例 <LinearLayout xmlns:android=" android:orientation="vertical" android:layout_width="fill_parent" android:layout_height="fill_parent"> <ListView android:layout_width="fill_parent" android:layout_height="wrap_content" android:layout_weight="1.0" /> <RadioGroup android:layout_width="fill_parent" android:layout_height="wrap_content" android:orientation="horizontal" > <TabButtonBottom android:layout_width="50dip" android:layout_height="wrap_content" /> <TabButtonBottom android:layout_width="50dip" android:layout_height="wrap_content" /> <TabButtonBottom android:layout_width="50dip" android:layout_height="wrap_content" /> <TabButtonBottom android:layout_width="50dip" android:layout_height="wrap_content" /> </RadioGroup> </LinearLayout> 4.3.9显示 /隐藏 AlertDialog 按钮 格式定义 public void setdefaultbutton(boolean b); 32

33 功能说明 在开发过程中发现有些场景要求AlertDialog不带任何Button 因此增加接口. 设置是否保留默认Button, true保留 默认 false取消 参数说明 b true 保留 默认 false 取消式 返回值 补充说明 环境 运行环境 版本 Android 1.6 声明 连接库 Framework.jar 相关函数 SlideButton 类名称 效果图 E1.bmp android.widget.slidebutton 示意图 S1a.bmp 矢量图 V1 具体描述 <ScrollView xmlns:android=" /android" android:layout_width="fill_parent" android:layout_height="wrap_content"> 33

34 <SlideButton android:layout_width="fill_parent" android:layout_height="wrap_content"> </ SlideButton > </ScrollView> 重要说明 ContentTop 区域背景设置 类名称 效果图 E1.bm p 34

35 示意图 S1a.b mp 矢量图 V1 具体描 述 <LineraLyout: android:layout_width="fill_parent" android:layout_height="wrap_content"> android:background <Button android:layout_width="fill_parent" android:layout_height="wrap_content"> </Button > </LinerLayout> 重要说 明 ContentBottom 区域背景设置 类名称 效果图 E1.bmp 35

36 示意图 S1a.bm p 矢量图 V1 具体描述 <LineraLyout: android:layout_width="fill_parent" android:layout_height="wrap_content"> android:background <Button android:layout_width="fill_parent" android:layout_height="wrap_content"> </Button > </LinerLayout> 重要说明 带图标的 TextEdit 类名称 效果图 E1.bmp android:drawableright="@drawable/ic_btn_search 示意图 S1a.bmp 矢量图 V1 具体描述 <EditText android:id="@+id/filter" android:layout_width="240dip" android:layout_height="wrap_content" android:layout_gravity="right 36

37 center_vertical" android:singleline="true" android:layout_weight="1" android:drawablepadding="10dip" /> 重要说明 字体的使用 系统支持通过主题的切换实现系统和应用程序的字体变更 按照字体大小和颜色 可以使用的已定义尺寸分为 textappearancelarge ( 30sp*30sp 白色) textappearancelargeinverse (30sp*30sp 黑色) textappearancemedium (24sp*24sp, 白色) textappearancemediuminverse(24sp*24sp, 黑色) textappearancesmall(22sp*22sp, 白色) textappearancesmallinverse(22sp*22sp, 黑色) 标准字体 用于显示主要信息 绝大部分内容用标准字体显示 如邮件正文 菜单 列表项 标题 Soft key 引导区文字等 大字体 用于显示重要信息 如应用标题 小字体 用于显示次要信息如信息的次要内容 时间 大小等 使用方式举例 Android:textAppearance=?android:attr/textAppearanceSmall 表示控件字体采 用当前主题的 textappearancesmall 定义 Popup menu 提示效果 对于带有 Popup Menu 的窗口 系统会在屏幕底部给出适当的视觉提示 如下图 左侧截图 红圈内为弹出菜单的提示效果 右侧截图为点击 menu 后弹出菜单的效果 37

38 为了在进入带有 PopupMenu 的窗口时显示视觉提示 对所有带有 PopupMenu 的 Activity 在 oncreate 函数中 在调用 setcontentview()之前加上下面的语句 import android.view.windowmanager: public void oncreate(bundle bundle) {... getwindow().addflags(windowmanager.layoutparams.flag_rocket_menu_notify); //进入窗 口时显示提示动画... setcontentview( ); } Context 新增函数 Context:: setlockpaper 格式定义 public void setlockpaper(bitmap bitmap) throws IOException; 功能说明 设置锁屏背景图 背景图尺寸为 480*800 参数说明 bitmap 需要设置的图像 38

39 返回值 补充说明 环境 运行环境 版本 Android 1.6 声明 连接库 Framework.jar 相关函数 Activity:: setcontacticon 格式定义 public void setcontacticon(bitmap bitmap) throws IOException; 功能说明 设置 homescreen 中联系人的默认图标 参数说明 bitmap 需要设置的图像 返回值 补充说明 环境 运行环境 版本 Android 1.5 声明 连接库 Framework.jar 相关函数 4.4Java 支持 Java Support 4.4.1Overview JSR 规范支持 4.4.2JSR 规范支持列表 JSR139 JSR118 JSR120 JSR135 JSR185 (Connected Limited Device Configuration 1.1) (Mobile Information Device Profile 2.1) (Wireless Messaging API 1.1) (Mobile Media API 1.2) (Java Technology for Wireless Industry 1.0) 39

40 JSR75 ( FileConnection +PIM) JSR184 (Mobile 3D Graphics 1.1) JSR177 (SATSA-CRYPTO) 4.4.3Java 程序安装 1 从 sd 卡及文件管理器安装 文件管理中访问 sd 卡上的 jar 或 jad 文件 即可调起 java 虚拟机进行安装 2 从网络及浏览器安装 从浏览器访问指向 jar 或 jad 的链接 即可调起 java 虚拟机进行安装 4.4.4Java 程序卸载和设置 在 应用卸载 中选择 java 程序进行卸载以及设置 点击 J2ME 进入 4.4.5Java 程 序 通 过 AMS 进 行 内 存 设 置 Setting the memory in AMS 通过这项设置 可以修改 java 程序运行时所能分配到的最大内存 最大可以设为 8M 默认是 4.5M. 操作步骤 Operation step 1.Run Uninstall from launcher 2. Invoke the application J2ME setting 3. Select the memory configure setting 4. select a memory configure input the size request to config, K bytes as unit 4.4.6Java 程序通过配置文件进行内存设置 Pre-set a memory throgh extract the jad attribute Attribute description Key Config-Heap-Size Value the bytes of integer string The value must use digit character, otherwise will use default heap size. 4.5M For example Config-Heap-Size: Unit is Bytes 40

41 4.4.7Java 程 序 通 过 AMS 进 行 运 行 方 向 设 置 Setting the orientation in AMS 通过这项设置 可以强制 java 程序以固定的屏幕方向运行 默认是根据系统方向运行 即 Gsensor 的方向 Operation step Run Uninstall from launcher Invoke the application J2ME setting Select the orientation setting select items Landscape/portrait/system Java 程 序 通 过 配 置 文 件 进 行 运 行 方 向 设 置 Pre-set a oritentation throgh extract the jad attribute Attribute description Key Screen-Orientation Value Landscape Portait The value will ignore the upper/lower case. For Example Screen-Orientation: Landscape Screen-Orientation: Portrait 4.5下载管理器 Download Manager 4.5.1Overview 对 android 自带的浏览器接口进行了封装 以提供更好的下载管理接口 4.5.2开发接口概述 APIs 类或接口 Browser 成员方法和变量 void startandownload(context c, string url, File despath) void 修改 新增 新增 描述 Package: android.provider c : 上下文参数, url: 需要下载 Url despath: 下载保存的路径 可以 是路径,也可以是带文件名的全 路径,请确保 despath 存在,否则 将会发生不可预料的错误 c : 上下文参数 41

42 startandownload(context c, string url, ContentValues v); void showdownloadmanager(conte xt c, Boolean isalldata) 新增 url: 需要下载的 URL v: download 数据库名值对 遵 循 android download 规范 c : 上下文参数. isalldata: 需 要 显 示 全 部 的 下 载内容 更详细的描述请参见 APIs Reference 的相应部分 4.5.3开发示例 1 首先要在 AndroidManifest.xml 中申请访问 DownloadManager 的权限 <uses-permission android:name="android.permission.access_download_manager"/> 2 导入需要的包文件 import android.provider.browser; 3. 调用下载接口并显示下载状态 String url = ; Browser.startAnDownload(this,url. /userdata/download/ rm ); // 如果重名,会自动 添加数字 Browser.showDownloadManager(this,true); // 显示所有下载数据 //Browser.showDownloadManager(this,false); // 只显示本进程下载的数据 4.6存储管理 Storage Management 乐 Phone 系统提供 512M 手机内置 flash 存储 应用实际可用大概为 300M 乐 Phone 标配 8G SD 存储卡 为应用提供大容量的数据存储 本节主要介绍对 8G SD 存储卡的存储规范 标配 SD 存储卡预置文件目录如下 公有数据路径 1 picture 路径 Environment.getExternalStorageDirectory()/picture 2 music 路径 Environment.getExternalStorageDirectory()/music 3 video 路径 Environment.getExternalStorageDirectory()/video 4 document 路径 Environment.getExternalStorageDirectory()/document 5 download 6 record 私有数据路径 路径 Environment.getExternalStorageDirectory()/download 路径 Environment.getExternalStorageDirectory()/record 路径 Environment.getLenovodataDirectory()/yourappname 42

43 访问规范 1 任何程序都有权限访问公有数据路径下的数据 2 私有数据路径只允许创建该路径的应用程序访问 3 务必分别使用Environment.getExternalStorageDirectory()和 Environment.getLenovodataDirectory()访问公有数据和私有数据路径而不是使用绝 对路径 4 如果您的数据需要保存在SD存储卡上 访问前需要判断是否有SD卡 并且要监控SD卡 的状态 当用户选择以U盘方式把乐Phone连接到PC 这个时候SD卡在乐Phone是不可见 的 4.7支付接口说明 4.7.1目的和适用范围 本节内容描述了乐 Phone 支付接口的调用接口约定 供可调用联想支付结算系统的应用程 序的开发人员使用 4.7.2定义 缩写和术语 第三方支付账号 商户 用户在与联想手机支付系统合作的第三方支付系统中的账户 例如支付宝账户 使用联想手机支付系统收费的联想合作伙伴 4.7.3支付的基本过程和模型 三方应用支付处理开发建议 场景一 有独立计费服务器 有独立计费服务器的应用在后台拥有一个服务器来集中记账 实现计费逻辑 该场景下我 们建议由计费服务器来生成并维护用户的订单 建议的流程参考下图 43

44 应用服务器 例如音乐服务器 ① ⑥ ⑤ 支付宝 银联 等联想支付合 作伙伴 ⑦ ④ ② ③ 应用客户端 例如音乐播放器 ① ② ③ ④ ⑤ ⑥ ⑦ ⑧ 联想支付平台 支付网关 ⑧ 联想本地 支付网关 创建订单(生成本地唯一订单号) 下载订单 将订单提交给本地支付网关 等待支付结果 提交支付请求 等待支付结果 提交支付请求给支付合作伙伴并完成支付 通知应用服务器对应订单的支付结果 通知联想本地支付网关该订单的支付结果 通知应用客户端支付结果 图 支付流程建议 注 整个支付过程中 步骤 7 可能因为网络的原因 而中断 所以 应用程序中 支付是否 完成 这一逻辑判断将以第⑥步服务器的确认为准 应用客户端需要对支付 API 返回的结果 进行合理的判断 特别的 当 API 返回结果是 PAY_FAILED 或 NETWORK_BREAK 时 应 用客户端应该主动向自己对应的应用服务器查询支付结果 场景二 单机版非网络程序 对于某些无应用服务器的客户端软件 若需要在程序内实现通过调用联想支付平台的 API 进行收费 则适用于本场景 由于没有服务器做后台的计费 此类应用需要由应用客户端自己产生一个唯一的订单号 一个 建议的方法是 采用 imei号+本机订单号 组合生成一个唯一的订单号 以确保不同的客户端不会 产生重复的订单号从而导致支付出错 在该应用场景下 支付的建议流程请参考下图 图

45 联想支付平台 支付网关 ④ ① 应用客户端 例如某单机版游戏 ① ② ③ ④ ⑤ ⑥ ③ 支付宝 银联 等联想支付合 作伙伴 ⑤ ② ⑥ 联想本地 支付网关 创建订单(生成本应用在联想支付平台的唯一订单号) 将订单提交给本地支付网关 等待支付结果 提交支付请求 等待支付结果 提交支付请求给支付合作伙伴并完成支付 通知联想本地支付网关该订单的支付结果 通知应用客户端支付结果 图 支付流程建议 注 整个支付过程中 步骤 3 和步骤 5 可能因为网络的原因 而中断 此时支付 API 返回 的结果可能是 PAY_FAILED 或 NETWORK_BREAK 应用客户端可以再次发送完全相同的订 单 订单号相同 去获取上一次支付的结果 特别的例子如下 例 1 游戏程序提交了一个订单号为 的支付请求给本地支付网关 本地支付网关 将支付请求成功发送给了联想支付平台服务器 支付平台从该用户的支付宝账户扣款成功 返 回时网络出现错误 也就是流程图 中的步骤 5 出错了 此时本地支付网关会返回 NETWORK_BREAK 错误码给应用程序 应用程序应该再次用同样的订单去调用支付接口 此时 若网络正常 会返回上一次支付结果 本例为 支付成功 例 2 游戏程序提交了一个订单号为 的支付请求给本地支付网关 本地支付网关 将支付请求成功发送给了联想支付平台服务器 支付平台从该用户的支付宝账户扣款失败 例 如余额不足 结果会返回给应用程序 应用程序需要提示用户 余额不足 无法完成支付 此时若用户通过其他手段往支付宝账号里完成了充值 再次回到应用程序 应用程序再次发出 支付请求 此时 不能再次使用同样的订单号 而应该生成一个新的订单号 因为之前的订单 号 在联系支付平台中已经存在 并已经处理完毕 余额不足 再次提交同 样的订单号 只会返回上次该订单的支付结果 4.7.4签名机制 支付接口的基本模式是 客户端本地应用通过 Intent 向本地支付网关传递参数 并 获得支付的结果 Intent 中传递的所有参数(除 sign 以外)按照参数名称字符升序的顺序串 联起来 如 p1=v1&p2=v2&p3=v3 构成待签名数据 按照第 4 节指定的方式对待签名数据进 行签名 例如 调用支付接口需要以下参数 description=泡泡龙 1.0 goods_id= goods_type=1 45

46 input_charset=utf-8 notify_url= partner_code= partner_order=1001 price=10 qty=1 那么待签名数据就是 description= 泡 泡 龙 1.0&goods_id=123456&goods_type=1&input_charset=utf-8&notify_url= der=1001&price=10&qty=1 签名注意事项 1 没有值的参数无需传递 也无需包含到待签名数据中 2 签名时将字符转变成字节流时指定的字符集要与input_charset保持一致 3 如果传递了input_charset参数 那么这个参数也应该包含在待签名数据中 4 与HTTP协议要求类似 通过Intent传递给本地支付网关的参数的值中如果存在特殊字 符 如 那么该值需要做URL Encoding 这样本地支付网关才能接受到正确的 参数值 这种情况下 做签名时使用的应该是原生值而不是encoding之后的值 例如 支 付接口示例中待签名数据是 description=泡泡龙 1.0&goods_id=123456&goods_type=1&input_charset=utf-8&notify_url= a.com&partner_code= &partner_order=1001&price=10&qty=1&st=e12kd ej12459e 而不是description=泡泡龙 1.0&goods_id=123456&goods_type=1&input_charset=utf-8&notify_url=http%3A%2F %2Fwww.sina.com.cn %2Fbillreturn.php&partner_code= &partner_order=1001&price=10&qt y= 签名方式 名称 DSA 说明 合作伙伴发送请求时 使用自己的密钥对待签名数据进行 DSA 签名 支付平台使用合作伙伴的公钥进行校验 支付平台返回 数据时 使用支付平台的密钥对待签名数据进行 DSA 签名 合 作伙伴使用支付平台的公钥进行校验 DSA 公私钥可以使用 OpenSSL 生成 如下 1. 生成 DSA 参数 openssl dsaparam -out dsa_param.pem

47 2. 生成私钥 openssl gendsa -out dsa_private_key.pem dsa_param.pem 3. 生成公钥 openssl dsa -in dsa_private_key.pem -pubout -out dsa_public_key.pem 4.7.6签名示例代码 本示例代码为 java 代码 包括 2 个 public 函数 GenSignatureKey 函数用于生成签名用 的公私钥 若不愿意用 openssl 来生成的话 gensignurl 用来生成带签名的 url 参数 import import import import import import import import import import import import import import java.net.urlencoder; java.security.keyfactory; java.security.keypair; java.security.keypairgenerator; java.security.privatekey; java.security.securerandom; java.security.signature; java.security.spec.pkcs8encodedkeyspec; java.util.arraylist; java.util.collection; java.util.collections; java.util.enumeration; java.util.list; java.util.properties; import org.apache.commons.codec.binary.base64; public class LenovoPaySignature { /** * 生成 DSA 密钥对 * */ static void GenSignatureKey() { try { KeyPairGenerator keygen = KeyPairGenerator.getInstance("DSA"); SecureRandom sr = new SecureRandom(); sr.setseed(system.currenttimemillis()); keygen.initialize(1024, sr); KeyPair keypair = keygen.generatekeypair(); System.out.println("Private Key: \r\n" + new 47

48 String(Base64.encodeBase64(keyPair.getPrivate().getEncoded(), true))); System.out.println("Public Key: \r\n" String(Base64.encodeBase64(keyPair.getPublic().getEncoded(), true))); } catch (Exception e) { e.printstacktrace(); } } + new /** * 生成请求 URL 参数 参数值中的特殊符号进行转义 * properties charset */ public String gensignurl(properties properties, String privatekey, String charset) { StringBuffer buffer = new StringBuffer(); if (charset == null charset.length() == 0) charset = "GBK"; String signstring = dsasign(properties, privatekey, charset); properties.setproperty("sign", signstring); properties.setproperty("sign_type", "DSA"); try { Enumeration<Object> enumeration = properties.keys(); for (int mark = 0; enumeration.hasmoreelements(); mark++) { String name = (String) enumeration.nextelement(); // 对参数值进行编码 值中的特殊字符进行转义 String keyvalue = (new StringBuilder(String.valueOf(name))).append("=").append( URLEncoder.encode(properties.getProperty(name), charset)).tostring(); if (mark < properties.size() - 1) buffer.append((new StringBuilder(String.valueOf(keyValue))).append("&").toString()); else buffer.append(keyvalue); } } catch (Exception e) { e.printstacktrace(); } 48

49 return buffer.tostring(); } /** * 对 properties 中数据进行 DSA 加密,生成签名字符串 * properties privatekey charset */ private String dsasign(properties properties, String privatekey, charset) { String sign = null; try { // 获取待加密 URL 参数 依据字母升序排序 String tosignstring = getsignaturecontent(properties); // 根据 String 生成 PrivateKey PrivateKey prikey = getprivatekey(privatekey); // 加密数据 Signature signature = Signature.getInstance("DSA"); signature.initsign(prikey); signature.update(tosignstring.getbytes(charset)); byte signbytes[] = signature.sign(); // 转换成 String sign = new String(Base64.encodeBase64(signBytes)); } catch (Exception e) { e.printstacktrace(); } return sign; } String /** * 将 Properties 中 属 性 依 据 升 序 进 行 排 序, 并 以 标 准 URL 参 数 格 式 输 出 (& 分 割),Properties 中的 sign 与 sign_type 不包含在内 * properties private String getsignaturecontent(properties properties) { StringBuffer content = new StringBuffer(); List keys = new ArrayList((Collection) properties.keyset()); Collections.sort(keys); 49

50 for (int i = 0; i < keys.size(); i++) { String key = (String) keys.get(i); if (key == null key.equalsignorecase("sign") key.equalsignorecase("sign_type")) { continue; } String value = properties.getproperty(key); content.append((new StringBuilder(String.valueOf(i!= 0? "&" : ""))).append(key).append("=").append(value).tostring()); } return content.tostring(); } /** * 根据 String 获得 DSA 私钥 * 经过 Base64 编码的私钥字符串 */ private PrivateKey getprivatekey(string keybase64encode) { PrivateKey privkey = null; try { KeyFactory keyfac = KeyFactory.getInstance("DSA"); byte[] keyencode = Base64.decodeBase64(keyBase64Encode.getBytes()); // PrivateKey 的 Encode 为 PKCS8 通过 PrivateKey.getFormat()可以验证 PKCS8EncodedKeySpec keyspec = new PKCS8EncodedKeySpec(keyEncode); privkey = keyfac.generateprivate(keyspec); } catch (Exception e) { e.printstacktrace(); } return privkey; } } 4.7.7接口定义 接口一般约定 联想支付服务器提供 HTTP 服务 第三方服务器通过 HTTP 访问服务器 访问的 URL 按下面 的规则生成 key1>=<value1>&< key2>=<value2> 返回值 XML 格式数据 50

51 应用服务器/联想支付服务器接口定义 异步通知 系统根据传入的notify_url 在后面加上下表中的参数及参数值 定时通知第三方服 务器支付的执行结果 若通知不成功会重复多次执行通知 参数名 notify_id partner_code partner_order pay_result orders error input_charset sign 描述 通知 ID 商户编号 商户订单号 支付结果 支付详情 由支 付信息拼接而成 错误代码 参数编码字符集 签名 最大长度 20 个字符 数字 字母 20 个字符 数字 字母 20 个字符 数字 字母 5 个字符 true 或 false 使用联想私钥对所有参数进行签 名 输出格式 partner_code= &partner_order=1001&pay_result=success&orders=泡 泡龙 &input_charset=utf-8&sign=daf4290efc9c55645a4 6b5cc86eb444d 在收到支付平台通知后 请按照自己需要的业务逻辑处理 并返回一个不包含任何 HTML标签的页面 里面仅包含 success 或者 fail 的文本串 注意请不要包含任何 其他的字符 如空格等 对应的 success 或者 fail 的含义请看下表 返回结果 结果说明 success 处理成功 结束发送 fail 处理失败 重新发送 验证通知接口 1 URL 2 URL 参数 参数名 描述 最大长度 notify_id 通知 ID 20 个字符 数字 字母 partner_code 商户编号 20 个字符 数字 字母 input_charset 参数编码字符集 sign 签名 3 返回值 XML 数据 数据格式定义见 ValidateNotify.xsd 说明 4 描述 客户端验证支付结果通知是否有效 5 说明 返回的 XML 数据中的签名 是联想服务器使用联想私钥对 Status=参数 进 51

52 行签名后的结果 验证联想签名的公钥 MIIBtzCCASwGByqGSM44BAEwggEfAoGBAP1/U4EddRIpUt9KnC7s5Of2EbdSPO9EAMMeP4C2USZpRV1AIlH7WT 2NWPq/xfW6MPbLm1Vs14E7gB00b/JmYLdrmVClpJ+f6AR7ECLCT7up1/63xhv4O1fnxqimFQ8E+4P208UewwI1 VBNaFpEy9nXzrith1yrv8iIDGZ3RSAHHAhUAl2BQjxUjC8yykrmCouuEC/BYHPUCgYEA9+GghdabPd7LvKtcNr hxuxmur7v6ouqc+vdmcz0hgmdrwveoutrzt+zxbxcbglrjfnej6ewofho3zwkyjmim4twweotufi0o4kouhiuz pnwrbqn/c/ohnwlx+2j6asq7zktxvqhrkimog9/hwuwfbpklzl6ae1ulzafmo/7pssodgyqaaogafdd/lhhpql resb4pl0wb2aj0w0rtj5v9yallunczbjtxuftmra6qqxcoodylcannhueujrhkplqrmaocqljlnnpj357qlvqm RpBTCWeJZS6HGQOzm7olL8sPUTWYpnD+LQg3xyxx9TooxtPQhiTbDlEHc6/mRnEWgdv87aNjueo= 客户端调用接口定义 1.接口描述 手机本地支付网关和相关支付 SDK 中的功能实现基本模式是将本地应用程序的支付请求按照 支付功能的不同 构造出符合对应支付接口要求的请求发送给相应的支付服务器 然后将服务 器返回的支付结果通知本地应用程序 2.支付请求 用户可以通过 SDK 中提供的 请求支付 API 接口 提交支付请求 后台的具体支付过程将 由 SDK 内部完成 对提出请求的应用程序完全透明 2.1 获得支付确认 对于提交的支付请求 给予支付确认 包括支付成功 支付失败 以及失败原因 2.2 申请退款 暂不提供 退款申请建议不在 SDK 中实现 而是提供专门的退款申请网页 通过该网页直接提交 相关部门对退款请求进行评审 评审通过后则执行转账等退款操作 2.3 查看支付记录 暂不提供 SDK 中暂不提供支付记录查询接口 个人的支付信息可以在联想支付服务器上以网页 的信息提供查询 另外各个支付服务器 例如支付宝 上也可以查到交易记录 3 接口定义 3.1 支付请求接口 1 (Android 应用, 支付 Service) 接口编号 ROCKET_PAY_1 说明 系统中各应用可通过绑定支付 Service,调用 aidl 中提供的支付接口来进行支付操作 编 译时需要将此文件解压后放入工程目录中进行编译 如下图 直接放在/src 目录下 不 要改变文件路径 52

53 payment_aidl.zip 支付 aidl: com.lenovo.util. IPayObserver.aidl package com.lenovo.util; interface IPayObserver { void payresult(string resultstring); } com.lenovo.util. IPayService.aidl package com.lenovo.util; import com.lenovo.util.ipayobserver; Interface IPayService { void pay(string querystring,ipayobserver observer); } 参数 参数名 (key) goods_type 描述 分类 id goods_id 应用 id qty price 购买数量 单价 description 商品描述信息 partner_code 商户编号 partner_orde r 商户订单号 最大长度 20 个字符 数 字 字母 20 个字符 数 字 字母 2 位整数 6 位小数 精 确到小数点后 两位 50 个汉字 20 个字符 数 字 字母 20 个字符 数 字 字母 说明 商户自定义的商品分类 商户自定义的商品 id 要求在商 户内部唯一 不同的商品不能用 同一个商品 id 用户购买该商品的数量 商品的价格 单位为元 商户给该商品的描述文字或者对 该笔交易的附注文字 联想给予的商户编号 商户自己产生的订单号 不同的 订单必须使用不同的订单号 相 53

54 同的订单号被当做重复提交的订 单 只返回第一次订单的执行结 果 而不做其它任何动作 input_charse t notify_url 参 数编 码字 符 集 针 对该 交易 的 交 易状 态异 步 通知接收 URL 商户用于接收联想支付服务器异 步通知的服务器的 url 地址 若 商户不需要该异步通知 可以不 给 本 参 数 注 由于手机信号的可靠性和稳 定性的问题 可能在联想支付服 务器给手机返回支付结果时由于 各种线路问题 手机未能收到支 付结果 商户的客户端软件需要 妥善处理此种情况 sign 签名 签名的具体方法请参考第 4 5 节 签名机制 和 签名方式 参数组织格式 <key1>=<value1>&< key2>=<value2> 例 description=paopaolong1.0&goods_id=123456&goods_type=1&input_charset=utf-8 &notify_url=http%3a%2f%2fwww.sina.com.cn %2Fbillreturn.php&partner_code= &partner_order=1001&price=1 0&qty=1&sign=daf4290efc9c55645a46b5cc86eb444d 特别说明 与 HTTP 协议要求类似 通过 Intent 传递给本地支付网关的参数的值中如果存 在特殊字符 如 那么该值需要做 URL Encoding 这样支付网关才能接受到正确的 参数值 但是这种情况下 做签名时使用的应该是原生值而不是 encoding 之后的值 具体内容 参考第 4 5 节的描述 接口返回值 返回码 数据类型 String OK CANCEL NO_ACCOUNT_INFO PAY_FAILED NETWORK_BREAK NOT_EXIST_USER CONNECTION_ERROR ILLEGAL_ARGUMENT 描述 支付成功 服务器转账成功 支付取消 用户中途取消了本次支付过程 没有 发生与服务器的任何交互 用户未登录 支付失败 支付失败 解析服务器返回的支付结果时出错 支付异常中断 通常是指网络连接中断等情况 服务器侧是否支付成功状态未知 此时需要应用 程序去联系应用服务器或者再次调用本接口去获 得该商户订单的支付结果 用户在联想账号系统中不存在 支付平台与支付宝网络连接异常 输入参数有错误 54

55 ILLEGAL_SIGN SYSTEM_ERROR ILLEGAL_SYSTEM NOT_EXIST_SIGN_CUSTOMER ILLEGAL_SERVICE_TIME_OUT STATUS_CUSTOMER_HAS_SIGN NOT_EXIST_PARTNER_TYPE_CODE NOT_EXIST_CUST_SIGN STATUS_CUSTOMER_SIGN TOO_MUCH_TYPE_CODE OUTUSERID_NOT_BINDING PARTNER_PROTOCOL_INVALID CUSTOMER_PROTOCOL_INVALID DUPLICATE_OUT_ORDER_NO USER_BALANCE_NOT_ENOUGH EXCEED_LIMIT NOT_EXIST_CUSTOMER TRADE_NOT_EXIST 签名错误 系统错误 支付宝系统错误 签约客户不存在 签约服务超期 您已经签约 合作伙伴的签约信息不存在 客户签约信息不存在 客户签约状态非正常 合作伙伴存在多条签约信息 没有绑定外部用户 ID 商户协议未签订 客户协议未签订 重复的外部订单号 用户余额不足 支付超限 不存在该签约客户(不是支付宝用户) 交易不存在 示例代码 private final static String queuestring = "sign=mcwcfg1jirrblmkl9piqs4vo2nsywmzuahqqsyggrthswpuwhhy10ffhp 87uiQ%3D%3D&notify_url=http%3A%2F %2Fwww.google.com&goods_type=1&price=0.1&goods_id=1&partner_cod e= &description=%c5%dd%c5%dd %C1%FA1.0&sign_type=DSA&qty=1&input_charset=GBK&partner_order=1 001"; IPayService protected void oncreate(bundle savedinstancestate) { super.oncreate(savedinstancestate); Intent intent = new Intent(IPayService.class.getName()); bindservice(intent, mconnection, Context.BIND_AUTO_CREATE); } private ServiceConnection mconnection = new ServiceConnection() { public void onserviceconnected(componentname name, IBinder service) { mpayservice = IPayService.Stub.asInterface(service); try { mpayservice.pay(queuestring, mipayobserver); 55

56 } catch (RemoteException e) { // TODO Auto-generated catch block } } public void onservicedisconnected(componentname name) { mpayservice = null; } }; private IPayObserver mipayobserver = new IPayObserver.Stub() { public void payresult(string resultstring) throws RemoteException { Toast.makeText(PayTest.this, "pay result: "+resultstring, Toast.LENGTH_SHORT).show(); } protected void ondestroy() { unbindservice(mconnection); super.ondestroy(); } 3.2 支付请求接口 2 (J2ME 应用) 接口编号 ROCKET_PAY_2 SDK 1.0 中暂不支持本接口 应用服务器/联想支付服务器接口数据格式定义 1. ValidateNotify 定义 1.1 支付确认接口地址 仅供测试使用 需要提前通知 Schema <?xml version="1.0" encoding="utf-8"?> <xs:schema xmlns:xs=" 56

57 xmlns="billingservice" targetnamespace=" BillingService " elementformdefault="qualified"> <xs:element name="validatenotify"> <xs:annotation> <xs:documentation>异步通知有效性验证结果</xs:documentation> </xs:annotation> <xs:element name="status" type="xs:string"> <xs:annotation> <xs:documentation>验证结果 T代表通知有效 F代表通知无效< /xs:documentation> </xs:annotation> </xs:element> <xs:element name="sign" type="xs:string" > <xs:annotation> <xs:documentation>数据签名</xs:documentation> </xs:annotation> </xs:element> </xs:element> </xs:schema> 1.3 示例 1 <ValidateNotify> <Status>T</Status> 57

58 <Sign>MCwCFE3Kbtm56GioIEtBK4x2iUXyT1YQAhREH%2FyPq %2FWyWknprjG6Z1kj8UJgvw%3D%3D</Sign> </ValidateNotify> 1.4 示例 2 <ValidateNotify> <Status>F</Status> <Sign>MCwCFE3Kbtm56GioIEtBK4x2iUXyT1YQAhREH%2FyPq %2FWyWknprjG6Z1kj8UJgvw%3D%3D</Sign> </ValidateNotify> 错误码定义 错误码(Code) NOT_EXIST_USER NOT_EXIST_CUSTOMER ILLEGAL_ARGUMENT NOT_EXIST_CUST_SIGN ILLEGAL_SYSTEM 描述 用户不存在 用户不是支付宝用户 输入参数有错误 用户账户未绑定 系统错误 58

59 4.8视频播放器接口 4.8.1视频播放器截图 4.8.2接口调用方法 *********************** 调用播放视频 示例代码 ******************************* public class testactivity extends Activity { private static final String TAG = "test"; 59

60 @Override public void oncreate(bundle savedinstancestate) { super.oncreate(savedinstancestate); setcontentview(r.layout.main); new AlertDialog.Builder(this).setMessage("confirm").setPositiveButton(R.string.str_1, new DialogInterface.OnClickListener() { public void onclick(dialoginterface dialog, int which) { Uri uri = Uri.parse( " //Uri uri = Uri.parse( "rtsp://*****/***/***.mp4"); //Uri uri = Uri.parse( "/sdcard/*****/***/***.mp4"); Intent intent=new Intent(); intent.setaction(android.content.intent.action_view); intent.putextra("caller", "OTHER"); intent.setdataandtype(uri, "video/*"); startactivity(intent); } }).setnegativebutton(r.string.str_2, new DialogInterface.OnClickListener() { public void onclick(dialoginterface dialog, int which) {} }).show(); } } 参数说明 Uri 播放源文件的地址 可以为网络地址 http 或 rtsp 也可为本地 地址 /sdcard/**/**.mp4.rmvb.avi 等 Caller 第 3 方应用可以用 OTHER 标识 DataAndType uri 如上 "video/*" 标识调起视频播放器 60

61 4.9图片管理应用接口 4.9.1查看图片 使用带参数 ACTION_VIEW 的 intent 即可调用乐 phone 的图片管理查看图片 向这个 intent 写进一个地址(uri)和格式(type) uri 为 String 型 可以是绝对路径 也可以是网络地址 也可以是数据库的 uri 地址 示例代码 Intent intent = new Intent(); intent.setaction(android.content.intent.action_view); intent.setdataandtype(uri, "image/*"); //Uri 为发送的图片 startactivity(intent); 4.9.2调用图片作为附件 使用带参数 ACTION_GET_CONTENT 或 ACTION_PICK 的 intent 调用乐 phone 的图片管理 进 入缩略图模式 选中图片 即可对返回的图片进行自己的操作处理 示例代码 Intent intent = new Intent(Intent.ACTION_GET_CONTENT); startactivityforresult(intent, REQUEST_PICK_CONTACT); 图片模块的返回值为 //img 为选中的图片 Intent result = new Intent(null, img.fullsizeimageuri()); setresult(result_ok, result); 4.10Camera 接口 Overview 依据不同需求 提供调用前后置摄像头进行拍照和摄影的接口 可约定项 1. 前后置摄像头的选择 2. 拍照和摄像功能的选择 3. 对输出数据类型的选择 目前输出数据的类型只能选取一项 即只可获取一种类型的 数据 其优先顺序为 Path Uri Bitmap 61

62 4.10.2开发接口概述 APIs 接口 Camera 调用 CamCorder 调用 参数 intent 取值 MediaStore.ACTION _IMAGE_CAPTURE 描述 Open camera image. camerasensortype {1, 2} 1:3M_camera 2:300K_camera needpath {true, false} true:image path will be returned by key "path" false: Image path will not be returned, default return is bitmap needuri {true, false} intent MediaStore.ACTION _VIDEO_CAPTURE true:image uri will be returned by key "uri" false: Image uri will not be returned, default return is bitmap Open camcorder for recording video. extra MediaStore.EXTRA_ SIZE_LIMIT (long) Set the max size of video file that will be recorded. camerasensortype {1, 2} 1:3M_camera 2:300K_camera needpath {true, false} true:image path will be returned by key "path" false: Image path will not be returned, default return is bitmap for capturing 开发示例 示例代码 //capture Image Intent intent = new Intent(MediaStore.ACTION_IMAGE_CAPTURE); intent.putextra("camerasensortype", 1); intent.putextra("needpath", true); intent.putextra("needuri", true); startactivityforresult(intent, REQUEST_CODE_TAKE_PICTURE); 62

63 //record video Intent intent = new Intent(MediaStore.ACTION_VIDEO_CAPTURE); intent.putextra(mediastore.extra_size_limit, sizelimit); intent.putextra("camerasensortype", 1); intent.putextra("needpath", true); startactivityforresult(intent, REQUEST_CODE_TAKE_VIDEO); 4.11图片管理应用接口 查看图片 使用带参数 ACTION_VIEW 的 intent 即可调用乐 phone 的图片管理查看图片 向这个 intent 写进一个地址(uri)和格式(type) uri 为 String 型 可以是绝对路径 也可以是网络地址 也可以是数据库的 uri 地址 示例代码 Intent intent = new Intent(); intent.setaction(android.content.intent.action_view); intent.setdataandtype(uri, "image/*"); //Uri 为发送的图片 startactivity(intent); 调用图片作为附件 使用带参数 ACTION_GET_CONTENT 或 ACTION_PICK 的 intent 调用乐 phone 的图片管理 进 入缩略图模式 选中图片 即可对返回的图片进行自己的操作处理 示例代码 Intent intent = new Intent(Intent.ACTION_GET_CONTENT); startactivityforresult(intent, REQUEST_PICK_CONTACT); 图片模块的返回值为 //img 为选中的图片 Intent result = new Intent(null, img.fullsizeimageuri()); setresult(result_ok, result); 63

64 4.12 乐 phone 的 HTTP 代理设置和使用 自动设置 http 代理的类: org.apache.http.impl.client.defaulthttpclient java.net.httpurlconnection 需 要 注 意 的 是 因 为 没 有 https 代 理 服 务 器 所 以 https 代 理 功 能 从 未 验 证 过 org.apache.http.impl.client.defaulthttpclient javax.net.ssl.httpsurlconnection 使用 webview 的应用请注意 如果需要webview控件自适应代理服务器需要在Activity中增加以下代码 onresume() { WebView.enablePlatformNotifications Super.onResume(); } onpause() { WebView.disablePlatformNotifications() Super.onPause; } 5用户交互设计准则 UI Guideline 为了向终端用户提供一致有效的使用体验 我们给出 UI 设计准则以指导开发者进行 UI 设 计 以下的内容建议你在阅读 UI 设计准则前能够了解 1 系统提供了 UI Guideline 中提及的所有可视控件 2 建议开发者优先使用 UI Guideline 中提及的控件和 layout 设计 3 也欢迎开发者在 UI 上的极致创新 但务必确保适配乐 Phone 设备 且不存在明显影响 用户使用的交互设计 具体的设计准则请参见 乐 Phone UI guideline 文档 64

65 6LCA 软 件 全 生 命 周 期 管 理 LCA Software Lifecycle Management 6.1应用开发规约 6.1.1软件内容合规性 软件的内容应该符合国家法律法规 不允许包含反动 色情等违法信息 6.1.2交互设计规范 应符合乐 Phone 交互设计规范 建议开发者优先使用 UI Guideline 中提及的控件和 layout 设计 开发者自设计 UI 务必确 保适配乐 Phone 设备 且不存在明显影响用户使用的设计 具体可参见 乐 Phone UI guideline 文档 6.1.3技术规约 对系统资源的使用 对于一般的应用程序 限制运行时占用的内存不能超过 8M 如需要更多内存 请与联想沟 通 大数据存储应采用外部存储介质 比如 SD 卡 禁止大量占用手机内置存储 影响系统正常 运行 应用退出策略 当用户处在应用程序的第一页 点击 B 区的 back 按钮 程序应当被关闭而不是在后台 运行或者挂起 一些特殊的 确实需要在后台运行的程序例外 比如音乐播放器等 特别注意 若应用程序会在后台继续运行 请在提交应用时给予说明 以便管理者对该应 用进行专门的性能测试 包括后台电量消耗 系统性能等专项测试 以保证用户流畅的使用体 验 对于在提交程序时未声明该程序会在后台继续运行的情况 管理员通过常规测试发现了该 程序在后台运行的事实 管理员有权不予该程序上架到商城 而对于已经上架的程序则会视情 况予以下架 65

66 6.2开发者的注册和管理 6.2.1企业开发者 企业开发者可以在联想应用商城的开发者社区中注册账号 用以维护该企业发布的软件 注册的基本流程如下 1.同意注册协议并输入注册邮箱及密码 2.系统返回注册成功并提示企业开发者登录注册邮箱激活帐户 3.企业开发者登录注册邮箱 点击激活链接 账户注册成功 4.输入企业开发者合作信息 提交 5.合作信息审核通过后 双方签署合同 6.成为正式的开发者 可以上传并管理自己提交的应用 特别注意 企业开发者除需要提供企业相关信息外 需要至少提供 * 技术支持用的 (若该 地址不同于帐号的 需要激活) * 技术支持的电话号码 可选 企业应当根据其填写的信息生成标准的合同文本 企业打印签字盖章 和企业的其他资质 证明一起邮寄给联想审核 在联想盖章确认合同后方为审核通过 系统自动为开发者生成一个 缺省的分成比例 详细的注册流程和注册入口请访问 个人开发者 个人开发者可以在联想应用商城的开发者社区中注册账号 用以维护该企业发布的软件 注册的基本流程如下 1.同意注册协议并输入注册邮箱及密码 2.系统返回注册成功并提示个人开发者登录注册邮箱激活帐户 3.个人开发者登录注册邮箱 点击激活链接 账户注册成功 4.输入个人开发者合作信息 提交 5.合作信息审核通过后 双方签署合同 6.成为正式的开发者 可以上传并管理自己提交的应用 特别注意 个人开发者合作信息应当至少包括 * 银行账号/户名 * 技术支持用的 (若该 地址不同于帐号的 需要激活) 个人开发者可提供技术支持用的 IM 帐号 系统自动为开发者生成一个缺省的分成比例 详细的注册流程和注册入口请访问 66

67 6.3软件开发 Developing 6.3.1安装 SDK 下载 SDK 可访问 ftp://exc.lenovo.com 获取最新的 SDK 和文档 用户名和口令分别是 用户名 lenovo_file 口令 s69glghd 系统和软件配置要求 要通过乐 Phone SDK 中提供的代码和工具进行乐 Phone 应用程序的开发 还需要满足如下 的系统和软件配置要求 支持的操作系统 Linux 推荐 Windows XP 不推荐 支持的开发环境 Eclipse Eclipse 3.2,3.3(Europa)或更高 乐 Phone 开发工具插件 同 Android 1.6 JDK 安装 SDK 下载好 SDK 包后 将 zip 文件解压缩至合适的地方 在下文中 我们默认你的 SDK 安装目 录为$SDK_ROOT 你可以选择将$SDK_ROOT/tools 加入到你的路径中 Linux 环境 打开文件~/.bash_profile 或者~/.bashrc 找到设定 PATH 环境变量的 一行 将$SDK_ROOT/tools 的完整路径加入其中 如果没有找到设定 PATH 变量的行 你 可 以 自 己 添 加 一 行 export PATH=${PATH}:<你的$SDK_ROOT/tools 的完全路径> Windows 环境 右键点击 我的电脑 选择 属性 在 高级 页中 点击 环境变量 按键 在弹出的对话框中双击 系统变量 中的变量 Path 将$SDK/tools 的完 全路径加入其中 通过将$SDK/tools 加入系统路径 在运行 adb 和其它一些命令行工具时就不需要键入完全 路径名了 需要注意的是 当你升级了 SDK 后 如果安装路径有变动的话 不要忘记更新你的 PATH 变量的设置 将其指向变动后的路径 67

68 安装 Eclipse 插件(ADT) 如果你选择 Eclipse 作为 Android 的开发环境 可以安装一个专门为 Android 定制的插件 Android Development Tools(ADT) ADT 插件集成了对 Android 工程和工具的支持 它包含了 大量功能强大的扩展 使得创建 运行 调试 Android 程序更简单更快捷 如果你不打算使用 Eclipse 那么就不需要下载或者安装 ADT 插件 为了下载和安装 ADT 插件 请按照下面的步骤设置 Eclipse 的远程更新站点 1 启动 Eclipse 依次选择 Help > Software Updates > Find and Install... 2 在弹出的窗口中 选择 Search for new features to install 然后点击 Next 3 点击 New Remote Site 4 在弹出的对话框中 为远程站点输入一个自定义的名字 (例如 Android Plugin) 然 后 输 入 下 面 的 内 容 作 为 其 默 认 的 URL 然 后 点 击 OK 5 现在你应该可以在搜索列表中看见刚才新加入的站点了 (默认已经选中了) 点击 Finish 6 在随后的 Search Results 对话框中 选中 Android Plugin > Eclipse Integration > Android Development Tools 然后点击 Next 7 阅读许可协议 然后选择 Accept terms of the license agreement 点击 Next 8 点击 Finish 9 ADT 插件没有 signed 在安装过程中会弹出确认窗口 你只需要点击 Install All 就 可以了 10 重启 Eclipse 11 重启后 选择 Window > Preferences...打开 Preference 的面板 12 在左侧的面板中选择 Android 13 在主面板中 点击 Browse...定位到 SDK 的目录 14 点击 Apply,然后点击 OK 按照下面的步骤将你的 ADT 插件升级到最新版本 6 选择 Help > Software Updates > Find and Install... 7 选择 Search for updates of the currently installed features 然后点击 Finish 8 如果 ADT 插件有任何更新 选择并且安装 另一种更新的方法 1 选择 Help > Software Updates > Manage Configuration 2 在其中找到 Android Development Tools <版本号>并选中 3 在 Available Tasks 下选择 Scan for Updates 6.3.2在 Eclipse 上开发 Android 应用程序 (注 更详细的说明请参见 SDK 附带文档中的 Dev Guide Developing 部分) 68

69 创建 Android 工程 ADT 插件提供了一个创建新工程的向导以使你能够快速的创建一个新的 Eclipse 工程或者 为现有代码创建一个新工程 按照以下步骤来创建一个工程 1. 选择 File > New > Project 2. 选择 Android > Android Project 然后点击 Next 3. 在 Content 中选择 Project a) 选 择 Create new project in workspace 以 创 建 一 个 新 的 工 程 键入工程的名字 你程序的名称 base package 的名字,Activity class 的名字 来创建一个 stub.java 文件 b) 选择 Create project from existing source 从现有代码创建一个工程 通过这种方式 你可以编译运行 SDK 里面 sample 中的应用程序 sample 应用程序 在 SDK 安 装 目 录 下 的 samples/ 中 找到包含有现有代码的路径并点击 OK 如果路径中含有一个有效的 Android 的 manifest file ADT 插件就会加载包名 程序名 activity 名 4. 点击 Finish ADT 插件会根据你的工程的类型创建以下合适的文件夹和文件 src/文件夹包含 stub.java activity file res/文件夹包含你的资源文件 AndroidManifest.xml 是你工程的 manifest 创建启动配置 要想在 Eclipse 下运行并调试你的程序 你需要先创建启动配置 启动配置中指定了要启 动的工程 要用的模拟器选项等等 要给程序创建启动配置 按照如下步骤 1. 选择 Run > Open Run Dialog... 或者 Run > Open Debug Dialog 在左侧工程类型的列表中 右键点击 Android Application 并且选择 New 3. 给你的配置键入一个名字 4. 在 Android 的 Tab 页上 找到用于开始的工程和 Activity 5. 在模拟器 Tab 页上 设置需要的屏幕和网络属性 和其他一些模拟器启动选项 Skin 选择 WVGA 将获得 800*480 的分辨率 6. 在 Common 的 Tab 页上 你可以对一些附加的选项进行设置 7. 点击 Apply 保存启动配置 或者 点击 Run 或者 Debug 运行和调试程序 当你建立工程 并为你的程序设置好启动配置后 按照下面的步骤你就可以运行或者调试 你的程序了 在 Eclipse 的主菜单上选择 Run > Run 或者 Run > Debug 来运行或者调试可用的启动配 置 需要注意的是可用的启动配置默认的是最近一次在启动配置中选择的那一个 并不一定是 69