Patch Launcher Reset to First Page - Revision history

IMGrant: Fixed a bug in the patch.

2009-12-08T11:11:13Z

Fixed a bug in the patch.

IMGrant: Added PreCentral forums link

2009-12-06T19:56:11Z

Added PreCentral forums link

IMGrant: Updated patch, now longer relies on Reset Scroll Position patch to reset scroll.

2009-12-05T13:37:15Z

Updated patch, now longer relies on Reset Scroll Position patch to reset scroll.

IMGrant at 11:52, 30 November 2009

2009-11-30T11:52:49Z

IMGrant: Updated patch, no real functional change but now it works like the reset to middle page patch.

2009-11-30T11:30:19Z

Updated patch, no real functional change but now it works like the reset to middle page patch.

IMGrant: Copied from Patch Launcher Reset Scroll on Page Change and edited accordingly.

2009-11-27T16:56:51Z

Copied from Patch Launcher Reset Scroll on Page Change and edited accordingly.

New page

{{template:patch}}
==Introduction==

The Launcher maintains the last page opened when you return to it. If you most frequently use apps on the first page of the Launcher, you have to swipe back to the first page if the last app you launched was on another page.
This patch resets the Launcher to the first page every time it's closed (in readiness for when it's next opened).
This works best in combination with the [[Patch Launcher Reset Scroll on Page Change]] patch to ensure the page is also always scrolled to the top.

==Editing Process==

* SSH in.
* Remount the filesystem as read/write:
<blockquote><source lang="bash">
sudo rootfs_open -w
</source></blockquote>
* Load launcher-assistant.js in vi:
<blockquote><source lang="bash">
sudo vi /usr/lib/luna/system/luna-applauncher/app/controllers/launcher-assistant.js
</source></blockquote>
* Locate the text 'this.removeLaunchFeedback();' in the onDeactivate method around line 185 (onDeactivate begins at line 171 in webOS 1.3.1, 'this.removeLaunchFeedback();' is the last line of that method):
<blockquote><source lang="javascript">
/* clean and hide global search */
onDeactivate: function(event) {

this.globalSearchAssistant.deactivate();

this.reorderController.cancel();

if (this.appDialog) {
this.appDialog.mojo.close();
}

SystemManagerService.showQuickLaunch(true);

delete this.launchRequest;

this.removeLaunchFeedback();
},
</source></blockquote>
* Add the following lines below so that onDeactivate now looks like this:
<blockquote><source lang="javascript">
/* clean and hide global search */
onDeactivate: function(event) {

this.globalSearchAssistant.deactivate();

this.reorderController.cancel();

if (this.appDialog) {
this.appDialog.mojo.close();
}

SystemManagerService.showQuickLaunch(true);

delete this.launchRequest;

this.removeLaunchFeedback();

/* Reset launcher to first page for next time */
$('launcher_root').mojo.setSnapIndex(0, true);

/*
* If Bsiegel's 'Reset Scroll Position' patch is installed
* then this does what it says on the tin for the first page.
*/
event.value = 0; /* fudge this because onPageChange expects a
* mojo-property-change event but it's actually
* getting mojo-event-deactivate.
*/
this.onPageChange(event);

},
</source></blockquote>
* Save the file and quit vi.
* Remount the filesystem as read only - this should reboot your Pre:
<blockquote><source lang="bash">
sudo rootfs_open -w
</source></blockquote>

==Patch Process==

The patch is not in the webos-internals gitorious repository - if anybody can help with uploading that, it would be much appreciated (it's my first patch!). Until then, you can copy and paste the source below. Visit [[Applying Patches]] for info on how to use it. To apply the patch, follow the instructions above, and after remounting the filesystem as read/write, do the following:

* Apply the patch (In this example, I have the patch file located in my home directory under '''patches'''):
<blockquote><source lang="bash">
cd /
sudo patch -p0 --backup-if-mismatch < ~/patches/reset-to-first-page.patch
</source></blockquote>
<blockquote>
This is what you should see if it ran properly:
<source lang="text">
patching file /usr/lib/luna/system/luna-applauncher/app/controllers/launcher-assistant.js
</source></blockquote>
* Remount the filesystem as read only as described above.

===Patch Source (reset-to-first-page.patch)===

<source lang="diff">
--- /usr/lib/luna/system/luna-applauncher/app/controllers/launcher-assistant.js.webosinternals.orig Fri Nov 27 08:29:40 2009
+++ /usr/lib/luna/system/luna-applauncher/app/controllers/launcher-assistant.js Fri Nov 27 08:31:23 2009
@@ -183,6 +183,20 @@
delete this.launchRequest;

this.removeLaunchFeedback();
+
+ /* Reset launcher to first page for next time */
+ $('launcher_root').mojo.setSnapIndex(0, true);
+
+ /*
+ * If Bsiegel's 'Reset Scroll Position' patch is installed
+ * then this does what it says on the tin for the first page.
+ */
+ event.value = 0; /* fudge this because onPageChange expects a
+ * mojo-property-change event but it's actually
+ * getting mojo-event-deactivate.
+ */
+ this.onPageChange(event);
+
},

onResize: function(event) {
</source>

@@ Line 59: / Line 59: @@
 		/* Jump scroll position back to top for all pages */
 		for (var i=0; i<numPages; i++) {
 			var scroller = this.getPageScroller(i);
@@ Line 104: / Line 105: @@
++
 +		/* Jump scroll position back to top for all pages */
 +		for (var i=0; i<numPages; i++) {
 +			var scroller = this.getPageScroller(i);

← Older revision		Revision as of 19:56, 6 December 2009
Line 112:		Line 112:
	onResize: function(event) {		onResize: function(event) {
	</source>		</source>
		+
		+	==Support==
		+	The [http://forums.precentral.net/webos-patches/217638-patch-reset-launcher-first-middle-page.html discussion thread at the PreCentral.net forums] is the best place to ask any questions.

@@ Line 2: / Line 2: @@
 ==Introduction==
-The Launcher maintains the last page opened when you return to it. If you most frequently use apps on the first page of the Launcher, you have to swipe back to the first page if the last app you launched was on another page.
+By default, the Launcher maintains the last page opened when you return to it. If you most frequently use apps on the first page of the Launcher, you have to swipe back to the first page if the last app you launched was on another page.
-This patch resets the Launcher to the first page every time it opens. This works best in combination with the [[Patch Launcher Reset Scroll on Page Change]] patch to ensure the page is also always scrolled to the top.
+This patch resets the Launcher to the first page every time it opens. It also resets the scroll position of all pages, so that when you re-open the Launcher, all pages will be scrolled to the top (previously it only did this if the Reset Scroll Position patch was also installed, I abandoned that idea. Apologies if anyone really wants the reset page behaviour without the reset scroll feature - check out the page history for older versions or adjust the patch accordingly).
 ==Editing Process==
@@ Line 16: / Line 16: @@
 sudo vi /usr/lib/luna/system/luna-applauncher/app/controllers/launcher-assistant.js
 </source></blockquote>
-* Locate the 'Mojo.listen' handlers in the setup method around line 70 (setup begins at line 67 in webOS 1.3.1):
+* Locate the beginning of the onDeactivate method around line 170:
 <blockquote><source lang="javascript">
- 	setup: function() {
+	/* clean and hide global search */
+	onDeactivate: function(event) {
- 		Mojo.listen(this.controller.document, Mojo.Event.deactivate, this.onDeactivate.bindAsEventListener(this));
- 		Mojo.listen(this.controller.window, 'resize', this.onResize.bindAsEventListener(this));
+		this.globalSearchAssistant.deactivate();
-</source></blockquote>
-* Insert a new listener in between the existing two so that it now looks like this:
+		this.reorderController.cancel();
-<blockquote><source lang="javascript">
- 	setup: function() {
+		if (this.appDialog) {
+			this.appDialog.mojo.close();
- 		Mojo.listen(this.controller.document, Mojo.Event.deactivate, this.onDeactivate.bindAsEventListener(this));
-		Mojo.listen(this.controller.document, Mojo.Event.activate, this.onActivate.bindAsEventListener(this));
- 		Mojo.listen(this.controller.window, 'resize', this.onResize.bindAsEventListener(this));
+		SystemManagerService.showQuickLaunch(true);
 </source></blockquote>
-* Locate the beginning of the onDeactivate method around line 170 (onDeactivate begins at line 171 in webOS 1.3.1):
+* Add the following lines at the bottom of the onDeactivate method so that is now looks like this:
 <blockquote><source lang="javascript">
 	/* clean and hide global search */
 	onDeactivate: function(event) {
-</source></blockquote>
-* Add the following lines before onDeactivate so that is now looks like this:
+		this.globalSearchAssistant.deactivate();
-<blockquote><source lang="javascript">
-	/* set launcher page to override last used page */
+		this.reorderController.cancel();
-	onActivate: function(event) {
-		// set launcher to first page
+		if (this.appDialog) {
 		$('launcher_root').mojo.setSnapIndex(0, false);
-		/**
+		/* Jump scroll position back to top for all pages */
-		 * If Bsiegel's 'Reset Scroll Position' patch is installed
+		for (var i=0; i<numPages; i++) {
-		 * then this does what it says on the tin for the middle page.
+			var scroller = this.getPageScroller(i);
-		 */
+			if (scroller && scroller.mojo) { scroller.mojo.revealTop(); }
-		event.value = 0;	/* Fudge this because onPageChange expects a
 	},
 </source></blockquote>
 * Save the file and quit vi.
@@ Line 84: / Line 92: @@
 <source lang="diff">
---- /usr/lib/luna/system/luna-applauncher/app/controllers/launcher-assistant.js.webosinternals.orig	Sat Nov 28 01:54:57 2009
+--- /usr/lib/luna/system/luna-applauncher/app/controllers/launcher-assistant.js.orig	Sat Dec  5 11:48:12 2009
-+++ /usr/lib/luna/system/luna-applauncher/app/controllers/launcher-assistant.js	Mon Nov 30 03:15:43 2009
++++ /usr/lib/luna/system/luna-applauncher/app/controllers/launcher-assistant.js	Thu Dec  3 19:42:03 2009
-@@ -67,6 +67,7 @@
+@@ -183,6 +183,16 @@
- 	setup: function() {
+ 		delete this.launchRequest;
-  		Mojo.listen(this.controller.document, Mojo.Event.deactivate, this.onDeactivate.bindAsEventListener(this));
+  		this.removeLaunchFeedback();
-+		Mojo.listen(this.controller.document, Mojo.Event.activate, this.onActivate.bindAsEventListener(this));
- 		Mojo.listen(this.controller.window, 'resize', this.onResize.bindAsEventListener(this));
++		/* Reset launcher to first page */
- 		this.pagesModel = new LauncherPages({
++		$('launcher_root').mojo.setSnapIndex(0, false);
-@@ -167,6 +168,22 @@
- 		this.updatePageIndicators();
++		/* Jump scroll position back to top for all pages */
   	},
-+	/* set launcher page to override last used page */
+  	onResize: function(event) {
 </source>