Android Launcher分析和修改1——Launcher默認界面配置（default_workspace）

最近工作都在修改Launcher，所以打算把分析源碼和修改源碼的過程記錄下來，最近會寫一些關於Launcher的分析和修改博文。因為我是修改4.0.3的Launcher，所以后面文章里面的Launcher都是基於Android4.0.3的Launcher2修改。Launcher源碼比較多，而且里面應用了很多設計模式，要把它分析清楚要花不少精力，網上也有一些零碎的分析文章，不過關於修改的文章不多。所以打算寫一些分析和修改Launcher結合的文章。

原創博文，轉載請標明出處：http://www.cnblogs.com/mythou/p/3153880.html

    今天主要是分析修改Launcher的默認界面如何配置和修改。Launcher修改是最近才開始，下面兩張圖片是最近修改后的結果。因為程序是用於車載導航儀的，所以界面和一般的手機界面差別較大。改動也比較大，不過對於Launcher的分析修改都是通用的。

這是基於Android4.0.3修改后的Launcher界面，因為程序是用在汽車導航上，所以圖標做了放大操作。刪除了一些不需要的東西。

下面針對界面修改的地方做分析。

 

1、界面默認配置文件

    機器剛升級的時候，Launcher的界面是默認讀取一個xml配置文件，完成配置工作。這個配置文件在Launcher目錄下，

路徑是：\Launcher\res\xml\default_workspace.xml 。這個XML文件就是剛升級，Launcher第一次顯示的時候，會讀取的配置文件。

default_workspace。xml里面可以配置APP快捷方式、Widget、Search搜索欄等。下面就常用的這幾個屬性進行解析：

 

//Edited by mythou
//http://www.cnblogs.com/mythou/

快捷方式說明 <favorite 　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　  //程序快捷鍵屬性標簽
    launcher:className="com.apical.radio.radioMainActivity"    　//該應用的類，點擊圖標時，需要啟動的類
    launcher:packageName="com.apical.radio"          　　　   　　//該應用的包名
    launcher:screen="1"           　　　　　　　　　　　　　　　　　 //第1屏,0-4屏共5屏
    launcher:x="0"                   　　　　　　　　　　　　　　　 //圖標X位置,左上角第一個為0,向右遞增,0-4共5個
    l0auncher:y="0"            　　　　　　　　　　　　　　　　　　　//圖標Y位置,左上角第一個為0,向下遞增,0-2共3個
/>

    Launcher默認是有5個分屏，不過這個可以配置。同樣，每行每列有多少圖標也是可以配置的，這個在后面會說在哪里可以修改。這里按我修改的是3行5列的界面排布（對應上面的效果圖）。一般配置APP的快捷方式，使用上面的屬性標簽就可以。

 

//Edited by mythou
//http://www.cnblogs.com/mythou/

//桌面Widget的標簽

<appwidget　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　 //插件
    launcher:className="de.dnsproject.clock_widget_main.Clock1AppWidgetProvider"  //該應用的類
    launcher:packageName="de.dnsproject.clock_widget_main"   　　　　　　　　      //該應用的包名
    launcher:screen="1"             　　　　　　　　　　　　　　　　　　//第1屏,0-4屏共5屏
    launcher:x="2"                      　　　　　　　　　　　　　　　 //圖標X位置,左上角第一個為0,向左遞增,0-4共5個
    launcher:y="1"                                                 //圖標Y位置,左上角第一個為0,向下遞增,0-2共3個
    launcher:spanX="3"                                             //在x方向上所占格數
    launcher:spanY="2" />                                          //在y方向上所占格數

     桌面Widget跟桌面快捷方式屬性類型，不過這里需要注意launcher:spanX和launcher:spanY 這兩個屬性是說明Widget多大的，這個和Widget的最小寬高配置有關。我們在編寫桌面Widget的時候，需要在XML配置文件里面指定Widget最小的寬和高，一般最小寬高計算公式是（minWidth = 72*占用格數-2） 計算出來，最小高度也是一樣。（上面那個模擬時鍾是MIUI的時鍾）

    minWidth = 72*占用格數-2里面的占用格數就是上面launcher:spanX和launcher:spanY配置的數目。針對上面的效果圖，就是占用了3個橫向的格子，2個豎向的格子。minWidth應該等於214。

 

<search                　　　　　　 //搜索欄
launcher:screen="1"            　  //第2屏
launcher:x="0"                    //圖標X位置
launcher:y="1"/>                  //圖標Y位置

這個是搜索欄的配置，因為我這里不需要用到搜索欄，所以把它去掉了，如果需要配置可以使用上面的屬性標簽。

 

 

至於文件夾，在4.0的Launcher里面是支持的，分析加載函數里面，可以找到解析文件夾標簽的方法。

上面界面默認配置就是通過使用上面的標簽修改default_workspace.xml配置的。

下面列出default_workspace支持的標簽和屬性：

//Edited by mythou
//http://www.cnblogs.com/mythou/

//default_workspace.xml中，支持的標簽有： favorite:應用程序快捷方式。 shortcut:鏈接，如網址，本地磁盤路徑等。 search:搜索框。 clock:桌面上的鍾表Widget //支持的屬性有： launcher:title:圖標下面的文字，目前只支持引用，不能直接書寫字符串; launcher:icon:圖標引用; launcher:uri:鏈接地址,鏈接網址用的，使用shortcut標簽就可以定義一個超鏈接，打開某個網址。 launcher:packageName:應用程序的包名; launcher:className:應用程序的啟動類名; launcher:screen:圖標所在的屏幕編號; launcher:x:圖標在橫向排列上的序號; launcher:y:圖標在縱向排列上的序號;

Launcher里面負責解析default_workspace.xml文件的方法是 LauncherProvider.java里面的loadFavorites方法。

 

2、LauncherProvider.java的loadFavorites分析：

//Edited by mythou
//http://www.cnblogs.com/mythou/
//傳入default_workspace文件的資源ID和數據庫實力，把xml里面數據解析，保存到Launcher數據庫。返回總共解析了多少個標簽。
private int loadFavorites(SQLiteDatabase db, int workspaceResourceId) {

　　　　　　　　　//.........
int type;
                while (((type = parser.next()) != XmlPullParser.END_TAG ||
                        parser.getDepth() > depth) && type != XmlPullParser.END_DOCUMENT) 
　　　　　　　　　{

                    if (type != XmlPullParser.START_TAG) {
                        continue;
                    }

                    boolean added = false;
                    final String name = parser.getName();

                    TypedArray a = mContext.obtainStyledAttributes(attrs, R.styleable.Favorite);

                    long container = LauncherSettings.Favorites.CONTAINER_DESKTOP;
                    if (a.hasValue(R.styleable.Favorite_container)) {
                        container = Long.valueOf(a.getString(R.styleable.Favorite_container));
                    }

                    String screen = a.getString(R.styleable.Favorite_screen);
                    String x = a.getString(R.styleable.Favorite_x);
                    String y = a.getString(R.styleable.Favorite_y);

                    // If we are adding to the hotseat, the screen is used as the position in the
                    // hotseat. This screen can't be at position 0 because AllApps is in the
                    // zeroth position.
                    if (container == LauncherSettings.Favorites.CONTAINER_HOTSEAT
                            && Integer.valueOf(screen) == allAppsButtonRank) {
                        throw new RuntimeException("Invalid screen position for hotseat item");
                    }

                    values.clear();
                    values.put(LauncherSettings.Favorites.CONTAINER, container);
                    values.put(LauncherSettings.Favorites.SCREEN, screen);
                    values.put(LauncherSettings.Favorites.CELLX, x);
                    values.put(LauncherSettings.Favorites.CELLY, y);

　　　　　　　　　　　　//解析xml里面的標簽，從這里可以找到支持的標簽類型和相關屬性參數。 if (TAG_FAVORITE.equals(name)) {
                        long id = addAppShortcut(db, values, a, packageManager, intent);
                        added = id >= 0;
                    } else if (TAG_SEARCH.equals(name)) {
                        added = addSearchWidget(db, values);
                    } else if (TAG_CLOCK.equals(name)) {
                        added = addClockWidget(db, values);
                    } else if (TAG_APPWIDGET.equals(name)) {
                        added = addAppWidget(parser, attrs, type, db, values, a, packageManager);
                    } else if (TAG_SHORTCUT.equals(name)) {
                        long id = addUriShortcut(db, values, a);
                        added = id >= 0;
                    } else if (TAG_FOLDER.equals(name)) 
　　　　　　　　　　　　{
 　　　　　　　　　　　　//.........
　　　　　　　　　　　　　　
　　　　　　　　　　　　　　//folder屬性里面的參數要多於2個，才能形成文件夾。
                        if (folderItems.size() < 2 && folderId >= 0) {
                            // We just delete the folder and any items that made it
                            deleteId(db, folderId);
                            if (folderItems.size() > 0) {
                                deleteId(db, folderItems.get(0));
                            }
                            added = false;
                        }
                    }
                    if (added) i++;
                    a.recycle();
                }
　　　　　　　　//.........
return i;
        }

其實就是一個分析XML和寫入數據庫的過程，LauncherProvider.java是整個Launcher的數據來源，十分重要，后面我再具體分析數據加載和適配顯示方面的邏輯。

另外還有一個問題補充一下，就是有關Android截圖問題，因為我開發的機器不能使用USB調試，而且沒有搖動之類的傳感器，很多手機上截圖方法都用不了，查了一下，可以使用screencap命令來截圖，具體方法可以參考我另外一篇文章：http://www.cnblogs.com/mythou/p/3152627.html

 

至於圖標加入默認背景或者強制轉換APP快捷方式圖標，修改圖標大小和行列數，以及如何配置默認背景，明天再寫另外文章說明。

如果有朋友發現哪里寫錯了，請留言指出，謝謝！