论坛首页 移动开发技术论坛

Launcher源码初探

浏览 20660 次
精华帖 (0) :: 良好帖 (7) :: 新手帖 (0) :: 隐藏帖 (0)
作者 正文
   发表时间:2011-03-01   最后修改:2011-03-12

最近研究Launcher,总结下。

 

主要涉及3个方面,作为Launcher源码研究的入门:

1.源码的下载;

2.源码的编译;

3.结构初探。

 

[下载源码]
1.下载Msysgit (目前最新的是Git-1.7.4-preview20110204.exe),一路按默认配置安装;
2.任一地方新建一个目录(用于储存下载下来的源码);
3.点击目录右键,选择Git Bash,这是会弹出一个命令输入框;
4.打开官方源码下载网站 ,找到你要下载的部分(完全下载的请参考repo的使用,并需要linux系统支持);
5.按照网页上部的提示,在命令窗口中输入,这里以Launcher.git为例:
  git clone git://android.git.kernel.org/platform/pakages/apps/Launcher.git
*这样下载到的是最新更新版本的代码,如果想指定下载某个版本

<
  1.
  git clone git://android.git.kernel.org/ + project path

  2. 进入到下载目录
  cd <dir>

  3.获取分支
  git branch

  4.关联
  git checkout <branch_name> -b <your_branch_name>

  5.同步数据
  git pull
>

<貌似还有点问题,了解具体操作的麻烦说声- -!>
6.等待下载完毕。

-----------------------------------------
参考资料:
Git和Repo扫盲——如何取得Android源代码

git-clone指定branch
-----------------------------------------

[编译和运行]
准备工作:
1. 下载好的roject源码(此处为Launcher);
2. 编译好的Android源码(下文给出编译好的Launcher相关类库的下载链接)。

 

具体操作:
1.将下载的Project源码导入Eclipse
新建Android项目,选择"Create project from existing source",并指定项目的路径,如下图:


 
下面的SDK你要根据你下载的Project所支持的Android版本选择,然后“finish”。

此时你会发现项目是布满"红叉"的:


 
接下来的任务就是去掉这些"红叉",使项目能顺利编译。

PS:有的Project源码可能丢失了R.java,可以通过以下方法解决:
第1种方法: 右击工程->选择Android Tools->选择Fix Project Properties
第2种方法: 右击工程->选择Properties->选择 Android->Apply


2.重名包名
为了避免与系统默认的包名冲突,所以需要进行修改。
在src/com.android.launcher上点击右键,"Refactor" -> "Rename...",名字可以自定义(我这里改成com.study.launcher),选项如下图选择(全选上):


 
点击"Preview>",进行预览(途中弹出警告的话,不用管,继续"Countinue"),这里要去掉一些不必要的修改,否则就会改乱了。

进入到这么一个界面:


 
找到以下选项,去掉前面的钩子:


 

 
点击"OK",等待处理完毕...

ps:过程中可能会弹出这样一个错误提示,直接"Abort"就好:


 
*结束后可能会弹出这样的提示框:



 
点“Yes”。


到此第一步操作完毕,但是你会发现"红叉"依旧,我们接下来继续处理...

3.导入Android类库
这个需要一个编译好的Android源码所生成的对应的jar包(具体可参考文章"关于使用Eclipse调试Launcher的完美解决方法 ")

这里 可以下载编译好的Launcher的classes.jar(其他的Project的话需要你自己来准备了...)。

导入jar,
这里要注意的是,直接"Add To Library"好像有点问题,我这试了几次都会导致Eclipse卡着不动了...
另一个测试可行的方法是(原文请参考"Android中如何编译运行系统自带桌面Launcher2源码 "):
1).新建一个User Library
在项目上右键,“Build Path” -> “Add Libraries...”,选择"User Library","Next";

在弹出的新界面,点选右侧的"User Libraries",弹出如下界面:


 
点击"New"创建一个名为"framework"的库,然后点选"Add JARs..."指定到classes.jar。

2).添加User Library
确定后,返回如下界面,打上"framework"前面的小勾:


 
点击"finish"。

调整类库加载次序,
将"framework"调整到最上(项目右键,"Build Path"->"Configure Build Path..."):



 
点击"OK"返回。

这时再刷新下项目,
"红叉"一下子消失很多了吧,但是在Launcher.java下还有错误。根据情况,将里面的几行代码手动注释掉即可。
PS:如果还是很多"红叉",你点进类里看看,估计就是因为R.java的包引用问题,将import去掉即可(或者通过组合键"ctrl+shift+o"来自动修复类的引用导入)。

*如果发现R.java没有生成,可以试着将gen/下的目录删了,再按上面的方式重新生成。

!!特别注意的是:
网上有些文章介绍说,直接通过自定义变量和手动调用相应的函数来跳过编译错误,该种方法并不可取!因为这些内部变量在内部可能会在某个地方被赋值的(具体我无从知道),但测试结果告诉我——如果Worksapce.java里的mScrollX和mScrollY自己来提供的话,会导致滑屏出现问题...所以麻烦点还是搞到编译好的jar包好。


4.修改AndroidManifest.xml
去掉其中的"android:sharedUserId="android.uid.shared" ":


 
5.编译,运行
试试编译,通过了:



 
ps:Project源码默认没有指定minSDK,你可以手动设定,避免提示错误。

*如果编译出现问题,请查看LogCat中的提示,一般能快捷地定位到问题

打开模拟器运行看看,
按下"HOME"键:


 
启动我们自己的Launcher,和系统的一模一样吧~~


 
OK,大功告成!

-----------------------------------------
参考资料:
在Eclipse中调试运行launcher源码 系列文章
关于使用Eclipse调试Launcher的完美解决方法
Android中如何编译运行系统自带桌面Launcher2源码
-----------------------------------------

[结构研究]



 
*详细布局情况可以通过SDK_dir/tools/hierarchyviewer.bat进行查看。

整个homescreen是一个包含三个child view的FrameLayout(com.android.launcher.DragLayer)。

第一个child就是桌面com.android.launcher.Workspace。这个桌面又包含三个child。每个child就对应一个桌 面。这就是你在Android上看到的三个桌面。每个桌面上可以放置下列对象:应用快捷方式,appwidget和folder。

第二个child是一个SlidingDrawer控件,这个控件由两个子控件组成。一个是 com.android.launcher.HandleView,就是Android桌面下方的把手,当点击这个把手时,另一个子控 件,com.android.launcher.AllAppsGridView就会弹出,这个子控件列出系统中当前安装的所有类型为 category.launcher的Activity。

第三个child是com.android.launcher.DeleteZone。当用户在桌面上长按一个widget时,把手位置就会出现一个垃圾桶形状的控件,就是这个控件。

在虚拟桌面上可以摆放四种类型的对象:
1. ITEM_SHORTCUT,应用快捷方式
2. ITEM_APPWIDGET,app widget
3. ITEM_LIVE_FOLDER,文件夹
4. ITEM_WALLPAPER,墙纸。

类简介:
AddAdapter:添加桌面元素的适配器。
AllAppsGridView:Icon列表的的主界面,继承gridView。
DeleteZone:luancher的删除区域,继承ImageView。
DragController:拖动控制接口。
DragLayer:整个launcher的父节点,继承FrameLayout,实现接口DrayController。
DragSource:拖动源接口,定义了void onDropCompleted(View target, boolean success)。
DropTarget:拖动目标,定义很多拖动过程需要的方法:onDrop,onDragEnter,onDragOver,onDragExit,acceptDrop。
HandleView:launcher抽屉的开关,不过在android2.2已经没用抽屉了。
Launcher:整个launcher的程序的入口,代码量最大的一个文件。
Workspace:整个界面layout,几个窗口就是他下面的子节点。

Launcher中实现了MVC模式(M:launchermode , V:draglayer ,C: launcher),以此为主线,可以得到 Launcher对各个组件管理的细节(如drag的实现)。

 

-----------------------------------------
参考资料:
Android系列之二十四 -- home screen

Andorid Launcher程序代码分析

-----------------------------------------

  • 大小: 35.7 KB
  • 大小: 9.4 KB
  • 大小: 20.6 KB
  • 大小: 59.3 KB
  • 大小: 3.8 KB
  • 大小: 5.1 KB
  • 大小: 25.2 KB
  • 大小: 14.1 KB
  • 大小: 38.1 KB
  • 大小: 28.7 KB
  • 大小: 46.2 KB
  • 大小: 7 KB
  • 大小: 26.7 KB
  • 大小: 59 KB
  • 大小: 101.8 KB
  • 大小: 200.5 KB
   发表时间:2011-03-03  
多么认真的帖子。。必须良好。。。
0 请登录后投票
   发表时间:2011-03-07  
大家注意下,这个是对应2.1版本的launcher。2.2的改成了launcher2,刚开始我没注意到就硬网上搬了,这两者之间的改动还是蛮多的。
0 请登录后投票
   发表时间:2011-03-07  
恩恩,这个是要注意的。目前Launcher已经没有更新了,本文的方法相对是通用的,但是里面提到的JAR包要对应。

.勤仔. 写道
大家注意下,这个是对应2.1版本的launcher。2.2的改成了launcher2,刚开始我没注意到就硬网上搬了,这两者之间的改动还是蛮多的。

0 请登录后投票
   发表时间:2011-03-10  
楼主真能耐住性子写东西
0 请登录后投票
   发表时间:2011-03-11  
哈哈,我是懒得记,就写下来好了。再者,储存知识的最好方式就是分享了!

wafj1984 写道
楼主真能耐住性子写东西

0 请登录后投票
   发表时间:2011-03-12  
我也正准备看Launcher源码,楼主的文章很有用啊,谢谢啦
0 请登录后投票
   发表时间:2011-04-10  
楼主是广州哪家公司的,我准备去广州呢,能不能介绍介绍啊!
0 请登录后投票
   发表时间:2011-04-11  
跑到这找工作了..

我现在没在广州了,跑到上海来了...可以帮你问问之前广州的公司还招人不

不过,建议工作这东西还是自己找合适啊。确定好方向就努力去尝试好了!

hhww0101 写道
楼主是广州哪家公司的,我准备去广州呢,能不能介绍介绍啊!

0 请登录后投票
论坛首页 移动开发技术版

跳转论坛:
Global site tag (gtag.js) - Google Analytics