Android桌面Launcher源码浅析

Android启动过程-万字长文(Android14)中介绍了Android系统的启动过程,本篇文章将继续介绍桌面应用Launcher。

一、Launcher介绍

  • Android启动过程-万字长文(Android14)中提到Launcher是Android系统启动后,由SystemServerActivity Manager Service (AMS)加载的第一个应用程序
  • Launcher又被称为桌面程序,负责Android桌面的启动和管理
  • 用户使用的应用程序(App)都是通过Launcher来启动的

二、下载及编译

2.1 下载

  • 使用Git下载Launcher源码:
git clone https://android.googlesource.com/platform/packages/apps/Launcher3 
  • 进入项目目录
cd Launcher3 
  • 切换到Android14分支
git checkout android14-release 

2.2 编译

使用AndroidStudio编译下载好的Launcher3工程

编译过程中遇到问题及解决方案可以参考以下博客:

三、源码解析

3.1 AndroidManifest.xml

在项目根目录的AndroidManifest.xml,定义了Launcher做为桌面程序的属性:

<application>     <activity         android:name="com.android.launcher3.Launcher"         android:launchMode="singleTask">         <intent-filter>             <category android:name="android.intent.category.HOME" />         </intent-filter>     </activity> </application> 
  • android.intent.category.HOME: 告诉系统这是一个启动器(Launcher)应用程序,系统在初始化完成后会通过ActivityTaskManagerServicegetHomeIntent方法获取和启动桌面程序。具体可参见Android启动过程-万字长文(Android14)
  • 开发人员也可以自己开发一个桌面程序(如微软桌面),用户安装完成后,可以在系统设置中修改默认启动的桌面程序

3.2 Launcher.java

Launcher.java是Launcher的启动页面,负责资源初始化和桌面UI创建

3.2.1 onCreate方法

protected void onCreate(Bundle savedInstanceState) {     super.onCreate(savedInstanceState);      // 获取 LauncherAppState 实例和模型     LauncherAppState app = LauncherAppState.getInstance(this);     mModel = app.getModel();          // 初始化不变的设备配置文件     InvariantDeviceProfile idp = app.getInvariantDeviceProfile();     initDeviceProfile(idp);     idp.addOnChangeListener(this);      // 获取共享首选项和图标缓存     mSharedPrefs = LauncherPrefs.getPrefs(this);     mIconCache = app.getIconCache();      // 创建无障碍代理     mAccessibilityDelegate = createAccessibilityDelegate();      // 初始化拖动控制器     initDragController();          // 创建所有应用程序控制器     mAllAppsController = new AllAppsTransitionController(this);          // 创建状态管理器     mStateManager = new StateManager<>(this, NORMAL);      // 创建引导首选项     mOnboardingPrefs = createOnboardingPrefs(mSharedPrefs);      // 设置视图     setupViews();      // 初始化Widget     mAppWidgetManager = new WidgetManagerHelper(this);     mAppWidgetHolder = createAppWidgetHolder();     mAppWidgetHolder.startListening();      // 设置内容视图     setContentView(getRootView());     ComposeInitializer.initCompose(this);  } 

3.2.2 setupViews方法

protected void setupViews() {     // 创建根视图     inflateRootView(R.layout.launcher);      // 获取拖动层和焦点处理器     mDragLayer = findViewById(R.id.drag_layer);     mFocusHandler = mDragLayer.getFocusIndicatorHelper();          // 获取工作区、总览面板和Hotseat     mWorkspace = mDragLayer.findViewById(R.id.workspace);     mWorkspace.initParentViews(mDragLayer);     mOverviewPanel = findViewById(R.id.overview_panel);     mHotseat = findViewById(R.id.hotseat);     // 将工作区设置为Hotseat     mHotseat.setWorkspace(mWorkspace);      // 设置拖动层     mDragLayer.setup(mDragController, mWorkspace);      // 设置工作区     mWorkspace.setup(mDragController);     // 在工作区绑定之前,确保我们将壁纸偏移锁定到默认状态,否则在RTL中我们将更新错误的偏移量     mWorkspace.lockWallpaperToDefaultPage();     mWorkspace.bindAndInitFirstWorkspaceScreen();     mDragController.addDragListener(mWorkspace);      // 获取搜索/删除/卸载栏     mDropTargetBar = mDragLayer.findViewById(R.id.drop_target_bar);      // 设置应用程序视图     mAppsView = findViewById(R.id.apps_view);     mAppsView.setAllAppsTransitionController(mAllAppsController);      // 设置拖动控制器(拖动目标必须按优先级的相反顺序添加)     mDropTargetBar.setup(mDragController);     mAllAppsController.setupViews(mScrimView, mAppsView);      // 如果启用了点分页,则设置工作区的分页指示器     if (SHOW_DOT_PAGINATION.get()) {         mWorkspace.getPageIndicator().setShouldAutoHide(true);         mWorkspace.getPageIndicator().setPaintColor(                 Themes.getAttrBoolean(this, R.attr.isWorkspaceDarkText)                         ? Color.BLACK                         : Color.WHITE);     } }  
  • Workspace:工作区,也是我们常说的桌面区域,包括搜索框,桌面,壁纸
  • AppsView:应用程序列表
  • Widget:小组件

三、Workspace、AppsView和Widget示例

3.1 Workspace(工作区)

Android桌面Launcher源码浅析

  • 结构说明

Android桌面Launcher源码浅析

3.2 AppsView(应用程序视图)

Android桌面Launcher源码浅析

3.3 Widget(小组件)

Android桌面Launcher源码浅析

四、点击App图标的事件响应

4.1 触发ItemClickHandler的onClick方法

  • ItemClickHandler负责处理桌面应用图标的点击事件。
  • 桌面图标的点击事件最终会触发ItemClickHandleronClick方法
  • onClick方法最终会触发startAppShortcutOrInfoActivity方法
/**  * Class for handling clicks on workspace and all-apps items  */ public class ItemClickHandler {     private static void onClick(View v) {         startAppShortcutOrInfoActivity(v, (AppInfo) tag, launcher);     }          // 通知launcher启动Activity     private static void startAppShortcutOrInfoActivity(View v, ItemInfo item, Launcher launcher) {         launcher.startActivitySafely(v, intent, item);     } } 

4.2 Launcher通知系统启动App

Launcher.java的startActivitySafely方法中调用ActivityContext.java的startActivitySafely方法

public RunnableList startActivitySafely(View v, Intent intent, ItemInfo item) {     RunnableList result = super.startActivitySafely(v, intent, item); } 

ActivityContext.java的startActivitySafely方法中调用了

public interface ActivityContext {         default RunnableList startActivitySafely(             View v, Intent intent, @Nullable ItemInfo item) {             if (isShortcut) {                 // Shortcuts need some special checks due to legacy reasons.                 startShortcutIntentSafely(intent, optsBundle, item);             }         }                  default void startShortcutIntentSafely(Intent intent, Bundle optsBundle, ItemInfo info) {             if (info.itemType == LauncherSettings.Favorites.ITEM_TYPE_DEEP_SHORTCUT) {                     // 通过快捷方式启动                     startShortcut(packageName, id, intent.getSourceBounds(), optsBundle, info.user);                 } else {                     // 普通方式启动,应用程序走这个分支                     ((Context) this).startActivity(intent, optsBundle);                 }         } } 

Android 应用快捷方式(Shortcut)官方文档

最终通过frameworks/base/core/java/android/app/Activity.java 源码地址中的startActivity方法启动了对应的应用程序。

发表评论

评论已关闭。

相关文章