trebuchet: custom home

Change-Id: I4faee66580ab0e41ee8e8bcbd79ce680d45bce97
Signed-off-by: Jorge Ruesga <jorge@ruesga.com>

14 files changed, 950 insertions, 5 deletions

diff --git a/AndroidManifest.xml b/AndroidManifest.xml
index 34e25b8b4..d2e821189 100644
--- a/AndroidManifest.xml
+++ b/AndroidManifest.xml
@@ -73,7 +73,7 @@
         android:largeHeap="@bool/config_largeHeap"
         android:supportsRtl="true">
         <activity
-            android:name="com.android.launcher3.Launcher"
+            android:name="org.cyanogenmod.trebuchet.TrebuchetLauncher"
             android:launchMode="singleTask"
             android:clearTaskOnLaunch="true"
             android:stateNotNeeded="true"
diff --git a/res/drawable-hdpi/search_bg.9.png b/res/drawable-hdpi/search_bg.9.png
new file mode 100644
index 000000000..798127b50
--- /dev/null
+++ b/res/drawable-hdpi/search_bg.9.png
diff --git a/res/drawable-mdpi/search_bg.9.png b/res/drawable-mdpi/search_bg.9.png
new file mode 100644
index 000000000..3b259d4fb
--- /dev/null
+++ b/res/drawable-mdpi/search_bg.9.png
diff --git a/res/drawable-xhdpi/search_bg.9.png b/res/drawable-xhdpi/search_bg.9.png
new file mode 100644
index 000000000..947fd4de6
--- /dev/null
+++ b/res/drawable-xhdpi/search_bg.9.png
diff --git a/res/drawable-xxhdpi/search_bg.9.png b/res/drawable-xxhdpi/search_bg.9.png
new file mode 100644
index 000000000..6626cd99b
--- /dev/null
+++ b/res/drawable-xxhdpi/search_bg.9.png
diff --git a/res/layout-port/qsb.xml b/res/layout-port/qsb.xml
index 4c9963dfb..f7a1c8773 100644
--- a/res/layout-port/qsb.xml
+++ b/res/layout-port/qsb.xml
@@ -18,7 +18,7 @@
     xmlns:launcher="http://schemas.android.com/apk/res-auto/com.android.launcher3"
     android:layout_width="match_parent"
     android:layout_height="match_parent"
-    android:background="@drawable/search_frame">
+    android:background="@drawable/search_bg">
    <!-- Global search icon -->
    <com.android.launcher3.HolographicLinearLayout
         style="@style/SearchButton.WithPaddingStart"
diff --git a/res/layout-sw720dp/qsb.xml b/res/layout-sw720dp/qsb.xml
index e993f7847..399666ab0 100644
--- a/res/layout-sw720dp/qsb.xml
+++ b/res/layout-sw720dp/qsb.xml
@@ -19,7 +19,7 @@
     style="@style/SearchDropTargetBar"
     android:layout_width="match_parent"
     android:layout_height="match_parent"
-    android:background="@drawable/search_frame">
+    android:background="@drawable/search_bg">
    <!-- Global search icon -->
    <com.android.launcher3.HolographicLinearLayout
         style="@style/SearchButton.WithPaddingStart"
diff --git a/res/values/cm_integers.xml b/res/values/cm_integers.xml
new file mode 100644
index 000000000..f3b0464ef
--- /dev/null
+++ b/res/values/cm_integers.xml
@@ -0,0 +1,21 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!--
+     Copyright (C) 2014 The CyanogenMod Project
+
+     Licensed under the Apache License, Version 2.0 (the "License");
+     you may not use this file except in compliance with the License.
+     You may obtain a copy of the License at
+
+          http://www.apache.org/licenses/LICENSE-2.0
+
+     Unless required by applicable law or agreed to in writing, software
+     distributed under the License is distributed on an "AS IS" BASIS,
+     WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+     See the License for the specific language governing permissions and
+     limitations under the License.
+-->
+<resources>
+    <integer name="qsb_initial_alpha_state">55</integer>
+    <integer name="qsb_end_alpha_state">220</integer>
+    <integer name="qsb_buttons_end_colorfilter">120</integer>
+</resources>
diff --git a/src/com/android/launcher/home/Home.java b/src/com/android/launcher/home/Home.java
new file mode 100644
index 000000000..5dce71e86
--- /dev/null
+++ b/src/com/android/launcher/home/Home.java
@@ -0,0 +1,201 @@
+/*
+ * Copyright (C) 2014 The CyanogenMod Project
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *      http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package com.android.launcher.home;
+
+import android.content.Context;
+import android.view.View;
+import android.view.ViewGroup.LayoutParams;
+
+/**
+ * The generic contract that should supports a <code>Home</code> app to could
+ * be invoked and registered by an Android launcher.<br/>
+ * <br/>
+ * This interface contains the version 1 of the <code>Home Host App</code> protocol.<br/>
+ * <br/>
+ * <br/>
+ * A <code>Home</code> app should:
+ * <ul>
+ *  <li>
+ *    should have at least a constructor with no arguments
+ *  </li>
+ *  <li>
+ *    declares inside its manifest a <code>com.android.launcher.home</code> metadata with the
+ *    full qualified that contains this interface<br/>
+ *    <pre>
+ *    &lt;meta-data android:name="com.android.launcher.home" value="org.cyanogenmod.launcher.home.HomeStub"/&gt;
+ *    </pre>
+ *  </li>
+ *  <li>
+ *    define the "com.android.launcher.home.permissions.HOME_APP" permission<br/>
+ *    <pre>
+ *    &lt;uses-permission android:name="com.android.launcher.home.permissions.HOME_APP"/&gt;
+ *    </pre>
+ *  </li>
+ *  <li>
+ *    implements the contract defined by this protocol.
+ *  </li>
+ * </ul>
+ * <br/>
+ * Implementors classes of this protocol should be aware that all the {@link Context} references
+ * passed to this class owns to the host launcher app. This means that you cannot access
+ * to settings defined by the <code>Home</code> app inside its shared context.
+ */
+public interface Home {
+
+    /**
+     * A SHA-1 hash of all declared method of this interface. Home apps should compute as:<br/>
+     * <br/>
+     * <pre>
+     *   for method in Home.class.getDeclaredMehod
+     *      sha1.update method.toString.bytes
+     * </pre><br/>
+     * DO NOT MODIFY!
+     */
+    public static final String SIGNATURE = "5/A6Mxkz8gHHzzVf4qZR+hiSOAw=";
+
+    /**
+     * Defines the name of the metadata used to declared the full qualified Home stub class
+     * that implements this protocol.
+     */
+    public static final String METADATA_HOME_STUB = "com.android.launcher.home";
+
+    /**
+     * Defines the name of the permission that the Home app should explicitly declare.
+     */
+    public static final String PERMISSION_HOME_APP = "com.android.launcher.home.permissions.HOME_APP";
+
+    // Notification flags
+    public static final int FLAG_NOTIFY_MASK = 0x0000;
+    public static final int FLAG_NOTIFY_ON_RESUME = FLAG_NOTIFY_MASK + 0x0002;
+    public static final int FLAG_NOTIFY_ON_PAUSE = FLAG_NOTIFY_MASK +  0x0004;
+    public static final int FLAG_NOTIFY_ON_SHOW = FLAG_NOTIFY_MASK + 0x0008;
+    public static final int FLAG_NOTIFY_ON_SCROLL_PROGRESS_CHANGED = FLAG_NOTIFY_MASK + 0x0010;
+    public static final int FLAG_NOTIFY_ON_HIDE = FLAG_NOTIFY_MASK + 0x0020;
+    public static final int FLAG_NOTIFY_ALL = FLAG_NOTIFY_ON_RESUME | FLAG_NOTIFY_ON_PAUSE |
+            FLAG_NOTIFY_ON_SHOW | FLAG_NOTIFY_ON_SCROLL_PROGRESS_CHANGED | FLAG_NOTIFY_ON_HIDE;
+
+    // Operation support flags
+    public static final int FLAG_OP_MASK = 0x1000;
+    public static final int FLAG_OP_CUSTOM_SEARCH = FLAG_OP_MASK + 0x0002;
+    public static final int FLAG_OP_ALL = FLAG_OP_CUSTOM_SEARCH;
+
+    // Search modes
+    public static final int MODE_SEARCH_TEXT = 0x0000;
+    public static final int MODE_SEARCH_VOICE = 0x0001;
+
+    /**
+     * Invoked the first time the <code>Home</code> app is created.<br/>
+     * This method should be used by implementors classes of this protocol to load the needed
+     * resources.
+     * @param context the current {@link Context} of the host launcher.
+     */
+    void onStart(Context context);
+
+    /**
+     * Invoked when the <code>Home</code> app should be destroy.<br/>
+     * This method should be used by implementors classes of this protocol to unload all unneeded
+     * resources.
+     * @param context the current {@link Context} of the host launcher.
+     */
+    void onDestroy(Context context);
+
+    /**
+     * Invoked when the host launcher enters in resume mode.
+     * @param context the current {@link Context} of the host launcher.
+     */
+    void onResume(Context context);
+
+    /**
+     * Invoked when the host launcher enters in pause mode.
+     * @param context the current {@link Context} of the host launcher.
+     */
+    void onPause(Context context);
+
+    /**
+     * Invoked when the custom content page is totally displayed.
+     * @param context the current {@link Context} of the host launcher.
+     */
+    void onShow(Context context);
+
+    /**
+     * Invoked when the custom content page is scrolled.
+     * @param context the current {@link Context} of the host launcher.
+     * @param progress the current scroll progress.
+     */
+    void onScrollProgressChanged(Context context, float progress);
+
+    /**
+     * Invoked when the custom content page is totally hidden.
+     * @param context the current {@link Context} of the host launcher.
+     */
+    void onHide(Context context);
+
+    /**
+     * Invoked by the host launcher to request an invalidation of the ui elements and data used by
+     * the <code>Home</code> implementation class.
+     * @param context the current {@link Context} of the host launcher.
+     */
+    void onInvalidate(Context context);
+
+    /**
+     * Invoked when the host launcher request enter in search mode.
+     * @param context the current {@link Context} of the host launcher.
+     * @param mode the requested search mode. Must be one of:
+     * <ul>
+     * <li>{@link #MODE_SEARCH_TEXT}: Textual mode</li>
+     * <li>{@link #MODE_SEARCH_VOICE}: Voice mode</li>
+     * </ul>
+     */
+    void onRequestSearch(Context context, int mode);
+
+    /**
+     * Returns an instance of a {@link View} that holds the custom content to be displayed
+     * by this <code>Home</code> app.
+     * @param context the current {@link Context} of the host launcher.
+     * @return View The custom content view that will be enclosed inside a
+     * <code>com.android.launcher3.Launcher.QSBScroller</code>.<br/>
+     * Be aware the the height layout of the returned should be defined as
+     * {link {@link LayoutParams#WRAP_CONTENT}, so the view could be scrolled inside the
+     * custom content page.
+     */
+    View createCustomView(Context context);
+
+    /**
+     * Returns the name of the Home app (LIMIT: 30 characters).
+     * @param context the current {@link Context} of the host launcher.
+     */
+    String getName(Context context);
+
+    /**
+     * Implementations should return the combination of notification flags that want to listen to.
+     * @see #FLAG_NOTIFY_ON_RESUME
+     * @see #FLAG_NOTIFY_ON_PAUSE
+     * @see #FLAG_NOTIFY_ON_SHOW
+     * @see #FLAG_NOTIFY_ON_SCROLL_PROGRESS_CHANGED
+     * @see #FLAG_NOTIFY_ON_HIDE
+     * @see #FLAG_NOTIFY_ALL
+     */
+    int getNotificationFlags();
+
+    /**
+     * Implementations should return the combination of operation flags that want they want
+     * to support to.
+     * @see #FLAG_OP_CUSTOM_SEARCH
+     * @see #FLAG_OP_ALL
+     */
+    int getOperationFlags();
+}
diff --git a/src/com/android/launcher3/Launcher.java b/src/com/android/launcher3/Launcher.java
index d58170a2a..2947eda0f 100644
--- a/src/com/android/launcher3/Launcher.java
+++ b/src/com/android/launcher3/Launcher.java
@@ -56,6 +56,7 @@ import android.graphics.Bitmap;
 import android.graphics.Canvas;
 import android.graphics.Point;
 import android.graphics.PorterDuff;
+import android.graphics.PorterDuffColorFilter;
 import android.graphics.Rect;
 import android.graphics.drawable.Drawable;
 import android.net.Uri;
@@ -99,6 +100,7 @@ import android.widget.PopupMenu;
 import android.widget.TextView;
 import android.widget.Toast;
 
+import com.android.launcher.home.Home;
 import com.android.launcher3.DropTarget.DragObject;
 import com.android.launcher3.PagedView.TransitionEffect;
 import com.android.launcher3.settings.SettingsProvider;
@@ -289,6 +291,9 @@ public class Launcher extends Activity
     private AppsCustomizePagedView mAppsCustomizeContent;
     private boolean mAutoAdvanceRunning = false;
     private View mQsb;
+    private View mQsbBar;
+    private ImageView mQsbBarSearch;
+    private ImageView mQsbBarVoice;
 
     private Bundle mSavedState;
     // We set the state in both onCreate and then onNewIntent in some cases, which causes both
@@ -578,6 +583,10 @@ public class Launcher extends Activity
     }
 
     /** To be overridden by subclasses to hint to Launcher that we have custom content */
+    protected boolean hasCustomSearchSupport() {
+        return false;
+    }
+
     protected boolean hasCustomContentToLeft() {
        return isGelIntegrationSupported() && isGelIntegrationEnabled();
     }
@@ -652,6 +661,15 @@ public class Launcher extends Activity
         }
     }
 
+    /** To be overriden by subclasses to hint to Launcher that we have custom content and
+     * support {@link #hasCustomSearchSupport()}
+     * @see com.android.launcher.home.Home#MODE_SEARCH_TEXT
+     * @see com.android.launcher.home.Home#MODE_SEARCH_VOICE
+     * */
+    protected void requestSearch(int mode) {
+        // To be implemented
+    }
+
     private void updateGlobalIcons() {
         boolean searchVisible = false;
         boolean voiceVisible = false;
@@ -2739,8 +2757,12 @@ public class Launcher extends Activity
      * @param v The view that was clicked.
      */
     public void onClickSearchButton(View v) {
-        v.performHapticFeedback(HapticFeedbackConstants.VIRTUAL_KEY);
+        if (hasCustomSearchSupport()) {
+            requestSearch(Home.MODE_SEARCH_TEXT);
+            return;
+        }
 
+        v.performHapticFeedback(HapticFeedbackConstants.VIRTUAL_KEY);
         onSearchRequested();
     }
 
@@ -2750,8 +2772,12 @@ public class Launcher extends Activity
      * @param v The view that was clicked.
      */
     public void onClickVoiceButton(View v) {
-        v.performHapticFeedback(HapticFeedbackConstants.VIRTUAL_KEY);
+        if (hasCustomSearchSupport()) {
+            requestSearch(Home.MODE_SEARCH_VOICE);
+            return;
+        }
 
+        v.performHapticFeedback(HapticFeedbackConstants.VIRTUAL_KEY);
         startVoice();
     }
 
@@ -3825,6 +3851,20 @@ public class Launcher extends Activity
         return mQsb;
     }
 
+    public ImageView getQsbBarSearchButton() {
+        if (mQsbBarSearch == null && getQsbBar() != null) {
+            return (ImageView) getQsbBar().findViewById(R.id.search_button);
+        }
+        return mQsbBarSearch;
+    }
+
+    public ImageView getQsbBarVoiceButton() {
+        if (mQsbBarVoice == null && getQsbBar() != null) {
+            return (ImageView) getQsbBar().findViewById(R.id.voice_button);
+        }
+        return mQsbBarVoice;
+    }
+
     protected boolean updateGlobalSearchIcon() {
         final View searchButtonContainer = findViewById(R.id.search_button_container);
         final ImageView searchButton = (ImageView) findViewById(R.id.search_button);
diff --git a/src/com/android/launcher3/settings/SettingsProvider.java b/src/com/android/launcher3/settings/SettingsProvider.java
index 52c30440e..d7782b2e6 100644
--- a/src/com/android/launcher3/settings/SettingsProvider.java
+++ b/src/com/android/launcher3/settings/SettingsProvider.java
@@ -40,6 +40,8 @@ public final class SettingsProvider {
     public static final String SETTINGS_UI_GENERAL_ICONS_LARGE = "ui_general_icons_large";
     public static final String SETTINGS_UI_DRAWER_SORT_MODE = "ui_drawer_sort_mode";
 
+    public static final String SETTINGS_HOME_LAST_APP = "home_last_app";
+
     public static SharedPreferences get(Context context) {
         return context.getSharedPreferences(SETTINGS_KEY, Context.MODE_MULTI_PROCESS);
     }
diff --git a/src/org/cyanogenmod/trebuchet/TrebuchetLauncher.java b/src/org/cyanogenmod/trebuchet/TrebuchetLauncher.java
new file mode 100644
index 000000000..12e04cb16
--- /dev/null
+++ b/src/org/cyanogenmod/trebuchet/TrebuchetLauncher.java
@@ -0,0 +1,333 @@
+/*
+ * Copyright (C) 2014 The CyanogenMod Project
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *      http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package org.cyanogenmod.trebuchet;
+
+import android.content.BroadcastReceiver;
+import android.content.ComponentName;
+import android.content.Context;
+import android.content.Intent;
+import android.content.IntentFilter;
+import android.content.res.Resources;
+import android.graphics.Color;
+import android.graphics.PorterDuff;
+import android.graphics.drawable.Drawable;
+import android.os.Bundle;
+import android.util.Log;
+import android.util.SparseArray;
+import android.view.animation.AccelerateInterpolator;
+import android.widget.ImageView;
+
+import com.android.launcher.home.Home;
+import com.android.launcher3.Launcher;
+import com.android.launcher3.R;
+
+import org.cyanogenmod.trebuchet.home.HomeUtils;
+import org.cyanogenmod.trebuchet.home.HomeWrapper;
+
+public class TrebuchetLauncher extends Launcher {
+
+    private static final String TAG = "TrebuchetLauncher";
+
+    private static final boolean DEBUG = true;
+
+    private static class HomeAppStub {
+        private final int mUid;
+        private final ComponentName mComponentName;
+        private final HomeWrapper mInstance;
+
+        private HomeAppStub(int uid, ComponentName componentName, Context context)
+                throws SecurityException, ReflectiveOperationException {
+            super();
+            mUid = uid;
+            mComponentName = componentName;
+
+            // Load a new instance of the Home app
+            ClassLoader classloader = context.getClassLoader();
+            Class<?> homeInterface = classloader.loadClass(Home.class.getName());
+            Class<?> homeClazz = classloader.loadClass(mComponentName.getClassName());
+            mInstance = new HomeWrapper(context, homeInterface, homeClazz.newInstance());
+        }
+
+        @Override
+        public int hashCode() {
+            final int prime = 31;
+            int result = 1;
+            result = prime * result + ((mComponentName == null) ? 0 : mComponentName.hashCode());
+            return result;
+        }
+
+        @Override
+        public boolean equals(Object obj) {
+            if (this == obj)
+                return true;
+            if (obj == null)
+                return false;
+            if (getClass() != obj.getClass())
+                return false;
+            HomeAppStub other = (HomeAppStub) obj;
+            if (mComponentName == null) {
+                if (other.mComponentName != null)
+                    return false;
+            } else if (!mComponentName.equals(other.mComponentName))
+                return false;
+            return true;
+        }
+    }
+
+    private BroadcastReceiver mPackageReceiver = new BroadcastReceiver() {
+        @Override
+        public void onReceive(Context context, Intent intent) {
+            // Obtain the current instance or a new one if the current instance not exists
+            boolean invalidate = false;
+            String action = intent.getAction();
+            if (action.equals(Intent.ACTION_PACKAGE_CHANGED) ||
+                    action.equals(Intent.ACTION_PACKAGE_REPLACED) ||
+                    action.equals(Intent.ACTION_PACKAGE_RESTARTED)) {
+                if (mCurrentHomeApp != null && intent.getIntExtra(Intent.EXTRA_UID, -1)
+                        == mCurrentHomeApp.mUid) {
+                    // The current Home app has changed or restarted. Invalidate the current
+                    // one to be sure we will get all the new changes (if any)
+                    if (DEBUG) Log.d(TAG, "Home package has changed. Invalidate layout.");
+                    invalidate = true;
+                }
+            }
+            obtainCurrentHomeAppStubLocked(invalidate);
+        }
+    };
+
+    private CustomContentCallbacks mCustomContentCallbacks = new CustomContentCallbacks() {
+        @Override
+        public void onShow() {
+            updateQsbBarColorState(0);
+            if (mCurrentHomeApp != null) {
+                mCurrentHomeApp.mInstance.onShow();
+            }
+        }
+
+        @Override
+        public void onScrollProgressChanged(float progress) {
+            updateQsbBarColorState(progress);
+            if (mCurrentHomeApp != null) {
+                mCurrentHomeApp.mInstance.onScrollProgressChanged(progress);
+            }
+        }
+
+        @Override
+        public void onHide() {
+            updateQsbBarColorState(255);
+            if (mCurrentHomeApp != null) {
+                mCurrentHomeApp.mInstance.onHide();
+            }
+        }
+    };
+
+    private HomeAppStub mCurrentHomeApp;
+    private AccelerateInterpolator mQSBAlphaInterpolator;
+
+    private QSBScroller mQsbScroller;
+    private int mQsbInitialAlphaState;
+    private int mQsbEndAlphaState;
+    private int mQsbButtonsEndColorFilter;
+
+    @Override
+    protected void onCreate(Bundle savedInstanceState) {
+        super.onCreate(savedInstanceState);
+        mQSBAlphaInterpolator = new AccelerateInterpolator();
+
+        // Set QsbBar color state
+        final Resources res = getResources();
+        mQsbInitialAlphaState = res.getInteger(R.integer.qsb_initial_alpha_state);
+        mQsbEndAlphaState = res.getInteger(R.integer.qsb_end_alpha_state);
+        mQsbButtonsEndColorFilter = res.getInteger(R.integer.qsb_buttons_end_colorfilter);
+        updateQsbBarColorState(0);
+
+        // Obtain the user-defined Home app or a valid one
+        obtainCurrentHomeAppStubLocked(true);
+
+        // Register this class to listen for new/deleted packages
+        IntentFilter filter = new IntentFilter(Intent.ACTION_PACKAGE_ADDED);
+        filter.addAction(Intent.ACTION_PACKAGE_REMOVED);
+        filter.addAction(Intent.ACTION_PACKAGE_FULLY_REMOVED);
+        filter.addAction(Intent.ACTION_PACKAGE_CHANGED);
+        filter.addAction(Intent.ACTION_PACKAGE_REPLACED);
+        filter.addAction(Intent.ACTION_PACKAGE_RESTARTED);
+        filter.addDataScheme("package");
+        registerReceiver(mPackageReceiver, filter);
+    }
+
+    @Override
+    public void onDestroy() {
+        super.onDestroy();
+
+        // Unregister services
+        unregisterReceiver(mPackageReceiver);
+    }
+
+    @Override
+    protected void onResume() {
+        if (mCurrentHomeApp != null) {
+            mCurrentHomeApp.mInstance.onResume();
+        }
+        super.onResume();
+    }
+
+    @Override
+    protected void onPause() {
+        if (mCurrentHomeApp != null) {
+            mCurrentHomeApp.mInstance.onPause();
+        }
+        super.onPause();
+    }
+
+    @Override
+    protected boolean hasCustomContentToLeft() {
+        return mCurrentHomeApp != null;
+    }
+
+    @Override
+    protected void invalidateHasCustomContentToLeft() {
+        invalidateHomeStub();
+        super.invalidateHasCustomContentToLeft();
+    }
+
+    @Override
+    protected void addCustomContentToLeft() {
+        if (mCurrentHomeApp != null) {
+            mQsbScroller = addToCustomContentPage(mCurrentHomeApp.mInstance.createCustomView(),
+                    mCustomContentCallbacks, mCurrentHomeApp.mInstance.getName());
+            mQsbScroller.setScrollY(200);
+        }
+    }
+
+    @Override
+    protected boolean hasCustomSearchSupport() {
+        return hasCustomContentToLeft() && mCurrentHomeApp.mInstance.isOperationSupported(
+                Home.FLAG_OP_CUSTOM_SEARCH);
+    }
+
+    @Override
+    protected void requestSearch(int mode) {
+        if (!hasCustomSearchSupport()) {
+            return;
+        }
+        mCurrentHomeApp.mInstance.onRequestSearch(mode);
+    }
+
+    private synchronized void obtainCurrentHomeAppStubLocked(boolean invalidate) {
+        if (DEBUG) Log.d(TAG, "obtainCurrentHomeAppStubLocked called (" + invalidate + ")");
+
+        SparseArray<ComponentName> packages = HomeUtils.getInstalledHomePackages(this);
+        if (!invalidate && mCurrentHomeApp != null &&
+                packages.get(mCurrentHomeApp.mUid) != null) {
+            // We still have a valid Home app
+            return;
+        }
+
+        // We don't have a valid Home app, so we need to destroy the current the custom content
+        destroyHomeStub();
+
+        // Return the default valid home app
+        int size = packages.size();
+        for (int i = 0; i < size; i++) {
+            int key = packages.keyAt(i);
+            ComponentName pkg = packages.get(key);
+            String qualifiedPkg = pkg.toShortString();
+            Context ctx = HomeUtils.createNewHomePackageContext(this, pkg);
+            if (ctx == null) {
+                // We failed to create a valid context. Will try with the next package
+                continue;
+            }
+            try {
+                mCurrentHomeApp = new HomeAppStub(key, pkg, ctx);
+            } catch (ReflectiveOperationException ex) {
+                if (!DEBUG) {
+                    Log.w(TAG, "Cannot instantiate home package: " + qualifiedPkg + ". Ignored.");
+                } else {
+                    Log.w(TAG, "Cannot instantiate home package: " + qualifiedPkg +
+                            ". Ignored.", ex);
+                }
+            } catch (SecurityException ex) {
+                if (!DEBUG) {
+                    Log.w(TAG, "Home package is insecure: " + qualifiedPkg + ". Ignored.");
+                } else {
+                    Log.w(TAG, "Home package is insecure: " + qualifiedPkg + ". Ignored.", ex);
+                }
+            }
+
+            // Notify home app that is going to be used
+            if (mCurrentHomeApp != null) {
+                mCurrentHomeApp.mInstance.onStart();
+            }
+        }
+
+        // Don't have a valid package. Anyway notify the launcher that custom content has changed
+        invalidateHasCustomContentToLeft();
+    }
+
+    private void invalidateHomeStub() {
+        if (mCurrentHomeApp != null) {
+            mCurrentHomeApp.mInstance.onInvalidate();
+            if (DEBUG) Log.d(TAG, "Home package " + mCurrentHomeApp.mComponentName.toShortString()
+                    + " was invalidated.");
+        }
+    }
+
+    private void destroyHomeStub() {
+        if (mCurrentHomeApp != null) {
+            mCurrentHomeApp.mInstance.onInvalidate();
+            mCurrentHomeApp.mInstance.onDestroy();
+            if (DEBUG) Log.d(TAG, "Home package " + mCurrentHomeApp.mComponentName.toShortString()
+                    + " was destroyed.");
+        }
+        mQsbScroller = null;
+        mCurrentHomeApp = null;
+    }
+
+    private void updateQsbBarColorState(float progress) {
+        if (getQsbBar() != null) {
+            float interpolation = mQSBAlphaInterpolator.getInterpolation(progress);
+
+            // Background alpha
+            int alphaInterpolation = (int)(mQsbInitialAlphaState +
+                    (interpolation * (mQsbEndAlphaState - mQsbInitialAlphaState)));
+            Drawable background = getQsbBar().getBackground();
+            if (background != null) {
+                background.setAlpha(alphaInterpolation);
+            }
+
+            // Buttons color filter
+            int colorInterpolation = (int)(255 - (interpolation * mQsbButtonsEndColorFilter));
+            int color = Color.rgb(colorInterpolation, colorInterpolation,colorInterpolation);
+            ImageView voiceButton = getQsbBarVoiceButton();
+            if (voiceButton != null) {
+                if (progress > 0) {
+                    voiceButton.setColorFilter(color, PorterDuff.Mode.SRC_IN);
+                } else {
+                    voiceButton.clearColorFilter();
+                }
+            }
+            ImageView searchButton = getQsbBarSearchButton();
+            if (searchButton != null) {
+                if (progress > 0) {
+                    searchButton.setColorFilter(color, PorterDuff.Mode.SRC_IN);
+                } else {
+                    searchButton.clearColorFilter();
+                }
+            }
+        }
+    }
+}
diff --git a/src/org/cyanogenmod/trebuchet/home/HomeUtils.java b/src/org/cyanogenmod/trebuchet/home/HomeUtils.java
new file mode 100644
index 000000000..63bf5ff60
--- /dev/null
+++ b/src/org/cyanogenmod/trebuchet/home/HomeUtils.java
@@ -0,0 +1,112 @@
+/*
+ * Copyright (C) 2014 The CyanogenMod Project
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *      http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package org.cyanogenmod.trebuchet.home;
+
+import android.content.ComponentName;
+import android.content.Context;
+import android.content.pm.ApplicationInfo;
+import android.content.pm.PackageInfo;
+import android.content.pm.PackageManager;
+import android.content.pm.PackageManager.NameNotFoundException;
+import android.os.Bundle;
+import android.util.Log;
+import android.util.SparseArray;
+
+import com.android.launcher.home.Home;
+
+import java.util.List;
+
+public class HomeUtils {
+
+    private static final String TAG = "HomeUtils";
+
+    // FIXME For now for security reason we will only support known Home apps
+    private static final String[] WELL_KNOWN_HOME_APP_PKGS =
+            {
+                "org.cyanogenmod.launcher.home"
+            };
+
+
+    public static final SparseArray<ComponentName> getInstalledHomePackages(Context context) {
+        // A Home app should:
+        //   - declare the use of Home.PERMISSION_HOME_APP permission.
+        //   - define the home stub class through the Home.METADATA_HOME_STUB metadata
+        SparseArray<ComponentName> installedHomePackages = new SparseArray<ComponentName>();
+
+        PackageManager packageManager = context.getPackageManager();
+
+        List<PackageInfo> installedPackages = packageManager.getInstalledPackages(
+                PackageManager.GET_PERMISSIONS);
+        for (PackageInfo pkg : installedPackages) {
+            boolean hasHomeAppPermission = false;
+            if (pkg.requestedPermissions != null) {
+                for (String perm : pkg.requestedPermissions) {
+                    if (perm.equals(Home.PERMISSION_HOME_APP)) {
+                        hasHomeAppPermission = true;
+                        break;
+                    }
+                }
+            }
+            if (hasHomeAppPermission) {
+                try {
+                    ApplicationInfo appInfo = packageManager.getApplicationInfo(pkg.packageName,
+                            PackageManager.GET_META_DATA);
+                    Bundle metadata = appInfo.metaData;
+                    if (metadata != null && metadata.containsKey(Home.METADATA_HOME_STUB)) {
+                        String homeStub = metadata.getString(Home.METADATA_HOME_STUB);
+                        installedHomePackages.put(appInfo.uid,
+                                new ComponentName(pkg.packageName, homeStub));
+                    }
+                } catch (NameNotFoundException ex) {
+                    // Ignored. The package doesn't exists ¿?
+                }
+            }
+        }
+
+        // FIXME For now we only support known Home apps. Remove this checks when
+        // Trebuchet allows Home apps through the full Home Host Protocol
+        if (installedHomePackages.size() > 0) {
+            for (String pkg : WELL_KNOWN_HOME_APP_PKGS) {
+                int i = installedHomePackages.size() - 1;
+                boolean isWellKnownPkg = false;
+                for (; i >= 0; i--) {
+                    int key = installedHomePackages.keyAt(i);
+                    if (installedHomePackages.get(key).getPackageName().equals(pkg)) {
+                        isWellKnownPkg = true;
+                        break;
+                    }
+                }
+                if (!isWellKnownPkg) {
+                    installedHomePackages.removeAt(i);
+                }
+            }
+        }
+
+        return installedHomePackages;
+    }
+
+    public static Context createNewHomePackageContext(Context ctx, ComponentName pkg) {
+        // Create a new context package for the current user
+        try {
+            return ctx.createPackageContext(pkg.getPackageName(),
+                    Context.CONTEXT_IGNORE_SECURITY | Context.CONTEXT_INCLUDE_CODE);
+        } catch (NameNotFoundException ex) {
+            Log.e(TAG, "Failed to load a home package context. Package not found.", ex);
+        }
+        return null;
+    }
+}
diff --git a/src/org/cyanogenmod/trebuchet/home/HomeWrapper.java b/src/org/cyanogenmod/trebuchet/home/HomeWrapper.java
new file mode 100644
index 000000000..df8b6cae6
--- /dev/null
+++ b/src/org/cyanogenmod/trebuchet/home/HomeWrapper.java
@@ -0,0 +1,236 @@
+/*
+ * Copyright (C) 2014 The CyanogenMod Project
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *      http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package org.cyanogenmod.trebuchet.home;
+
+import android.content.Context;
+import android.util.Base64;
+import android.util.SparseArray;
+import android.view.View;
+
+import com.android.launcher.home.Home;
+
+import java.lang.reflect.Method;
+import java.security.MessageDigest;
+import java.security.NoSuchAlgorithmException;
+
+public class HomeWrapper {
+
+    private static final int M_ID_ONSTART = 0;
+    private static final int M_ID_ONDESTROY = 1;
+    private static final int M_ID_ONRESUME = 2;
+    private static final int M_ID_ONPAUSE = 3;
+    private static final int M_ID_ONSHOW = 4;
+    private static final int M_ID_ONSCROLLPROGRESSCHANGED = 5;
+    private static final int M_ID_ONHIDE = 6;
+    private static final int M_ID_ONINVALIDATE = 7;
+    private static final int M_ID_ONREQUESTSEARCH = 8;
+    private static final int M_ID_CREATECUSTOMVIEW = 9;
+    private static final int M_ID_GETNAME = 10;
+    private static final int M_ID_GETNOTIFICATIONFLAGS = 11;
+    private static final int M_ID_GETOPERATIONFLAGS = 12;
+    private static final int M_LAST_ID = M_ID_GETOPERATIONFLAGS + 1;
+
+    private final Context mContext;
+    private final Class<?> mClass;
+    private final Object mInstance;
+
+    private final SparseArray<Method> cachedMethods;
+
+    private final int mNotificationFlags;
+    private final int mOperationFlags;
+
+    public HomeWrapper(Context context, Class<?> cls, Object instance) throws SecurityException {
+        super();
+        mContext = context;
+        mClass = cls;
+        mInstance = instance;
+        cachedMethods = new SparseArray<Method>(M_LAST_ID);
+
+        final String sha1 = createDigest(cls);
+        if (!sha1.equals(Home.SIGNATURE)) {
+            throw new SecurityException("The remote Home app doesn't implement " +
+                    "the current Home Host Protocol. Signature: " + sha1);
+        }
+
+        // Obtain the app flags
+        mNotificationFlags = getNotificationFlags();
+        mOperationFlags = getOperationFlags();
+    }
+
+    /** @see Home#onStart(Context) **/
+    public void onStart() {
+        invokeVoidContextMethod(M_ID_ONSTART, "onStart");
+    }
+
+    /** @see Home#onDestroy(Context) **/
+    public void onDestroy() {
+        invokeVoidContextMethod(M_ID_ONDESTROY, "onDestroy");
+    }
+
+    /** @see Home#onResume(Context) **/
+    public void onResume() {
+        if (!isNotificationSupported(Home.FLAG_NOTIFY_ON_RESUME)) {
+            return;
+        }
+        invokeVoidContextMethod(M_ID_ONRESUME, "onResume");
+    }
+
+    /** @see Home#onPause(Context) **/
+    public void onPause() {
+        if (!isNotificationSupported(Home.FLAG_NOTIFY_ON_PAUSE)) {
+            return;
+        }
+        invokeVoidContextMethod(M_ID_ONPAUSE, "onPause");
+    }
+
+    /** @see Home#onShow(Context) **/
+    public void onShow() {
+        if (!isNotificationSupported(Home.FLAG_NOTIFY_ON_SHOW)) {
+            return;
+        }
+        invokeVoidContextMethod(M_ID_ONSHOW, "onShow");
+    }
+
+    /** @see Home#onScrollProgressChanged(Context, float) **/
+    public void onScrollProgressChanged(float progress) {
+        if (!isNotificationSupported(Home.FLAG_NOTIFY_ON_SCROLL_PROGRESS_CHANGED)) {
+            return;
+        }
+        try {
+            Method method = cachedMethods.get(M_ID_ONSCROLLPROGRESSCHANGED);
+            if (method == null) {
+                method = mClass.getMethod("onScrollProgressChanged", Context.class, float.class);
+            }
+            method.invoke(mInstance, mContext, progress);
+        } catch (ReflectiveOperationException ex) {
+            throw new SecurityException(ex);
+        }
+    }
+
+    /** @see Home#onHide(Context) **/
+    public void onHide() {
+        if (!isNotificationSupported(Home.FLAG_NOTIFY_ON_HIDE)) {
+            return;
+        }
+        invokeVoidContextMethod(M_ID_ONHIDE, "onHide");
+    }
+
+    /** @see Home#onInvalidate(Context) **/
+    public void onInvalidate() {
+        invokeVoidContextMethod(M_ID_ONINVALIDATE, "onInvalidate");
+    }
+
+    /**
+     * @see Home#onRequestSearch(Context, int)
+     */
+    public void onRequestSearch(int mode) {
+        try {
+            Method method = cachedMethods.get(M_ID_ONREQUESTSEARCH);
+            if (method == null) {
+                method = mClass.getMethod("onRequestSearch", Context.class, int.class);
+            }
+            method.invoke(mInstance, mContext, mode);
+        } catch (ReflectiveOperationException ex) {
+            throw new SecurityException(ex);
+        }
+    }
+
+    /** @see Home#createCustomView(Context) **/
+    public View createCustomView() {
+        try {
+            Method method = cachedMethods.get(M_ID_CREATECUSTOMVIEW);
+            if (method == null) {
+                method = mClass.getMethod("createCustomView", Context.class);
+            }
+            return (View) method.invoke(mInstance, mContext);
+        } catch (ReflectiveOperationException ex) {
+            throw new SecurityException(ex);
+        }
+    }
+
+    /** @see Home#getName(Context) **/
+    public String getName() {
+        try {
+            Method method = cachedMethods.get(M_ID_GETNAME);
+            if (method == null) {
+                method = mClass.getMethod("getName", Context.class);
+            }
+            return (String) method.invoke(mInstance, mContext);
+        } catch (ReflectiveOperationException ex) {
+            throw new SecurityException(ex);
+        }
+    }
+
+    /** @see Home#getNotificationFlags() **/
+    private int getNotificationFlags() {
+        try {
+            Method method = cachedMethods.get(M_ID_GETNOTIFICATIONFLAGS);
+            if (method == null) {
+                method = mClass.getMethod("getNotificationFlags");
+            }
+            return (Integer) method.invoke(mInstance);
+        } catch (ReflectiveOperationException ex) {
+            return 0;
+        }
+    }
+
+    /** @see Home#getOperationFlags() **/
+    private int getOperationFlags() {
+        try {
+            Method method = cachedMethods.get(M_ID_GETOPERATIONFLAGS);
+            if (method == null) {
+                method = mClass.getMethod("getOperationFlags");
+            }
+            return (Integer) method.invoke(mInstance);
+        } catch (ReflectiveOperationException ex) {
+            return 0;
+        }
+    }
+
+    private void invokeVoidContextMethod(int methodId, String methodName) {
+        try {
+            Method method = cachedMethods.get(methodId);
+            if (method == null) {
+                method = mClass.getMethod(methodName, Context.class);
+            }
+            method.invoke(mInstance, mContext);
+        } catch (ReflectiveOperationException ex) {
+            throw new SecurityException(ex);
+        }
+    }
+
+    private final String createDigest(Class<?> cls) throws SecurityException {
+        try {
+            MessageDigest digest = MessageDigest.getInstance("SHA1");
+            Method[] methods = cls.getDeclaredMethods();
+            for (Method method : methods) {
+                digest.update(method.toString().getBytes());
+            }
+            return new String(Base64.encode(digest.digest(), Base64.NO_WRAP));
+        } catch (NoSuchAlgorithmException ex) {
+            throw new SecurityException(ex);
+        }
+    }
+
+    public boolean isNotificationSupported(int flag) {
+        return (mNotificationFlags & flag) == flag;
+    }
+
+    public boolean isOperationSupported(int flag) {
+        return (mOperationFlags & flag) == flag;
+    }
+}