引用:
主要涉及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的实现)。