长虹智能电视应用开发Linux版用户SDK使用指南
前言概述长虹智能电视终端SDK是基于Android2.2平台针对电视系统进行功能化定制的应用程序开发工具,支持按键扩展、TV、支付、播放、连接、存储等核心功能,便于开发者针对电视平台的进行应用开发。产品版本适用于长虹智能电视终端产品系列应用要求分辨率为720P,适配Android系统 2.2版本,采用遥控器交互方式(末尾查看按键键值),适合大屏清新效果展示的合法应用。读者对象适用于具有java开发经验的android应用程序开发者整体框架http://wiki.smart-tv.cn/images/2/28/Whole-structure.jpg
说明:长虹智能电视终端SDK在Android原生SDK上融合了按键与核心功能API,通过android.jar包对SDK应用程序开发提供扩展支持,适合电视应用程序的开发。
系统要求操作系统支持如下操作系统:
>> Linuxs:Ubuntu(32bit) 10.04及以上开发环境要求由以下四部分组成:(1) JDK>> 在线下载:http://www.oracle.com/technetwork/java/javase/downloads/index.html
>> Ubuntu安装:终端命令:sudo apt-get install sun-java5-jdk(Android2.2及以下)或sudo apt-get install sun-java6-jdk(Android2.3及以上)(2) Eclipse>> 在线下载:http://www.eclipse.org/downloads/ ,Eclipse IDE for Java EE或Eclipse Classic
>> Ubuntu安装包:eclipse-jee-indigo-SR2-linux-gtk.tar.gz(3) ADT>> ADT插件:请注册(申请成为开发者 )后,登录账号到http://open.smart-tv.cn首页进行SDK包下载。(4) Development SDK>> Ubuntu平台:请注册(申请成为开发者 )后,登录账号到http://open.smart-tv.cn首页进行SDK包下载。
JDK运行环境搭建JDK Linux安装(1) sudo apt-get install sun-java5-jdk(Android2.2及以下)或sudo apt-get install sun-java6-jdk(Android2.3及以上)
(2) 安装状态检查:shell终端运行 java –version,如果显示版本信息则说明安装成功。否则进行如下环境变量配置:
a) /etc/profile文件最下面加上:
export JAVA_HOME=/usr/java/<JDK所在目录>
export JRE_HOME=/usr/java/<JDK所在目录>/jre
export CLASSPATH=.:$JAVA_HOME/lib/dt.jar:$JAVA_HOME/lib/tools.jar
export PATH=$JAVA_HOME/bin:$PATH
安装长虹SDK安装Eclipse1) 直接解压eclipse-jee-indigo-win32.zip(Linux下eclipse-jee-indigo-SR2-linux-gtk.tar.gz),无需安装。
2) 运行eclipse.exe(linux shell终端:./eclipse),弹出对话框,提示设置workspace路径,指定路径后点击“OK”
http://wiki.smart-tv.cn/images/e/ea/Install-eclipse.jpg安装ADT(1) 在eclipse软件界面中,选择Help >Install New Software
http://wiki.smart-tv.cn/images/0/0c/Install-adt.jpg
(2) 在弹出的界面中,点击“Add”,然后点击“Archive”,选择对应的changhong-adt_v1.0.zip压缩包,之后点击“OK”
http://wiki.smart-tv.cn/images/e/eb/Add-changhong-adt.jpg
(3) 在出现的“Developer Tools”列表中,选择“Android DDMS”和“Android Development Tools”,之后点击“Next”,按照提示完成下载及安装。安装完成后会提示需要重新启动Eclipse,此时,选择接受,重新启动Eclipse。
http://wiki.smart-tv.cn/images/b/bb/Install-adt-software.jpgSDK路径设置(1) 解压changhong-sdk_v01-windows.zip或者changhong-sdk_v01-linux.tar.bz2。
(2) 在Eclipse中选择Windows >Prefence> Android, 在“SDK Location”中指定压后的长虹sdk目录,点击“OK”即可。
http://wiki.smart-tv.cn/images/3/3c/Sdk-location.jpg
我的电脑图标上右键点击->属性->高级->最下方有个环境变量->在PATH 变量下加入长虹SDK 中platform-tools文件夹所在路径;(以便使用adb等工具)。如图所示:
http://wiki.smart-tv.cn/images/2/20/Sdk-path-setting.jpg
Ubuntu系统环境变量设置跟JDK设置一样加入platform-tools文件夹所在路径即可;配置并使用虚拟设备(1) 创建虚拟设备>> Eclipse中点击“Android SDK and AVD Manager”,弹出对话框。
http://wiki.smart-tv.cn/images/7/74/Sdk-avd-manager.jpg
>> 点击New,Name可以输入任意字符,Target需要与目前的产品版本匹配,Size为虚拟设备SD Card的大小,应个人电脑内存大小配置,推荐值为128,Skin选择ChangHong720pNoKeyboard,其他选择默认即可。
http://wiki.smart-tv.cn/images/4/4f/Create-new-virtual-device.jpg(2) 启动虚拟设备>> 选中相应的AVD点击右侧“Start”按钮,点击“Scale display to realsize”,根据个人显示要求配置模拟器缩放比例。
>> 然后点击“Launch”,等待一段时间后,虚拟终端便启动成功了。
http://wiki.smart-tv.cn/images/8/89/Avd-launch-option.jpg
模拟器运行成功如图所示:
http://wiki.smart-tv.cn/images/1/16/Tv-virtual-device.jpg
现在你就可以再CMD下输入adb shell 查看是否已经连通模拟器了;
可以运用adb install 你的apk文件 来安装你的运用了!
Android应用程序开发创建Android工程(1) 在Eclipse中选择File->New->Project->Android Project, 在弹出对话框中输入Project Name, 点击Next,如下图:
http://wiki.smart-tv.cn/images/c/cc/Creat-android-tv-project.jpg
(2) 选中Android2.2,再次点击Next:
http://wiki.smart-tv.cn/images/f/f6/Select-sdk-target.jpg
(3) 输入Package Name;如果需要自动创建一个Activity,则勾选Create Activity,并输入Activity的类名; Minimum SDK选择8。如需创建测试项目,则勾选Create a Test Project。设置完成后点Finish,创建工程完成。
http://wiki.smart-tv.cn/images/2/25/Creat-test-tv-activity.jpg运行调试程序(1) 运行编写好程序后,右键项目名称,选择Run As->Android Application即可
http://wiki.smart-tv.cn/images/0/01/Run-tv-application.jpg(2) 调试在程序中设置好断点,右键项目名称,选择Debug As->Android Application即可
http://wiki.smart-tv.cn/images/2/24/Run-android-tv-application.jpg
当程序运行至断点处,会弹出以下对话框
http://wiki.smart-tv.cn/images/2/24/Run-android-tv-application.jpg
选择Yes 即可进入到Debug界面。Debug的具体操作同Java Debug,这里不作赘述。
http://wiki.smart-tv.cn/images/9/9b/View-tv-application-debug.jpg通过adb安装产品包>> 通过adb安装包,不需要将apk包拷贝到手机的SD卡,只需要通过命令将安装包装到手机或模拟器上即可。
>> 安装程序:进入dos command界面进入安装包放置路径,执行”adb install <安装包名>”。
>> Windows系统下推荐图形化安装工具豌豆荚,下载地址:http://www.wandoujia.com/
利用adblogcat进行后台抓包1) 下拉选择log级别进行过滤,查看需要的日志信息
http://wiki.smart-tv.cn/images/0/0f/Get-log-with-adblogcat.jpg
2) 也可点击+号添加logcat filter进行过滤
http://wiki.smart-tv.cn/images/7/71/Add-logcat-filter.jpg
按键说明长虹智能电视遥控器图
http://wiki.smart-tv.cn/images/a/a9/Changhong-tv-control-device.jpgAndroid平台遥控器按键键值列表
序号功能Android应用层键名Android应用层键值
1电源KEYCODE_POWER26
2红色键KEYCODE_RED2011
3绿色键KEYCODE_GREEN2012
4黄色键KEYCODE_YELLOW2013
5蓝色键KEYCODE_BLUE2014
63DKEYCODE_CHANGHONGIR_3D4119
7信息键KEYCODE_INFOR2010
8指南KEYCODE_CHANGHONGIR_EPG4123
9帮助KEYCODE_CHANGHONGIR_HELP4120
10节目源KEYCODE_SOURCE2001
11应用KEYCODE_CHANGHONGIR_APP4121
12静音KEYCODE_MUTE91
13伸展/放大KEYCODE_CHANGHONGIR_SPREAD4116
14主场景KEYCODE_HOME4124
15捏合/缩小KEYCODE_CHANGHONGIR_PINCH4115
16菜单KEYCODE_MENU82
17返回KEYCODE_BACK4
18方向键上KEYCODE_DPAD_UP19
19方向键下KEYCODE_DPAD_DOWN20
20方向键左KEYCODE_DPAD_LEFT21
21方向键右KEYCODE_DPAD_RIGHT22
22确定KEYCODE_DPAD_CENTER23
23左滑(慢)KEYCODE_CHANGHONGIR_FLCK_SL4113
24右滑(慢)KEYCODE_CHANGHONGIR_FLCK_SR4114
25节目+KEYCODE_CHANNEL_UP2003
26节目-KEYCODE_CHANNEL_DOWN2004
27音量加KEYCODE_VOLUME_UP24
28音量减KEYCODE_VOLUME_DOWN25
29数字0KEYCODE_07
30数字1KEYCODE_18
31数字2KEYCODE_29
32数字3KEYCODE_310
33数字4KEYCODE_411
34数字5KEYCODE_512
35数字6KEYCODE_613
36数字7KEYCODE_714
37数字8KEYCODE_815
38数字9KEYCODE_916
39输入法KEYCODE_CHANGHONGIR_INPUT4102
40删除KEYCODE_DEL67
页:
[1]