WebOS Internals - User contributions [en]

Next steps

2009-08-04T22:59:55Z

Srlake314: /* Optware Setup */

''The old, manual setup of Optware and users can be found [[Setting_up_optware_feed | here]].''

=Automated Setup of Optware, Users and Access=
The webOS community asks that users who have obtained access to the Linux subsystem install a standard set of software to ensure everyone has the necessary tools in place to use the resources the community is providing.

In particular, this includes the Optware package manager. Palm's webOS uses the ''ipkg'' package manager internally. The community has a version of ''ipkg'' called ''ipkg-opt'' which accesses the Optware library of over 1300 Linux programs available for installation on the Pre.

Palm has indicated that they have no intention of using the /opt directory, so we direct our installs to /opt/bin rather than /bin to avoid being overwritten by future Palm software upgrades.

In addition, the standard package creates a non-root user, installs ''sudo'', and includes an SSH program (''dropbear'') and an sftp program.

For your convenience, we've packaged all this up into a simple script.

==Optware Setup==

'''If you're attempting to install these packages to your emulator, you must first add sufficient space by [[Adding_Disks_to_the_Emulator|enabling a virtual disk]].'''

After completing the process of obtaining access to your Pre, do the following:

'''Type each line exactly as it appears. Copying and pasting is probably a good idea.''' AND WHERE EXACTLY DO I TYPE THIS INTO? WHAT PROGRAM, IF IN CMD WINDOW, WHERE?

''Note to Windows Putty users: To paste in putty, simply right-click and the program pastes into the terminal whatever you have copied to the clipboard.''

<div style="font-size:100%;">
<source lang=bash>
cd /tmp
wget http://gitorious.org/webos-internals/bootstrap/blobs/raw/master/optware-bootstrap.sh
sh optware-bootstrap.sh
</source></div>

Follow the on-screen instructions.

If you want to review the script before you run it, you can look here:

[http://gitorious.org/webos-internals/bootstrap/blobs/master/optware-bootstrap.sh http://gitorious.org/webos-internals/bootstrap/blobs/master/optware-bootstrap.sh]

==Quilt setup==

Optionally, you can then install the ''quilt'' patch manager which allows multiple-file patches. (Yes, the pun was intentional. Quilt manages multiple patches.) This installation process has also been packaged into a simple script. It will install quilt, and all of its dependencies, and create a local clone of the WebOS-Internals patch repository. [[Applying_Patches | Applying Patches]] provides a more thorough guide on the use of quilt.

'''Again, type each line exactly as it appears. Copying and pasting is probably a good idea.'''

<div style="font-size:100%;">
<source lang=bash>
cd /tmp
wget http://gitorious.org/webos-internals/bootstrap/blobs/raw/master/quilt-bootstrap.sh
sh quilt-bootstrap.sh
</source></div>

If you want to review the script before you run it, you can look here:

[http://gitorious.org/webos-internals/bootstrap/blobs/master/quilt-bootstrap.sh http://gitorious.org/webos-internals/bootstrap/blobs/master/quilt-bootstrap.sh]

==Finishing==

To finish off, turn Developer Mode back to "Off" (which will reboot your Pre).

Once you are finished, you may SSH into your Pre with an SSH client like [http://www.chiark.greenend.org.uk/~sgtatham/putty/ Putty]:
*Find your IP address with [http://checkmyip.com/ CheckMyIP.com]
*SSH to that IP address on port 222
**If you're doing this over EVDO, there may be a lot of latency. Be patient.
*Log in with the username and password you created during the Optware installation
**Many operations cannot be carried out with the permissions of that username. You'll need to [[Basic_Linux_Use#sudo|sudo]] those operations with the new username's password

Portal:Community

2009-08-04T17:54:46Z

Srlake314: /* IRC */

There is a large community of developers around the Palm Pre.

* [[Contact|Contact]]
* [[Meetups|Meetups]]

== IRC ==
[[image:Linux_Chat.png|right]]
You can join us anytime on our [[wikipedia:Internet Relay Chat|IRC]] channels.

* [irc://chat.freenode.net/webos #webos] for general Palm Pre topics
* [irc://chat.freenode.net/webos-internals #webos-internals] for discussion of the operating system
* [irc://chat.freenode.net/webos-watercooler #webos-watercooler] for off-topic discussion

We are located on the freenode network, accessible from chat.freenode.net

Come and join us

=== Guidelines ===
[[image:Linux_Mad.png|right]]

See [[WebOS-Internals IRC Channel Policy]].

* For pastes greater than 2 lines, use a pastebin such as [http://webos.pastebin.com/ webos.pastebin.com].
* Keep the language civilized. Don't try to debate. WebOS is cross platform and the [[Portal:Tools|tools]] supported by webOS-Internals are also.
#how do I access this through pidgeon'?

Patch Email Enable Landscape Viewing

2009-08-04T17:11:50Z

Srlake314: /* Notes */

{{template:patch}}
== Preamble==

You will need write permissions to the file system on your Pre to apply this patch.

To get write persmissions execute:
<pre><nowiki>rootfs_open -w</nowiki></pre>

After you've made the changes below, remount the file system as read-only:
<pre><nowiki>mount -o remount,ro /</nowiki></pre>

== Procedure==

Enabling rotation in email is trivial. Whenever you rotate the device, the system calls the orientationChanged function of the app. There's already one defined in email, but for some reason it does nothing. You can enable rotation by applying the following patches.

NOTE: The root of the patches is /usr/palm/applications/com.palm.app.email/

=== app/controllers/list-assistant.js===

<pre><nowiki>
--- list-assistant.js_2009-06-27 Sat Jun 27 19:19:19 2009
+++ list-assistant.js Sat Jun 27 20:03:19 2009
@@ -27,6 +27,9 @@
{label:$L('Update'), icon:'sync', command:'sync'}
]};
this.controller.setupWidget(Mojo.Menu.commandMenu, undefined, this.cmdMenuModel);
+
+ // enable free orientation
+ this.controller.window.PalmSystem.setWindowOrientation("free");
},

// NOTE: this is called by app_scene's _setup function
</nowiki></pre>

=== app/controllers/compose-assistant.js===

<pre><nowiki>
--- compose-assistant.js_2009-06-27 Sat Jun 27 19:21:43 2009
+++ compose-assistant.js Sat Jun 27 20:03:45 2009
@@ -178,6 +178,9 @@

// Delayed a little, since we want the header part of render as quickly as possible
ComposeAssistant.onLoad.defer(this.controller, this.email);
+
+ // enable free orientation
+ this.controller.window.PalmSystem.setWindowOrientation("free");
},

cleanup: function() {
</nowiki></pre>

=== app/controllers/accounts-assistant.js===

<pre><nowiki>
--- accounts-assistant.js_2009-06-27 Sat Jun 27 19:29:47 2009
+++ accounts-assistant.js Sat Jun 27 20:01:28 2009
@@ -51,6 +51,9 @@
EmailAppDepot.depot.isShowFavorites(AccountsAssistant.kFavoriteFoldersAccountID, this.depotGetFavExpanded.bind(this));

this.controller.listen(this.controller.sceneElement, Mojo.Event.keypress, this.keypressHandler.bind(this));
+
+ // enable free orientation
+ this.controller.window.PalmSystem.setWindowOrientation("free");
},

cleanup: function() {
</nowiki></pre>

== Notes==

Credit goes to jblebrun for the original hack.

Seems that the menu disappears in landscape mode and that the orientation mode carries over from one part of the app to the other as you move to a message or back to the message list or account list. This is especially weird in the compose screen since the menu has some needed functionality in it
~ FXDemolisher

Curious item found in accounts-assitant.js. There seems to be an orientationString variable in the controller that is linked to some kind of hack if you type a specific string while having the account(folder) list open. Will investigate further.

UPDATE: Seems that typing "RocknRollHax" (see ./app/controllers/accounts-assistant.js) in the accounts list window will cause the email app to go into 'free' orientation mode. Looks like its an easier way to perform orientation changes instead of explicitly calling setWindowOrientation whenever the orientation changes. '''Doesnt work'''

Alternate to RocknRollHax: In accounts-assistant.js, change key word in line 106 to 'wide' or whatever you want. Change string length in line 104 to num characters of your new key word. - xorg

- FXDemolisher

7/25/2009 With webOS 1.1 you can type "wide" to activate this feature w/o editing any files. However it is not persistent between application launches.

Only the '''accounts-assistant.js''' file needs to be patched in webOS 1.1. The '''compose-assistant.js''' edit needs work as it currently does not work in webOS 1.1.

-NetWhiz