WebOS Internals - User contributions [en]

Application:Preware

2011-10-29T21:54:17Z

JayCanuck: updated wosqi section

[[Category:Application]]
This page is currently available in four languages:
: [[Image:Australia.png]] [[Image:USA.png]] [[Application:Preware]]
: [[Image:France.png]] [[Application:Preware-FR]]
: [[Image:Germany.png]] [[Application:Preware-DE]]
: [[Image:China.png]] [[Application:Preware-ZH]]

{{application
| name=Preware
| type=webOS
| version=Version: 1.8.3 (16 September 2011)
| tag=Utilities
| screenshot=Preware_ss1.png
| description=
}}

 
== Summary ==

[[image:Icon_Preware.png|frameless|left]]
Preware is a package management application for the Palm Pre, Palm Pixi, and the HP TouchPad. Preware allows the user to install any package from any of the open standard package repositories on preware.org (or any other location that hosts an open standard package repository). Preware relies on a custom written service developed from community research which allows the mojo app to talk to the built-in ipkg tool.

'''Preware requires webOS 1.4.0 or later to function. Do not try to install it on earlier webOS versions, it will not work.'''

This application was the result of extensive community-based design in [[IPKG Service]] and [[Preware Design]].

For application management, Preware can access more applications, and has more features, than any other on-device package installer.

And since it is open source, and has a completely open development process supported by a team of world-class WebOS Internals developers, it will continue to get better much faster than any other package management application.

Preware is the open application installer that has been written specifically to support a homebrew ecosystem where any developer can upload any application to any submission site, and that application can then be installed by any user. Developers no longer need to upload their applications to multiple submission sites, and users are no longer excluded from accessing applications from any open standard package repository.

 
=== Key features ===
Install / Remove / Update:
* Homebrew Applications including advanced applications with special requirements.
* WebOS Themes
* Patches
* webOS Kernels
* Support for installation of signed packages

 
=== Status ===
Preware has been upgraded to release status, and is no longer considered beta.

Some milestones worth mentioning in Preware's history include:

* Since 27 August 2009, it is the only over-the-air installer for the palm capable of installing advanced palm applications such as the [[On_Screen_Keyboard|On Screen Keyboard]] or the terminal application.
* Since 27 August 2009, it is the only application supporting installation from all existing palm homebrew feeds.
* Since 17 September 2009, it also supports installation of themes.
* Since 8 October 2009, it also supports installation of webOS patches.
* Since 12 Jan 2010, it also supports all Palm App Catalog feeds.
* Since 3 May 2010, it also supports installation of webOS custom kernels.
* Since 20 July 2010, it also supports installation of packages from URLs and local files.
* Since 24 July 2010, is also supports blacklisting packages and authors.
* Since 8 June 2011, access to webOS app catalog feeds is no longer available to third party developers or applications.

 
=== License ===
Please be aware that org.webosinternals.preware is licensed under the [http://www.gnu.org/licenses/gpl-2.0.html GPLv2].

Code from Preware cannot be used by a closed source application. If you want to use them in a non-GPLv2 but otherwise open source application, please contact the [mailto:support@webos-internals.org authors].

 

== Installing Preware ==

There are four supported methods for installing Preware: Official HP/Palm SDK, WebOS Quick Install, Stand Alone Installers, and Command Line.

You do not need to access the Linux command line or "root your Pre" to install or use Preware.

You ''cannot'' use fileCoaster, or PreLoad, or PreUpdate to install or update Preware. Those tools are unable to operate correctly on advanced homebrew packages.

If you are a developer who uses the Palm emulator, you should know that Preware works just as well on the Emulator as it does on a real device, and is installed in exactly the same way.

 
=== Installing Preware using the official HP/Palm SDK ===

To install Preware on any webOS device, the following procedure is recommended if you're having problems with WebOS Quick Install:

# Install the latest official Palm webOS SDK from http://developer.palm.com
# '''Disconnect your device''' (I repeat, do not have your device connected, no cables in the device, device not even anywhere near the computer), and run the latest webOS Doctor to install or upgrade your Novacom drivers
# Close the doctor
# Your device should remain disconnected
# Download the latest Preware package onto your computer from http://get.preware.org/
## To install Preware on a device, download the 'arm' .ipk file
## To install Preware on an emulator, download the 'i686' .ipk file
# Typing webos20090606, select the developer mode icon that will appear, and verify that your device is in developer mode
# Connect your device to your computers USB port, and select 'Just Charge' (or 'Cancel' on your Touchpad)
# If you are installing on a Veer, you will need to reboot the phone while connected to the computer, at this point, or it will not be recognized
# Use palm-install to install the package you downloaded
## Typically you can simply get a command line, navigate to the directory with the Preware package you downloaded, then type palm-install and.the.package.arm.name.ipk

 

=== Installing Preware with WebOS Quick Install ===
You can use version 4.1.1 or later of [http://forums.precentral.net/canuck-coding/274461-webos-quick-install-v4-1-1-a.html WebOS Quick Install] to install Preware on any device easily and quickly, without the need to download a big 200MB SDK and webOSDoctor.

'''Latest Version of WebOS Quick Install available here: [http://forums.precentral.net/canuck-coding/274461-webos-quick-install-v4-2-3-a.html WebOS Quick Install v4.3.1]'''

'''For a step-by-step tutorial and interactive problem troubleshooting, the official [http://bit.ly/wosqi-guide WOSQI Homebrew Guide] is highly recommended'''

# Install the required Software
## [http://www.java.com/en/download/installed.jsp?detect=jre&try=1 Click here] to verify that you have the latest java installed on your computer and update if needed
## [http://bit.ly/wosqi-download Click Here] to download the current version of WebOS Quick Install
# Put your device in [[Getting started|Developer Mode]]
# Connect your device to your computer with the USB cable, and select "Just Charge" or "Cancel" (on a Touchpad). Do not select USB Drive.
# Run WebOS Quick Install. If the novacom driver is not installed, WebOS Quick Install will download and install that for you.
## '''Do not believe any guide that says you need to download the SDK or webOSDoctor for WOSQI to run.''' The most you'll download is the novacom driver, which is only 11MB on Windows, and will be done via WOSQI.
# If you are installing on a Veer, you will need to reboot the phone at this point or WOSQI will not recognize it. Hold the On/Off button down for about five seconds and release it. Select "Power" then select "Restart".
# Click the third button on the right (the globe icon)
# Select the Applications tab at the top
# Search for Preware
# Click Install.

 

=== Installing Preware with the standalone installer ===
Preware installers can be downloaded here: [http://get.preware.org Preware Standalone Installers]. These instructions are currently only for Mac and PC users.

# Install the required software.
## [http://www.java.com/en/download/installed.jsp?detect=jre&try=1 Click here] to verify that you have the latest version of Java installed on your computer and update it if needed.
## [http://www.webos-internals.org/wiki/Webos_Doctor_Versions Click here] to download the current webOS Doctor for your carrier and device in a subdirectory you will remember (maybe "Palm"?). If you already have it, skip this step.
##* '''Do not run the webOS Doctor.'''
# Put your device into [[Getting started|Developer Mode]].
#* '''Windows users:''' When connecting your device to the computer for the first time, you will be prompted to install new hardware. Click Next to start the device installation. You may get a message regarding Novacom drivers not being installed. If so, you can disregard it. Once your device is installed, proceed with the Preware installation.
# Download the [http://get.preware.org/ Preware Standalone Installer] (you should choose the latest file name PrewareInstaller-X.Y.Z.jar) and place it in the same directory as the webOS Doctor .jar file.
# Run the Preware Installer.
# Click on the Tools menu and choose Install Drivers. This will install the Palm Novacom drivers for webOS devices.
# If you are installing on a Veer, you may need to reboot the phone at this point.
# Once the drivers have finished installing, click on Install Preware. After Preware is installed, your device will be unresponsive for a few seconds while Luna restarts.

 
=== Installing Preware from the command line ===
If you have access to the command line of your webOS Device or emulator using Terminal, Novaterm, the "Linux Commandline" in WebOS Quick Install, or other techniques, you can install Preware by typing three lines. If you are in any way unsure of operating at the Linux command line, please use either of the methods described above.

<source lang="bash">
cd /tmp
wget http://gitorious.org/webos-internals/bootstrap/blobs/raw/master/preware-bootstrap.sh
sh /tmp/preware-bootstrap.sh
</source>

 

=== Updating Preware ===
To update Preware, just run Preware and select "Package Updates" from the main scene. If an update to Preware is available, it will appear in the list. Then select the "Update" button. Preware will close automatically after the update is complete.

Alternatively, WebOS Quick Install provides a method for updates as well that is similar to Preware.

Note that you cannot use fileCoaster, or PreLoad, or PreUpdate to install or update Preware. Those tools are unable to operate correctly on advanced homebrew packages.

 

=== Removing Preware ===
''Why would you ever want to remove Preware?''

To remove Preware on webOS 2.x or lower, hold the Orange button on your keypad and choose Preware from the Launcher. Choose Delete.
For Touchpads (3.x), tap and hold the icon and click the "x" that appear on the icon. Choose delete.

 

== Usage ==
=== Preferences ===
{| Width="70%" VAlign="top"
| valign="top"|[[image:Preferences.png|160px|frameless|left|text-top]]
| valign="top"|You can select preferences in the top left corner of the Pre to bring up the preferences screen. On the Preferences screen you can specify the look of the application, the frequency that feeds are updated, and what Preware will show you by default.
 
{| style="color:black; background-color:#F9F9F9;border:1px outset;" cellpadding="3" cellspacing="0"
| TIP:
|-
| To make it easier to find things, set "Show Available Types" to yes. This will show separate categories (Applications/Themes/Patches/etc.) rather than show everything in one long list.
|}
|}
 

=== Feed management ===
{| Width="70%" VAlign="top"
| valign="top"|[[image:Preware_feeds.png|160px|frameless|left|text-top]]
| valign="top"|In the preferences section on the top bar on the right side is a button that takes you to the feeds screen. On the feeds screen you can select which feeds are loaded and which ones are not. Simply select the on or off button for that feed. (If you are not interested in themes you can disable the two feeds for themes to speed up the updating of feeds) Preware comes with the following feeds by default (some are disabled by default, but are easily enabled if desired).

{| style="color:black; background-color:#FFFFE0;" cellpadding="3" cellspacing="0" Border="1"
| align="center" colspan="4" | '''Default Feeds'''
|-
| align="center" | [http://ipkg.preware.org/feeds/precentral/ PreCentral]
|-
| align="center" | [http://ipkg.preware.org/feeds/webos-internals/ WebOS Internals]
| align="center" | [http://ipkg.preware.org/feeds/optware/ Optware]
| align="center" | [http://ipkg.preware.org/feeds/webos-patches/ WebOS Patches]
| align="center" | [http://ipkg.preware.org/feeds/webos-kernels/ WebOS Kernels]
|-
|}
|}

{| style="color:black; background-color:#F9F9F9;border:1px outset;" VAlign="middle" cellpadding="3" cellspacing="0" Width="70%"
| align="center" | See [[Testing Feeds]] for detailed instructions on adding custom feeds.
|}
 

=== Package updates ===
{| Width="70%" VAlign="top"
| valign="top"|[[image:UpdateFeeds.png|160px|frameless|left|text-top]]
| valign="top"|To update feeds, simply select "Update Feeds" from the Application Menu. Preware will download the package list information from your enabled feeds. After processing the data, you will be back at the main list of available items.
|}
 

=== Installing packages ===
{| Width="70%" VAlign="top"
| valign="top"|[[image:SelectApp.png|160px|frameless|left|text-top]]
| valign="top"|There are a few ways to select and install a "package" (application/patch/theme/etc.). Using "List of Everything" would be the simplest.
# Find the package you want to install either by scrolling and tapping on it, or just start typing
# Tap the "Install" button that the bottom of the package's page to install.
|}
 

=== Removing packages ===
{| Width="70%" VAlign="top"
| valign="top"|[[image:RemoveAppTap.png|160px|frameless|left|text-top]]
| valign="top"|Removing a package is just as easy.
# On the main screen, tap "Installed Packages", then the category of the package you want to remove
# Tap the Package you want to remove
# Tap the "Remove" button that the bottom of the package's page.
|}
 

=== Blacklist (category filters) ===
{| Width="70%" VAlign="top"
[[File:preware_2011-09-03_165038.png]]''' '''[[File:preware_2011-09-03_165049.png]]
| valign="top" | The Preware "Blacklist" is a tool used to hide packages (applications, patches, etc) that you do not want to see, such as mass-produced book apps or real estate apps. This tool can also be used to hide unavailable packages, such as patches that are not compatible with your current webOS version. Got to Preferences in Preware and scroll to the Blacklist section. You can add whatever filters you like to customize your Preware experience. To hide all apps from a particular Maintainer, choose a "Maintainer" filter with the package maintainer in the search field. To hide unavailable packages, choose a "Category" filter, with "Unavailable" in the search field.
|}
 



== Operating notes ==
=== Limitations ===
No known limitations.

 
=== Known bugs ===
* When selecting a patch with dependencies, if you view those dependencies then install them, when Preware returns you to the original patch's screen it will still have the 'install' button showing even though it is installed successfully. Swiping back and returning will show the correct status.

* The Update All button can get confused if there are patches with complex dependencies. This will be fixed in a future version.

* The Updates feature from the regular Palm Launcher, may claim that application updates are needed, and then when the user clicks Show Updates shows the App Catalog's installed applications, there are none shown that need updating. This isn't as expected. This is because an app that was previously only in Preware has now migrated to the Palm Catalog. Don't worry, your apps are up to date (with the possible exception of the one with the conflict.) This is not a bug in Preware per se' but an app version conflict because the app is in both the Palm Catalog and also in Homebrew. Notice that you don't need to remove Preware to install the app from the official catalog, but simply disable the feed in Preware then "update feeds" to refresh the list then it should install fine from the official app catalog.

 
== Changelog ==
 
For those interested, the full Changelog can be [http://git.webos-internals.org/?p=applications/preware.git;a=tags found here]. Listed below is the Changelog since the 1.0 milestone.
 

; 1.8.3
* Please read http://testing.preware.org/ if you use the testing feeds

; 1.8.2
* Fixed the removal of obsolete testing feeds

; 1.8.1
* Remove the obsolete testing feeds when adding alpha or beta feeds

; 1.8.0
* Disabled support for adding obsolete testing feeds

; 1.7.7
* Enabled support of alpha and beta testing feeds

; 1.7.6:
* Larger screenshots on the TouchPad
* Pressed states for TouchPad back buttons
* Fixed search backspace on TouchPad

; 1.7.5:
* Fixed list rendering on TouchPad (courtesy of chpwn).

; 1.7.4:
* Removed catalog feed specific preferences (show only free/show only english).

; 1.7.3:
* Added support for font packages.

; 1.7.2:
* Replaced the word phone with the word device in all messages.

; 1.7.1:
* Fixed fullscreen screenshot resizing on TouchPad rotate (courtesy of Appsotutely).
* Fixed dependent packages spinner location (courtesy of chpwn).

; 1.7.0:
* Rolled up all the beta release features for a TouchPad-compatible public release.

; 1.6.8:
* Enabled back tap on header for all devices.

; 1.6.7:
* Fixed full-screen formatting of ipkg log screen.

; 1.6.6:
* Preware is now fully compatible with the TouchPad, using the full screen area.

; 1.6.5:
* Now usable on devices without a back gesture.
* Set the wget user-agent to Preware when retrieving indexes and packages.

; 1.6.4:
* Fixed a problem when loading the saved packages list.

; 1.6.3:
* WebOS Internals has been formally notified by Richard Kerris (HP Vice President of Worldwide Developer Relations) that open access to the webOS app catalog feed (including the beta and web feeds) is no longer available to third party developers or applications. Please direct any questions about this decision (which is final and permanent) to HP, not to WebOS Internals.
* Removed all HP webOS app catalog feeds from new installations of Preware.

; 1.6.2:
* Added the clock themes feed (disabled by default).

; 1.6.0:
* webOS 2.x Just Type integration.
* Fixed package list ordering bug.
* Layout fixes for Pixi/Veer.

; 1.5.9:
* Fixed parse errors resulting from packages with very large descriptions.
* Fixed problems with updates to app catalog apps.

; 1.5.8:
* Moved blacklisting to feed load to speed up listing.
* Suggests a reload after changing the blacklist.
* Fixed homebrew feed/catalog feed same appid bug.

; 1.5.7:
* Added check to make sure package has a title before trying to search it.

; 1.5.6:
* Removed support for Visibility feed value - use a category filter to exclude Unavailable packages if desired.

; 1.5.5:
* Added support for Visibility feed value.
* Fix display of screenshots from devices with a different resolution.
* Test fix for custom feed on network with no internet connection.
* Style updates for pre3 screen size.

; 1.5.4:
* Updated French translations (courtesy of Clément).

; 1.5.3:
* Reinstated banner notification of manual saved package list update.

; 1.5.2:
* Check if package dates are actually dates.
* Removed banner notification of saved package list being saved.

; 1.5.1:
* Added support for optware testing feeds.

; 1.5.0:
* You must upgrade to this version for full webOS 2.0 compatibility.

; 1.4.9:
* Better compatibility with unknown future webOS versions.

; 1.4.8:

* Now calls the correct software manager updates screen on webOS 2.0.

; 1.4.7:
* Fixed update, install and remove status messages on webOS 2.0.

; 1.4.6:
* New "App Catalog" theme preferences thanks to Garrett92C.
* Added support for "MaxWebOSVersion" in the feeds.

; 1.4.5:
* Added support for identifying when running on a Pre 2 device.

; 1.4.4:
* Updated the version check to support future webOS versions.

; 1.4.2:
* Added Category as a blacklist option.

; 1.4.1:
* Added a Changelog button to the Help scene.

; 1.4.0:
* Added help to preferences scene.
* Fixed swipe-to-delete bug in blacklist.
* Updated Italian translations (courtesy of Darkmagister).
* Added "Get Info" button to package install scene.
* Added "Send" button to ipkg log scene.
* Fixed bug when loading large package descriptions.

; 1.3.8:
* Updated French translations (courtesy of Yannick LE NY).

; 1.3.6:
* Preware now supports installation of application package files (.ipk files) directly from URLs, email attachments, and local files.
* Also supported are Send to Preware links on homebrew application gallery and news websites (this requires the Neato! application to also be installed).
* If Preware continually asks you about file associations on every single launch, even after you have answered Yes to the questions it asks, then you may have a damaged file association table and will need to run the Emergency MimeTable Reset tool and then reboot to repair it.

; 1.3.5:
* Updated German translations.

; 1.3.3:
* Always ask the user before modifying the file association list.
* Updated French translations.

; 1.3.1:
* Check whether Preware is the default application for handling packages, and advise the user if it is not.

; 1.3.0:
* Added Preware to the Default Applications list to allow for installing packages from email messages and the browser.

; 1.2.9:
* Fixed the Saved Package List swipe to delete bug.

; 1.2.8:
* Open the My Applications app catalog screen when multiple app catalog applications need updating.

; 1.2.7
* Fixed the Install Package problem when running on the emulator.

; 1.2.6
* Remove most of the curl download progress messages from the ipkg log (this fixes a buffer overrun crash).

; 1.2.5
* Added Ask At Launch option to update preference.
* Added Blacklist support.
* German Translation updates.
* Fixed update banner problem.
* Fixed package with too many dependent packages problem.

; 1.2.4
* Added support for MinWebOSVersion, DeviceCompatibility and PreActionMessage package attributes.

; 1.2.3
* Enable the Install Package feature to also work for incorrectly formatted filenames.

; 1.2.1
* Robustified the Install Package feature - will now run post-install scripts for all correctly formatted filenames (packageid_version_arch.ipk).

; 1.2.0
* Added Install Package functionality, allowing installation of packages from URLs and local files.
* Moved Saved Package List from the main screen to the app menu.

; 1.1.7
* Added support for Kernel Modules.

; 1.1.5
* Use a gentler reboot procedure to allow open files to be flushed to disk.

; 1.1.4
* Fixed hang on package download failures.

; 1.1.2
* Added support for the ENABLE_TESTING_FEEDS Meta-Doctor feature.
* Removed the tag line about eventually reaching 1.0.
* Minor French translation updates, courtesy of Yannick LE NY.

; 1.1.1
* Added languages field in package descriptions.
* Added preference to only show packages with English descriptions.

; 1.1.0
* Now defaults (selectable by a preference option) to using an alternative installation method to avoid the webOS 1.4 rescan bug which closes and stops notifications from your phone, email and messaging applications.
* Updated German and French translations.
* Fixed deletion of disabled feeds.
* Added service version number to the ipkgservice API. Robustified the service upgrade process.

; 1.0.0
* The Package Manager Service has been rewritten in C and incorporated into this single Preware package.
* Installing Preware 1.0.0 will remove the Package Manager Service as the last step of the upgrade process.

 

== Repository ==
Preware and the Package Manager Service are housed in the applications/preware git repository at http://git.webos-internals.org/

For more information getting your application published in the WebOS Internals Source Code Repositories, please see the [[WebOS Internals Source Code Repositories]] page. For commit permission to the open source project, contact rwhitby on #webos-internals or email [mailto:support@webos-internals.org support@webos-internals.org]

Application:Preware

2011-06-29T03:04:43Z

JayCanuck: updated for wosqi 4.2.0

[[Category:Application]]
This page is currently available in four languages:
:[[Image:Australia.png]] [[Image:USA.png]] [[Application:Preware]]
:[[Image:France.png]] [[Application:Preware-FR]]
:[[Image:Germany.png]] [[Application:Preware-DE]]
:[[Image:China.png]] [[Application:Preware-ZH]]

{{application
|name=Preware
|type=webOS
|version=Version: 1.6.3 (8 June 2011)
|tag=Utilities
|screenshot=Preware_ss1.png
|description=
}}

 
=Summary=

[[image:Icon_Preware.png|frameless|left]]
Preware is a package management application for the Palm Pre and the Palm Pixi. Preware allows the user to install any package from any of the open standard package repositories on preware.org (or any other location that hosts an open standard package repository). Preware relies on a custom written service developed from community research which allows the mojo app to talk to the built-in ipkg tool.

'''Preware requires webOS 1.4.0 or later to function. Do not try to install it on earlier webOS versions, it will not work.'''

This application was the result of extensive community-based design in [[IPKG Service]] and [[Preware Design]].

For application management, Preware can access more applications, and has more features, than any other on-device package installer.

And since it is open source, and has a completely open development process supported by a team of world-class WebOS Internals developers, it will continue to get better much faster than any other package management application.

Preware is the open application installer that has been written specifically to support a homebrew ecosystem where any developer can upload any application to any submission site, and that application can then be installed by any user. Developers no longer need to upload their applications to multiple submission sites, and users are no longer excluded from accessing applications from any open standard package repository.

 
===Key Features===
Install / Remove / Update:
*Homebrew Applications including advanced applications with special requirements.
*WebOS Themes
*Patches
*webOS Kernels
*Support for installation of signed packages

 
===Status===
Preware has been upgraded to release status, and is no longer considered beta.

Some milestones worth mentioning in Preware's history include:

* Since 27 August 2009 it is the only over-the-air installer for the palm capable of installing advanced palm applications such as the [[On_Screen_Keyboard|On Screen Keyboard]] or the terminal application.
* Since 27 August 2009 it is the only application supporting installation from all existing palm homebrew feeds.
* Since 17 September 2009 it also supports installation of themes.
* Since 8 October 2009 it also supports installation of webOS patches.
* Since 12 Jan 2010 it also supports all Palm App Catalog feeds.
* Since 3 May 2010 it also supports installation of webOS custom kernels.
* Since 20 July 2010 it also supports installation of packages from URLs and local files.
* Since 24 July 2010 is also supports blacklisting packages and authors.
* Since 8 June 2011 access to webOS app catalog feeds is no longer available to third party developers or applications.

 
===License===
Please be aware that org.webosinternals.preware is licensed under the [http://www.gnu.org/licenses/gpl-2.0.html GPLv2].

Code from Preware cannot be used by a closed source application. If you want to use them in a non-GPLv2 but otherwise open source application, please contact the [mailto:support@webos-internals.org authors].

 
=Installing Preware=

There are four supported methods for installing Preware: Official HP/Palm SDK, WebOS Quick Install, Stand Alone Installers, and Command Line.

You do not need to access the Linux command line or "root your Pre" to install or use Preware.

You ''cannot'' use fileCoaster, or PreLoad, or PreUpdate to install or update Preware. Those tools are unable to operate correctly on advanced homebrew packages.

If you are a developer who uses the Palm emulator, you should know that Preware works just as well on the Emulator as it does on a real device, and is installed in exactly the same way.

 
===Installing Preware using the Official HP/Palm SDK===

To install Preware on any webOS device, the following procedure is recommended if you're having problems with WebOS Quick Install:

# Install the latest official Palm webOS SDK from http://developer.palm.com
# '''Disconnect your device''' (I repeat, do not have your device connected, no cables in the device, device not even anywhere near the computer), and run the latest webOS Doctor to install or upgrade your Novacom drivers
# Close the doctor
# Your phone should remain disconnected
# Download the latest Preware package onto your computer from http://get.preware.org/
## To install Preware on a phone, download the 'arm' .ipk file
## To install Preware on an emulator, download the 'i686' .ipk file
# Typing webos20090606, select the developer mode icon that will appears, and verify that your phone is in developer mode
# Connect your device to your computers USB port, and select 'Just Charge'
# Use palm-install to install the package you downloaded
## Typically you can simply get a command line, navigate to the directory with the Preware package you downloaded, then type palm-install and.the.package.arm.name.ipk

 

===Installing Preware with WebOS Quick Install===
You can use version 4.1.1 or later of [http://forums.precentral.net/canuck-coding/274461-webos-quick-install-v4-1-1-a.html WebOS Quick Install] to install Preware on any device easily and quickly, without the need to download a big 200MB SDK and webOSDoctor.

'''Latest Version of WebOS Quick Install available here: [http://forums.precentral.net/canuck-coding/274461-webos-quick-install-v4-1-1-a.html WebOS Quick Install v4.2.0]'''

# Install the required Software
## [http://www.java.com/en/download/installed.jsp?detect=jre&try=1 Click here] to verify that you have the latest java installed on your computer and update if needed
## [http://dl.dropbox.com/u/2774158/WebOSQuickInstall-4.2.0.jar Click Here] to download WebOS Quick Install v4.2.0
# Put your device in [[Getting started|Developer Mode]]
# Connect your device to your computer with the USB cable, and select "Just Charge" (do not select USB Drive)
# Run WebOS Quick Install. If the novacom driver is not installed, WebOS Quick Install will download and install that for you.
## '''Do not believe any guide that says you need to download the SDK or webOSDoctor for WOSQI to run.''' The most you'll download is the novacom driver, which is only 11MB on Windows, and will be done via WOSQI.
# Click the third button on the right (the globe icon)
# Select the Applications tab at the top
# Search for Preware
# Click Install.

 

===Installing Preware with the Standalone Installer===
Preware installers can be downloaded here: [http://get.preware.org Preware Standalone Installers]. These instructions are currently only for Mac and PC users.

# Install the required software.
## [http://www.java.com/en/download/installed.jsp?detect=jre&try=1 Click here] to verify that you have the latest version of Java installed on your computer and update it if needed.
## [http://www.webos-internals.org/wiki/Webos_Doctor_Versions Click here] to download the current webOS Doctor for your carrier and phone in a subdirectory you will remember (maybe "Palm"?). If you already have it, skip this step.
##* '''Do not run the webOS Doctor.'''
# Put your device into [[Getting started|Developer Mode]].
#* '''Windows users:''' When connecting your device to the computer for the first time, you will be prompted to install new hardware. Click Next to start the device installation. You may get a message regarding Novacom drivers not being installed. If so, you can disregard it. Once your device is installed, proceed with the Preware installation.
# Download the [http://get.preware.org/ Preware Standalone Installer] (you should choose the latest file name PrewareInstaller-X.Y.Z.jar) and place it in the same directory as the webOS Doctor .jar file.
# Run the Preware Installer.
# Click on the Tools menu and choose Install Drivers. This will install the Palm Novacom drivers for webOS devices.
# Once the drivers have finished installing, click on Install Preware. After Preware is installed, your device will be unresponsive for a few seconds while Luna restarts.

 
===Installing Preware from the Commandline===
If you have access to the command line of your webOS Device or emulator using Terminal, Novaterm, the "Linux Commandline" in WebOS Quick Install, or other techniques, you can install Preware by typing three lines. This technique is always the shortest and in many ways the simplest, but if you are in any way unsure of operating at the Linux command line, please use either of the methods described above.

<source lang="bash">
cd /tmp
wget http://bit.ly/preware-bootstrap
sh preware-bootstrap</source>

 
===Updating Preware===
To update Preware, just run Preware and select "Package Updates" from the main scene. If an update to Preware is available, it will appear in the list. Then select the "Update" button. Preware will close automatically after the update is complete.

Note that you cannot use fileCoaster, or PreLoad, or PreUpdate to install or update Preware. Those tools are unable to operate correctly on advanced homebrew packages.

 

===Removing Preware===
''Why would you ever want to remove Preware?''

To remove Preware, hold the Orange button on your keypad and choose Preware from the Launcher. Choose Delete.

 

=Usage=

===Preferences===
{| Width="70%" VAlign="top"
|valign="top"|[[image:Preferences.png|160px|frameless|left|text-top]]
|valign="top"|You can select preferences in the top left corner of the Pre to bring up the preferences screen. On the Preferences screen you can specify the look of the application, the frequency that feeds are updated, and what Preware will show you by default.
 
{| style="color:black; background-color:#F9F9F9;border:1px outset;" cellpadding="3" cellspacing="0"
|TIP:
|-
|To make it easier to find things, set "Show Available Types" to yes. This will show separate categories (Applications/Themes/Patches/etc.) rather than show everything in one long list.
|}
|}
 

===Feed Management===
{| Width="70%" VAlign="top"
|valign="top"|[[image:Preware_feeds.png|160px|frameless|left|text-top]]
|valign="top"|In the preferences section on the top bar on the right side is a button that takes you to the feeds screen. On the feeds screen you can select which feeds are loaded and which ones are not. Simply select the on or off button for that feed. (If you are not interested in themes you can disable the two feeds for themes to speed up the updating of feeds) Preware comes with the following feeds by default (some are disabled by default, but are easily enabled if desired).

{| style="color:black; background-color:#FFFFE0;" cellpadding="3" cellspacing="0" Border="1"
|align="center" colspan="4" | '''Default Feeds'''
|-
|align="center" | [http://ipkg.preware.org/feeds/precentral/ PreCentral]
|-
|align="center" | [http://ipkg.preware.org/feeds/webos-internals/ WebOS Internals]
|align="center" | [http://ipkg.preware.org/feeds/optware/ Optware]
|align="center" | [http://ipkg.preware.org/feeds/webos-patches/ WebOS Patches]
|align="center" | [http://ipkg.preware.org/feeds/webos-kernels/ WebOS Kernels]
|-
|}
|}

{| style="color:black; background-color:#F9F9F9;border:1px outset;" VAlign="middle" cellpadding="3" cellspacing="0" Width="70%"
|align="center" | See [[Testing Feeds]] for detailed instructions on adding custom feeds.
|}
 

===Package Updates===
{| Width="70%" VAlign="top"
|valign="top"|[[image:UpdateFeeds.png|160px|frameless|left|text-top]]
|valign="top"|To update feeds, simply select "Update Feeds" from the Application Menu. Preware will download the package list information from your enabled feeds. After processing the data, you will be back at the main list of available items.
|}
 

===Installing Packages===
{| Width="70%" VAlign="top"
|valign="top"|[[image:SelectApp.png|160px|frameless|left|text-top]]
|valign="top"|There are a few ways to select and install a "package" (application/patch/theme/etc.). Using "List of Everything" would be the simplest.
#Find the package you want to install either by scrolling and tapping on it, or just start typing
#Tap the "Install" button that the bottom of the package's page to install.
|}
 

===Removing Packages===
{| Width="70%" VAlign="top"
|valign="top"|[[image:RemoveAppTap.png|160px|frameless|left|text-top]]
|valign="top"|Removing a package is just as easy.
#On the main screen, tap "Installed Packages", then the category of the package you want to remove
#Tap the Package you want to remove
#Tap the "Remove" button that the bottom of the package's page.
|}
 

===Blacklist (Category Filters)===
{| Width="70%" VAlign="top"
[[File:preware_2011-09-03_165038.png]]''' '''[[File:preware_2011-09-03_165049.png]]
|valign="top"|The Preware "Blacklist" is a tool used to hide packages (applications, patches, etc) that you do not want to see, such as mass-produced book apps or real estate apps. This tool can also be used to hide unavailable packages, such as patches that are not compatible with your current webOS version. Got to Preferences in Preware and scroll to the Blacklist section. You can add whatever filters you like to customize your Preware experience. To hide all apps from a particular Maintainer, choose a "Maintainer" filter with the package maintainer in the search field. To hide unavailable packages, choose a "Category" filter, with "Unavailable" in the search field.
 

{| style="color:black; background-color:#F9F9F9;border:1px outset;" cellpadding="3" cellspacing="0"



= Operating notes =

===Limitations===
No known limitations.

 
===Known bugs===
*When selecting a patch with dependencies, if you view those dependencies then install them, when Preware returns you to the original patch's screen it will still have the 'install' button showing even though it is installed successfully. Swiping back and returning will show the correct status.

*The Update All button can get confused if there are patches with complex dependencies. This will be fixed in a future version.

*If updates to App Catalog applications are pending, they will be silently skipped when using the Update All button.

*The Updates feature from the regular Palm Launcher, may claim that application updates are needed, and then when the user clicks Show Updates shows the App Catalog's installed applications, there are none shown that need updating. This isn't as expected. This is because an app that was previously only in Preware has now migrated to the Palm Catalog. Don't worry, your apps are up to date (with the possible exception of the one with the conflict.) This is not a bug in Preware per se' but an app version conflict because the app is in both the Palm Catalog and also in Homebrew. Notice that you don't need to remove Preware to install the app from the official catalog, but simply disable the feed in Preware then "update feeds" to refresh the list then it should install fine from the official app catalog.

 
=Changelog=
 
For those interested, the full Changelog can be [http://git.webos-internals.org/?p=applications/preware.git;a=tags found here]. Listed below is the Changelog since the 1.0 milestone.
 

;1.6.3:
* WebOS Internals has been formally notified by Richard Kerris (HP Vice President of Worldwide Developer Relations) that open access to the webOS app catalog feed (including the beta and web feeds) is no longer available to third party developers or applications. Please direct any questions about this decision (which is final and permanent) to HP, not to WebOS Internals.
* Removed all HP webOS app catalog feeds from new installations of Preware.

;1.6.2:
* Added the clock themes feed (disabled by default).

;1.6.0:
* webOS 2.x Just Type integration.
* Fixed package list ordering bug.
* Layout fixes for Pixi/Veer.

;1.5.9:
* Fixed parse errors resulting from packages with very large descriptions.
* Fixed problems with updates to app catalog apps.

;1.5.8:
* Moved blacklisting to feed load to speed up listing.
* Suggests a reload after changing the blacklist.
* Fixed homebrew feed/catalog feed same appid bug.

;1.5.7:
* Added check to make sure package has a title before trying to search it.

;1.5.6:
* Removed support for Visibility feed value - use a category filter to exclude Unavailable packages if desired.

;1.5.5:
* Added support for Visibility feed value.
* Fix display of screenshots from devices with a different resolution.
* Test fix for custom feed on network with no internet connection.
* Style updates for pre3 screen size.

;1.5.4:
* Updated French translations (courtesy of Clément).

;1.5.3:
* Reinstated banner notification of manual saved package list update.

;1.5.2:
* Check if package dates are actually dates.
* Removed banner notification of saved package list being saved.

;1.5.1:
* Added support for optware testing feeds.

;1.5.0:
* You must upgrade to this version for full webOS 2.0 compatibility.

;1.4.9:
* Better compatibility with unknown future webOS versions.

;1.4.8:

* Now calls the correct software manager updates screen on webOS 2.0.

; 1.4.7:
* Fixed update, install and remove status messages on webOS 2.0.

;1.4.6:
* New "App Catalog" theme preferences thanks to Garrett92C.
* Added support for "MaxWebOSVersion" in the feeds.

;1.4.5:
* Added support for identifying when running on a Pre 2 device.

;1.4.4:
* Updated the version check to support future webOS versions.

;1.4.2:
* Added Category as a blacklist option.

;1.4.1:
* Added a Changelog button to the Help scene.

;1.4.0:
* Added help to preferences scene.
* Fixed swipe-to-delete bug in blacklist.
* Updated Italian translations (courtesy of Darkmagister).
* Added "Get Info" button to package install scene.
* Added "Send" button to ipkg log scene.
* Fixed bug when loading large package descriptions.

;1.3.8:
* Updated French translations (courtesy of Yannick LE NY).

;1.3.6:
* Preware now supports installation of application package files (.ipk files) directly from URLs, email attachments, and local files.
* Also supported are Send to Preware links on homebrew application gallery and news websites (this requires the Neato! application to also be installed).
* If Preware continually asks you about file associations on every single launch, even after you have answered Yes to the questions it asks, then you may have a damaged file association table and will need to run the Emergency MimeTable Reset tool and then reboot to repair it.

;1.3.5:
* Updated German translations.

;1.3.3:
* Always ask the user before modifying the file association list.
* Updated French translations.

;1.3.1:
* Check whether Preware is the default application for handling packages, and advise the user if it is not.

;1.3.0:
* Added Preware to the Default Applications list to allow for installing packages from email messages and the browser.

;1.2.9:
* Fixed the Saved Package List swipe to delete bug.

;1.2.8:
* Open the My Applications app catalog screen when multiple app catalog applications need updating.

;1.2.7
* Fixed the Install Package problem when running on the emulator.

;1.2.6
* Remove most of the curl download progress messages from the ipkg log (this fixes a buffer overrun crash).

;1.2.5
* Added Ask At Launch option to update preference.
* Added Blacklist support.
* German Translation updates.
* Fixed update banner problem.
* Fixed package with too many dependent packages problem.

;1.2.4
* Added support for MinWebOSVersion, DeviceCompatibility and PreActionMessage package attributes.

;1.2.3
* Enable the Install Package feature to also work for incorrectly formatted filenames.

;1.2.1
* Robustified the Install Package feature - will now run post-install scripts for all correctly formatted filenames (packageid_version_arch.ipk).

;1.2.0
* Added Install Package functionality, allowing installation of packages from URLs and local files.
* Moved Saved Package List from the main screen to the app menu.

;1.1.7
* Added support for Kernel Modules.

;1.1.5
* Use a gentler reboot procedure to allow open files to be flushed to disk.

;1.1.4
* Fixed hang on package download failures.

;1.1.2
*Added support for the ENABLE_TESTING_FEEDS Meta-Doctor feature.
*Removed the tag line about eventually reaching 1.0.
*Minor French translation updates, courtesy of Yannick LE NY.

;1.1.1
*Added languages field in package descriptions.
*Added preference to only show packages with English descriptions.

;1.1.0
*Now defaults (selectable by a preference option) to using an alternative installation method to avoid the webOS 1.4 rescan bug which closes and stops notifications from your phone, email and messaging applications.
*Updated German and French translations.
*Fixed deletion of disabled feeds.
*Added service version number to the ipkgservice API. Robustified the service upgrade process.

;1.0.0
*The Package Manager Service has been rewritten in C and incorporated into this single Preware package.
*Installing Preware 1.0.0 will remove the Package Manager Service as the last step of the upgrade process.

 
=Repository=
Preware and the Package Manager Service are housed in the applications/preware git repository at http://git.webos-internals.org/

For more information getting your application published in the WebOS Internals Source Code Repositories, please see the [[WebOS Internals Source Code Repositories]] page. For commit permission to the open source project, contact rwhitby on #webos-internals or email [mailto:support@webos-internals.org support@webos-internals.org]

Application:Preware

2011-06-05T23:39:13Z

JayCanuck: fixed wosqi download url

[[Category:Application]]
This page is currently available in four languages:
:[[Image:Australia.png]] [[Image:USA.png]] [[Application:Preware]]
:[[Image:France.png]] [[Application:Preware-FR]]
:[[Image:Germany.png]] [[Application:Preware-DE]]
:[[Image:China.png]] [[Application:Preware-ZH]]

{{application
|name=Preware
|type=webOS
|version=Version: 1.5.0 (17 Dec 2010)
|tag=Utilities
|screenshot=Preware_ss1.png
|description=
}}

 
=Summary=

[[image:Icon_Preware.png|frameless|left]]
Preware is a package management application for the Palm Pre and the Palm Pixi. Preware allows the user to install any package from any of the open standard package repositories on preware.org (or any other location that hosts an open standard package repository). Preware relies on a custom written service developed from community research which allows the mojo app to talk to the built-in ipkg tool.

'''Preware requires webOS 1.4.0 or later to function. Do not try to install it on earlier webOS versions, it will not work.'''

This application was the result of extensive community-based design in [[IPKG Service]] and [[Preware Design]].

For application management, Preware can access more applications, and has more features, than any other on-device package installer.

And since it is open source, and has a completely open development process supported by a team of world-class WebOS Internals developers, it will continue to get better much faster than any other package management application.

Preware is the open application installer that has been written specifically to support a homebrew ecosystem where any developer can upload any application to any submission site, and that application can then be installed by any user. Developers no longer need to upload their applications to multiple submission sites, and users are no longer excluded from accessing applications from any open standard package repository.

 
===Key Features===
Install / Remove / Update:
*Homebrew Applications including advanced applications with special requirements.
*WebOS Themes
*Patches
*webOS Kernels
*Palm App Catalog Applications
*Support for installation of signed packages

 
===Status===
Preware has been upgraded to release status, and is no longer considered beta.

Some milestones worth mentioning in Preware's history include:

* Since 27 August 2009 it is the only over-the-air installer for the palm capable of installing advanced palm applications such as the [[On_Screen_Keyboard|On Screen Keyboard]] or the terminal application.
* Since 27 August 2009 it is the only application supporting installation from all existing palm homebrew feeds.
* Since 17 September 2009 it also supports installation of themes.
* Since 8 October 2009 it also supports installation of webOS patches.
* Since 12 Jan 2010 it also supports all Palm App Catalog feeds.
* Since 3 May 2010 it also supports installation of webOS custom kernels.
* Since 20 July 2010 it also supports installation of packages from URLs and local files.
* Since 24 July 2010 is also supports blacklisting packages and authors.

 
===License===
Please be aware that org.webosinternals.preware is licensed under the [http://www.gnu.org/licenses/gpl-2.0.html GPLv2].

Code from Preware cannot be used by a closed source application. If you want to use them in a non-GPLv2 but otherwise open source application, please contact the [mailto:support@webos-internals.org authors].

 
=Installing Preware=

There are four supported methods for installing Preware: Official HP/Palm SDK, WebOS Quick Install, Stand Alone Installers, and Command Line.

You do not need to access the Linux command line or "root your Pre" to install or use Preware.

You ''cannot'' use fileCoaster, or PreLoad, or PreUpdate to install or update Preware. Those tools are unable to operate correctly on advanced homebrew packages.

If you are a developer who uses the Palm emulator, you should know that Preware works just as well on the Emulator as it does on a real device, and is installed in exactly the same way.

 
===Installing Preware using the Official HP/Palm SDK===

To install Preware on any webOS device, the following procedure is recommended if you're having problems with WebOS Quick Install:

# Install the latest official Palm webOS SDK from http://developer.palm.com
# '''Disconnect your device''' (I repeat, do not have your device connected, no cables in the device, device not even anywhere near the computer), and run the latest webOS Doctor to install or upgrade your Novacom drivers
# Close the doctor
# Your phone should remain disconnected
# Download the latest Preware package onto your computer from http://get.preware.org/
## To install Preware on a phone, download the 'arm' .ipk file
## To install Preware on an emulator, download the 'i686' .ipk file
# Typing webos20090606, select the developer mode icon that will appears, and verify that your phone is in developer mode
# Connect your device to your computers USB port, and select 'Just Charge'
# Use palm-install to install the package you downloaded
## Typically you can simply get a command line, navigate to the directory with the Preware package you downloaded, then type palm-install and.the.package.arm.name.ipk

 

===Installing Preware with WebOS Quick Install===
You can use version 4.1.1 or later of [http://forums.precentral.net/canuck-coding/274461-webos-quick-install-v4-1-1-a.html WebOS Quick Install] to install Preware on any device easily and quickly, without the need to download a big 200MB SDK and webOSDoctor.

'''Latest Version of WebOS Quick Install available here: [http://forums.precentral.net/canuck-coding/274461-webos-quick-install-v4-1-1-a.html WebOS Quick Install v4.1.1]'''

# Install the required Software
## [http://www.java.com/en/download/installed.jsp?detect=jre&try=1 Click here] to verify that you have the latest java installed on your computer and update if needed
## [http://dl.dropbox.com/u/2774158/WebOSQuickInstall-4.1.1.jar Click Here] to download WebOS Quick Install v4.1.1
# Put your device in [[Getting started|Developer Mode]]
# Connect your device to your computer with the USB cable, and select "Just Charge" (do not select USB Drive)
# Run WebOS Quick Install. If the novacom driver is not installed, WebOS Quick Install will download and install that for you.
## '''Do not believe any guide that says you need to download the SDK or webOSDoctor for WOSQI to run.''' The most you'll download is the novacom driver, which is only 11MB on Windows, and will be done via WOSQI.
# Click the third button on the right (the globe icon)
# Select the Applications tab at the top
# Search for Preware
# Click Install.

 

===Installing Preware with the Standalone Installer===
Preware installers can be downloaded here: [http://get.preware.org Preware Standalone Installers]. These instructions are currently only for Mac and PC users.

# Install the required software.
## [http://www.java.com/en/download/installed.jsp?detect=jre&try=1 Click here] to verify that you have the latest version of Java installed on your computer and update it if needed.
## [http://www.webos-internals.org/wiki/Webos_Doctor_Versions Click here] to download the current webOS Doctor for your carrier and phone in a subdirectory you will remember (maybe "Palm"?). If you already have it, skip this step.
##* '''Do not run the webOS Doctor.'''
# Put your device into [[Getting started|Developer Mode]].
#* '''Windows users:''' When connecting your device to the computer for the first time, you will be prompted to install new hardware. Click Next to start the device installation. You may get a message regarding Novacom drivers not being installed. If so, you can disregard it. Once your device is installed, proceed with the Preware installation.
# Download the [http://get.preware.org/ Preware Standalone Installer] (you should choose the latest file name PrewareInstaller-X.Y.Z.jar) and place it in the same directory as the webOS Doctor .jar file.
# Run the Preware Installer.
# Click on the Tools menu and choose Install Drivers. This will install the Palm Novacom drivers for webOS devices.
# Once the drivers have finished installing, click on Install Preware. After Preware is installed, your device will be unresponsive for a few seconds while Luna restarts.

 
===Installing Preware from the Commandline===
If you have access to the command line of your webOS Device or emulator using Terminal, Novaterm, the "Linux Commandline" in WebOS Quick Install, or other techniques, you can install Preware by typing three lines. This technique is always the shortest and in many ways the simplest, but if you are in any way unsure of operating at the Linux command line, please use either of the methods described above.

<source lang="bash">
cd /tmp
wget http://bit.ly/preware-bootstrap
sh preware-bootstrap</source>

 
===Updating Preware===
To update Preware, just run Preware and select "Package Updates" from the main scene. If an update to Preware is available, it will appear in the list. Then select the "Update" button. Preware will close automatically after the update is complete.

Note that you cannot use fileCoaster, or PreLoad, or PreUpdate to install or update Preware. Those tools are unable to operate correctly on advanced homebrew packages.

 

===Removing Preware===
''Why would you ever want to remove Preware?''

To remove Preware, hold the Orange button on your keypad and choose Preware from the Launcher. Choose Delete.

 

=Usage=

===Preferences===
{| Width="70%" VAlign="top"
|valign="top"|[[image:Preferences.png|160px|frameless|left|text-top]]
|valign="top"|You can select preferences in the top left corner of the Pre to bring up the preferences screen. On the Preferences screen you can specify the look of the application, the frequency that feeds are updated, and what Preware will show you by default.
 
{| style="color:black; background-color:#F9F9F9;border:1px outset;" cellpadding="3" cellspacing="0"
|TIP:
|-
|To make it easier to find things, set "Show Available Types" to yes. This will show separate categories (Applications/Themes/Patches/etc.) rather than show everything in one long list.
|}
|}
 

===Feed Management===
{| Width="70%" VAlign="top"
|valign="top"|[[image:Preware_feeds.png|160px|frameless|left|text-top]]
|valign="top"|In the preferences section on the top bar on the right side is a button that takes you to the feeds screen. On the feeds screen you can select which feeds are loaded and which ones are not. Simply select the on or off button for that feed. (If you are not interested in themes you can disable the two feeds for themes to speed up the updating of feeds) Preware comes with the following feeds by default (some are disabled by default, but are easily enabled if desired).

{| style="color:black; background-color:#FFFFE0;" cellpadding="3" cellspacing="0" Border="1"
|align="center" colspan="4" | '''Default Feeds'''
|-
|align="center" | [http://ipkg.preware.org/feeds/palm-beta/ Palm Beta]
|align="center" | [http://ipkg.preware.org/feeds/palm-beta-updates Palm Beta Updates]
|align="center" | [http://ipkg.preware.org/feeds/palm-catalog/ Palm Catalog]
|align="center" | [http://ipkg.preware.org/feeds/palm-catalog-updates/ Palm Catalog Updates]
|-
|align="center" | [http://ipkg.preware.org/feeds/palm-web-updates/ Palm Web]
|align="center" | [http://ipkg.preware.org/feeds/palm-web-updates/ Palm Web Updates]
|align="center" | [http://ipkg.preware.org/feeds/precentral/ PreCentral]
|align="center" | [http://ipkg.preware.org/feeds/precentral-themes/ PreCentral Themes]
|-
|align="center" | [http://ipkg.preware.org/feeds/webos-internals/ WebOS Internals]
|align="center" | [http://ipkg.preware.org/feeds/optware/ Optware]
|align="center" | [http://ipkg.preware.org/feeds/webos-patches/ WebOS Patches]
|align="center" | [http://ipkg.preware.org/feeds/webos-kernels/ WebOS Kernels]
|-
|}
|}

{| style="color:black; background-color:#F9F9F9;border:1px outset;" VAlign="middle" cellpadding="3" cellspacing="0" Width="70%"
|align="center" | See [[Testing Feeds]] for detailed instructions on adding custom feeds.
|}
 

===Package Updates===
{| Width="70%" VAlign="top"
|valign="top"|[[image:UpdateFeeds.png|160px|frameless|left|text-top]]
|valign="top"|To update feeds, simply select "Update Feeds" from the Application Menu. Preware will download the package list information from your enabled feeds. After processing the data, you will be back at the main list of available items.
|}
 

===Installing Packages===
{| Width="70%" VAlign="top"
|valign="top"|[[image:SelectApp.png|160px|frameless|left|text-top]]
|valign="top"|There are a few ways to select and install a "package" (application/patch/theme/etc.). Using "List of Everything" would be the simplest.
#Find the package you want to install either by scrolling and tapping on it, or just start typing
#Tap the "Install" button that the bottom of the package's page to install.
|}
 

===Removing Packages===
{| Width="70%" VAlign="top"
|valign="top"|[[image:RemoveAppTap.png|160px|frameless|left|text-top]]
|valign="top"|Removing a package is just as easy.
#On the main screen, tap "Installed Packages", then the category of the package you want to remove
#Tap the Package you want to remove
#Tap the "Remove" button that the bottom of the package's page.
|}
 

===Blacklist (Category Filters)===
{| Width="70%" VAlign="top"
[[File:preware_2011-09-03_165038.png]]''' '''[[File:preware_2011-09-03_165049.png]]
|valign="top"|The Preware "Blacklist" is a tool used to hide packages (applications, patches, etc) that you do not want to see, such as mass-produced book apps or real estate apps. This tool can also be used to hide unavailable packages, such as patches that are not compatible with your current webOS version. Got to Preferences in Preware and scroll to the Blacklist section. You can add whatever filters you like to customize your Preware experience. To hide all apps from a particular Maintainer, choose a "Maintainer" filter with the package maintainer in the search field. To hide unavailable packages, choose a "Category" filter, with "Unavailable" in the search field.
 

{| style="color:black; background-color:#F9F9F9;border:1px outset;" cellpadding="3" cellspacing="0"



= Operating notes =

===Limitations===
No known limitations.

 
===Known bugs===
*When selecting a patch with dependencies, if you view those dependencies then install them, when Preware returns you to the original patch's screen it will still have the 'install' button showing even though it is installed successfully. Swiping back and returning will show the correct status.

*The Update All button can get confused if there are patches with complex dependencies. This will be fixed in a future version.

*If updates to App Catalog applications are pending, they will be silently skipped when using the Update All button.

*The Updates feature from the regular Palm Launcher, may claim that application updates are needed, and then when the user clicks Show Updates shows the App Catalog's installed applications, there are none shown that need updating. This isn't as expected. This is because an app that was previously only in Preware has now migrated to the Palm Catalog. Don't worry, your apps are up to date (with the possible exception of the one with the conflict.) This is not a bug in Preware per se' but an app version conflict because the app is in both the Palm Catalog and also in Homebrew. Notice that you don't need to remove Preware to install the app from the official catalog, but simply disable the feed in Preware then "update feeds" to refresh the list then it should install fine from the official app catalog.

 
=Changelog=
 
For those interested, the full Changelog can be [http://git.webos-internals.org/?p=applications/preware.git;a=tags found here]. Listed below is the Changelog since the 1.0 milestone.
 

;1.5.0:
* You must upgrade to this version for full webOS 2.0 compatibility.

;1.4.9:
* Better compatibility with unknown future webOS versions.

;1.4.8:

* Now calls the correct software manager updates screen on webOS 2.0.

; 1.4.7:
* Fixed update, install and remove status messages on webOS 2.0.

;1.4.6:
* New "App Catalog" theme preferences thanks to Garrett92C.
* Added support for "MaxWebOSVersion" in the feeds.

;1.4.5:
* Added support for identifying when running on a Pre 2 device.

;1.4.4:
* Updated the version check to support future webOS versions.

;1.4.2:
* Added Category as a blacklist option.

;1.4.1:
* Added a Changelog button to the Help scene.

;1.4.0:
* Added help to preferences scene.
* Fixed swipe-to-delete bug in blacklist.
* Updated Italian translations (courtesy of Darkmagister).
* Added "Get Info" button to package install scene.
* Added "Send" button to ipkg log scene.
* Fixed bug when loading large package descriptions.

;1.3.8:
* Updated French translations (courtesy of Yannick LE NY).

;1.3.6:
* Preware now supports installation of application package files (.ipk files) directly from URLs, email attachments, and local files.
* Also supported are Send to Preware links on homebrew application gallery and news websites (this requires the Neato! application to also be installed).
* If Preware continually asks you about file associations on every single launch, even after you have answered Yes to the questions it asks, then you may have a damaged file association table and will need to run the Emergency MimeTable Reset tool and then reboot to repair it.

;1.3.5:
* Updated German translations.

;1.3.3:
* Always ask the user before modifying the file association list.
* Updated French translations.

;1.3.1:
* Check whether Preware is the default application for handling packages, and advise the user if it is not.

;1.3.0:
* Added Preware to the Default Applications list to allow for installing packages from email messages and the browser.

;1.2.9:
* Fixed the Saved Package List swipe to delete bug.

;1.2.8:
* Open the My Applications app catalog screen when multiple app catalog applications need updating.

;1.2.7
* Fixed the Install Package problem when running on the emulator.

;1.2.6
* Remove most of the curl download progress messages from the ipkg log (this fixes a buffer overrun crash).

;1.2.5
* Added Ask At Launch option to update preference.
* Added Blacklist support.
* German Translation updates.
* Fixed update banner problem.
* Fixed package with too many dependent packages problem.

;1.2.4
* Added support for MinWebOSVersion, DeviceCompatibility and PreActionMessage package attributes.

;1.2.3
* Enable the Install Package feature to also work for incorrectly formatted filenames.

;1.2.1
* Robustified the Install Package feature - will now run post-install scripts for all correctly formatted filenames (packageid_version_arch.ipk).

;1.2.0
* Added Install Package functionality, allowing installation of packages from URLs and local files.
* Moved Saved Package List from the main screen to the app menu.

;1.1.7
* Added support for Kernel Modules.

;1.1.5
* Use a gentler reboot procedure to allow open files to be flushed to disk.

;1.1.4
* Fixed hang on package download failures.

;1.1.2
*Added support for the ENABLE_TESTING_FEEDS Meta-Doctor feature.
*Removed the tag line about eventually reaching 1.0.
*Minor French translation updates, courtesy of Yannick LE NY.

;1.1.1
*Added languages field in package descriptions.
*Added preference to only show packages with English descriptions.

;1.1.0
*Now defaults (selectable by a preference option) to using an alternative installation method to avoid the webOS 1.4 rescan bug which closes and stops notifications from your phone, email and messaging applications.
*Updated German and French translations.
*Fixed deletion of disabled feeds.
*Added service version number to the ipkgservice API. Robustified the service upgrade process.

;1.0.0
*The Package Manager Service has been rewritten in C and incorporated into this single Preware package.
*Installing Preware 1.0.0 will remove the Package Manager Service as the last step of the upgrade process.

 
=Repository=
Preware and the Package Manager Service are housed in the applications/preware git repository at http://git.webos-internals.org/

For more information getting your application published in the WebOS Internals Source Code Repositories, please see the [[WebOS Internals Source Code Repositories]] page. For commit permission to the open source project, contact rwhitby on #webos-internals or email [mailto:support@webos-internals.org support@webos-internals.org]

Application:Preware

2011-06-05T17:35:40Z

JayCanuck: Installing Preware with WebOS Quick Install update

[[Category:Application]]
This page is currently available in four languages:
:[[Image:Australia.png]] [[Image:USA.png]] [[Application:Preware]]
:[[Image:France.png]] [[Application:Preware-FR]]
:[[Image:Germany.png]] [[Application:Preware-DE]]
:[[Image:China.png]] [[Application:Preware-ZH]]

{{application
|name=Preware
|type=webOS
|version=Version: 1.5.0 (17 Dec 2010)
|tag=Utilities
|screenshot=Preware_ss1.png
|description=
}}

 
=Summary=

[[image:Icon_Preware.png|frameless|left]]
Preware is a package management application for the Palm Pre and the Palm Pixi. Preware allows the user to install any package from any of the open standard package repositories on preware.org (or any other location that hosts an open standard package repository). Preware relies on a custom written service developed from community research which allows the mojo app to talk to the built-in ipkg tool.

'''Preware requires webOS 1.4.0 or later to function. Do not try to install it on earlier webOS versions, it will not work.'''

This application was the result of extensive community-based design in [[IPKG Service]] and [[Preware Design]].

For application management, Preware can access more applications, and has more features, than any other on-device package installer.

And since it is open source, and has a completely open development process supported by a team of world-class WebOS Internals developers, it will continue to get better much faster than any other package management application.

Preware is the open application installer that has been written specifically to support a homebrew ecosystem where any developer can upload any application to any submission site, and that application can then be installed by any user. Developers no longer need to upload their applications to multiple submission sites, and users are no longer excluded from accessing applications from any open standard package repository.

 
===Key Features===
Install / Remove / Update:
*Homebrew Applications including advanced applications with special requirements.
*WebOS Themes
*Patches
*webOS Kernels
*Palm App Catalog Applications
*Support for installation of signed packages

 
===Status===
Preware has been upgraded to release status, and is no longer considered beta.

Some milestones worth mentioning in Preware's history include:

* Since 27 August 2009 it is the only over-the-air installer for the palm capable of installing advanced palm applications such as the [[On_Screen_Keyboard|On Screen Keyboard]] or the terminal application.
* Since 27 August 2009 it is the only application supporting installation from all existing palm homebrew feeds.
* Since 17 September 2009 it also supports installation of themes.
* Since 8 October 2009 it also supports installation of webOS patches.
* Since 12 Jan 2010 it also supports all Palm App Catalog feeds.
* Since 3 May 2010 it also supports installation of webOS custom kernels.
* Since 20 July 2010 it also supports installation of packages from URLs and local files.
* Since 24 July 2010 is also supports blacklisting packages and authors.

 
===License===
Please be aware that org.webosinternals.preware is licensed under the [http://www.gnu.org/licenses/gpl-2.0.html GPLv2].

Code from Preware cannot be used by a closed source application. If you want to use them in a non-GPLv2 but otherwise open source application, please contact the [mailto:support@webos-internals.org authors].

 
=Installing Preware=

There are four supported methods for installing Preware: Official HP/Palm SDK, WebOS Quick Install, Stand Alone Installers, and Command Line.

You do not need to access the Linux command line or "root your Pre" to install or use Preware.

You ''cannot'' use fileCoaster, or PreLoad, or PreUpdate to install or update Preware. Those tools are unable to operate correctly on advanced homebrew packages.

If you are a developer who uses the Palm emulator, you should know that Preware works just as well on the Emulator as it does on a real device, and is installed in exactly the same way.

 
===Installing Preware using the Official HP/Palm SDK===

To install Preware on any webOS device, the following procedure is recommended if you're having problems with WebOS Quick Install:

# Install the latest official Palm webOS SDK from http://developer.palm.com
# '''Disconnect your device''' (I repeat, do not have your device connected, no cables in the device, device not even anywhere near the computer), and run the latest webOS Doctor to install or upgrade your Novacom drivers
# Close the doctor
# Your phone should remain disconnected
# Download the latest Preware package onto your computer from http://get.preware.org/
## To install Preware on a phone, download the 'arm' .ipk file
## To install Preware on an emulator, download the 'i686' .ipk file
# Typing webos20090606, select the developer mode icon that will appears, and verify that your phone is in developer mode
# Connect your device to your computers USB port, and select 'Just Charge'
# Use palm-install to install the package you downloaded
## Typically you can simply get a command line, navigate to the directory with the Preware package you downloaded, then type palm-install and.the.package.arm.name.ipk

 

===Installing Preware with WebOS Quick Install===
You can use version 4.1.1 or later of [http://forums.precentral.net/canuck-coding/274461-webos-quick-install-v4-1-1-a.html WebOS Quick Install] to install Preware on any device easily and quickly, without the need to download a big 200MB SDK and weboSDoctor.

'''Latest Version of WebOS Quick Install available here: [http://forums.precentral.net/canuck-coding/274461-webos-quick-install-v4-1-1-a.html WebOS Quick Install v4.1.1]'''

# Install the required Software
## [http://www.java.com/en/download/installed.jsp?detect=jre&try=1 Click here] to verify that you have the latest java installed on your computer and update if needed
## [http://images.precentral.net/sites/precentral.net/files/webos-homebrew-apps/wosqi/WebOSQuickInstall.jar Click Here] to download the latest version of WebOS Quick Install
# Put your device in [[Getting started|Developer Mode]]
# Connect your device to your computer with the USB cable, and select "Just Charge" (do not select USB Drive)
# Run WebOS Quick Install. If the novacom driver is not installed, WebOS Quick Install will download and install that for you.
## '''Do not believe any guide that says you need to download the SDK or webOSDoctor for WOSQI to run.''' The most you'll download is the novacom driver, which is only 11MB on Windows, and will be done via WOSQI.
# Click the third button on the right (the globe icon)
# Select the Applications tab at the top
# Search for Preware
# Click Install.

 

===Installing Preware with the Standalone Installer===
Preware installers can be downloaded here: [http://get.preware.org Preware Standalone Installers]. These instructions are currently only for Mac and PC users.

# Install the required software.
## [http://www.java.com/en/download/installed.jsp?detect=jre&try=1 Click here] to verify that you have the latest version of Java installed on your computer and update it if needed.
## [http://www.webos-internals.org/wiki/Webos_Doctor_Versions Click here] to download the current webOS Doctor for your carrier and phone in a subdirectory you will remember (maybe "Palm"?). If you already have it, skip this step.
##* '''Do not run the webOS Doctor.'''
# Put your device into [[Getting started|Developer Mode]].
#* '''Windows users:''' When connecting your device to the computer for the first time, you will be prompted to install new hardware. Click Next to start the device installation. You may get a message regarding Novacom drivers not being installed. If so, you can disregard it. Once your device is installed, proceed with the Preware installation.
# Download the [http://get.preware.org/ Preware Standalone Installer] (you should choose the latest file name PrewareInstaller-X.Y.Z.jar) and place it in the same directory as the webOS Doctor .jar file.
# Run the Preware Installer.
# Click on the Tools menu and choose Install Drivers. This will install the Palm Novacom drivers for webOS devices.
# Once the drivers have finished installing, click on Install Preware. After Preware is installed, your device will be unresponsive for a few seconds while Luna restarts.

 
===Installing Preware from the Commandline===
If you have access to the command line of your webOS Device or emulator using Terminal, Novaterm, the "Linux Commandline" in WebOS Quick Install, or other techniques, you can install Preware by typing three lines. This technique is always the shortest and in many ways the simplest, but if you are in any way unsure of operating at the Linux command line, please use either of the methods described above.

<source lang="bash">
cd /tmp
wget http://bit.ly/preware-bootstrap
sh preware-bootstrap</source>

 
===Updating Preware===
To update Preware, just run Preware and select "Package Updates" from the main scene. If an update to Preware is available, it will appear in the list. Then select the "Update" button. Preware will close automatically after the update is complete.

Note that you cannot use fileCoaster, or PreLoad, or PreUpdate to install or update Preware. Those tools are unable to operate correctly on advanced homebrew packages.

 

===Removing Preware===
''Why would you ever want to remove Preware?''

To remove Preware, hold the Orange button on your keypad and choose Preware from the Launcher. Choose Delete.

 

=Usage=

===Preferences===
{| Width="70%" VAlign="top"
|valign="top"|[[image:Preferences.png|160px|frameless|left|text-top]]
|valign="top"|You can select preferences in the top left corner of the Pre to bring up the preferences screen. On the Preferences screen you can specify the look of the application, the frequency that feeds are updated, and what Preware will show you by default.
 
{| style="color:black; background-color:#F9F9F9;border:1px outset;" cellpadding="3" cellspacing="0"
|TIP:
|-
|To make it easier to find things, set "Show Available Types" to yes. This will show separate categories (Applications/Themes/Patches/etc.) rather than show everything in one long list.
|}
|}
 

===Feed Management===
{| Width="70%" VAlign="top"
|valign="top"|[[image:Preware_feeds.png|160px|frameless|left|text-top]]
|valign="top"|In the preferences section on the top bar on the right side is a button that takes you to the feeds screen. On the feeds screen you can select which feeds are loaded and which ones are not. Simply select the on or off button for that feed. (If you are not interested in themes you can disable the two feeds for themes to speed up the updating of feeds) Preware comes with the following feeds by default (some are disabled by default, but are easily enabled if desired).

{| style="color:black; background-color:#FFFFE0;" cellpadding="3" cellspacing="0" Border="1"
|align="center" colspan="4" | '''Default Feeds'''
|-
|align="center" | [http://ipkg.preware.org/feeds/palm-beta/ Palm Beta]
|align="center" | [http://ipkg.preware.org/feeds/palm-beta-updates Palm Beta Updates]
|align="center" | [http://ipkg.preware.org/feeds/palm-catalog/ Palm Catalog]
|align="center" | [http://ipkg.preware.org/feeds/palm-catalog-updates/ Palm Catalog Updates]
|-
|align="center" | [http://ipkg.preware.org/feeds/palm-web-updates/ Palm Web]
|align="center" | [http://ipkg.preware.org/feeds/palm-web-updates/ Palm Web Updates]
|align="center" | [http://ipkg.preware.org/feeds/precentral/ PreCentral]
|align="center" | [http://ipkg.preware.org/feeds/precentral-themes/ PreCentral Themes]
|-
|align="center" | [http://ipkg.preware.org/feeds/webos-internals/ WebOS Internals]
|align="center" | [http://ipkg.preware.org/feeds/optware/ Optware]
|align="center" | [http://ipkg.preware.org/feeds/webos-patches/ WebOS Patches]
|align="center" | [http://ipkg.preware.org/feeds/webos-kernels/ WebOS Kernels]
|-
|}
|}

{| style="color:black; background-color:#F9F9F9;border:1px outset;" VAlign="middle" cellpadding="3" cellspacing="0" Width="70%"
|align="center" | See [[Testing Feeds]] for detailed instructions on adding custom feeds.
|}
 

===Package Updates===
{| Width="70%" VAlign="top"
|valign="top"|[[image:UpdateFeeds.png|160px|frameless|left|text-top]]
|valign="top"|To update feeds, simply select "Update Feeds" from the Application Menu. Preware will download the package list information from your enabled feeds. After processing the data, you will be back at the main list of available items.
|}
 

===Installing Packages===
{| Width="70%" VAlign="top"
|valign="top"|[[image:SelectApp.png|160px|frameless|left|text-top]]
|valign="top"|There are a few ways to select and install a "package" (application/patch/theme/etc.). Using "List of Everything" would be the simplest.
#Find the package you want to install either by scrolling and tapping on it, or just start typing
#Tap the "Install" button that the bottom of the package's page to install.
|}
 

===Removing Packages===
{| Width="70%" VAlign="top"
|valign="top"|[[image:RemoveAppTap.png|160px|frameless|left|text-top]]
|valign="top"|Removing a package is just as easy.
#On the main screen, tap "Installed Packages", then the category of the package you want to remove
#Tap the Package you want to remove
#Tap the "Remove" button that the bottom of the package's page.
|}
 

===Blacklist (Category Filters)===
{| Width="70%" VAlign="top"
[[File:preware_2011-09-03_165038.png]]''' '''[[File:preware_2011-09-03_165049.png]]
|valign="top"|The Preware "Blacklist" is a tool used to hide packages (applications, patches, etc) that you do not want to see, such as mass-produced book apps or real estate apps. This tool can also be used to hide unavailable packages, such as patches that are not compatible with your current webOS version. Got to Preferences in Preware and scroll to the Blacklist section. You can add whatever filters you like to customize your Preware experience. To hide all apps from a particular Maintainer, choose a "Maintainer" filter with the package maintainer in the search field. To hide unavailable packages, choose a "Category" filter, with "Unavailable" in the search field.
 

{| style="color:black; background-color:#F9F9F9;border:1px outset;" cellpadding="3" cellspacing="0"



= Operating notes =

===Limitations===
No known limitations.

 
===Known bugs===
*When selecting a patch with dependencies, if you view those dependencies then install them, when Preware returns you to the original patch's screen it will still have the 'install' button showing even though it is installed successfully. Swiping back and returning will show the correct status.

*The Update All button can get confused if there are patches with complex dependencies. This will be fixed in a future version.

*If updates to App Catalog applications are pending, they will be silently skipped when using the Update All button.

*The Updates feature from the regular Palm Launcher, may claim that application updates are needed, and then when the user clicks Show Updates shows the App Catalog's installed applications, there are none shown that need updating. This isn't as expected. This is because an app that was previously only in Preware has now migrated to the Palm Catalog. Don't worry, your apps are up to date (with the possible exception of the one with the conflict.) This is not a bug in Preware per se' but an app version conflict because the app is in both the Palm Catalog and also in Homebrew. Notice that you don't need to remove Preware to install the app from the official catalog, but simply disable the feed in Preware then "update feeds" to refresh the list then it should install fine from the official app catalog.

 
=Changelog=
 
For those interested, the full Changelog can be [http://git.webos-internals.org/?p=applications/preware.git;a=tags found here]. Listed below is the Changelog since the 1.0 milestone.
 

;1.5.0:
* You must upgrade to this version for full webOS 2.0 compatibility.

;1.4.9:
* Better compatibility with unknown future webOS versions.

;1.4.8:

* Now calls the correct software manager updates screen on webOS 2.0.

; 1.4.7:
* Fixed update, install and remove status messages on webOS 2.0.

;1.4.6:
* New "App Catalog" theme preferences thanks to Garrett92C.
* Added support for "MaxWebOSVersion" in the feeds.

;1.4.5:
* Added support for identifying when running on a Pre 2 device.

;1.4.4:
* Updated the version check to support future webOS versions.

;1.4.2:
* Added Category as a blacklist option.

;1.4.1:
* Added a Changelog button to the Help scene.

;1.4.0:
* Added help to preferences scene.
* Fixed swipe-to-delete bug in blacklist.
* Updated Italian translations (courtesy of Darkmagister).
* Added "Get Info" button to package install scene.
* Added "Send" button to ipkg log scene.
* Fixed bug when loading large package descriptions.

;1.3.8:
* Updated French translations (courtesy of Yannick LE NY).

;1.3.6:
* Preware now supports installation of application package files (.ipk files) directly from URLs, email attachments, and local files.
* Also supported are Send to Preware links on homebrew application gallery and news websites (this requires the Neato! application to also be installed).
* If Preware continually asks you about file associations on every single launch, even after you have answered Yes to the questions it asks, then you may have a damaged file association table and will need to run the Emergency MimeTable Reset tool and then reboot to repair it.

;1.3.5:
* Updated German translations.

;1.3.3:
* Always ask the user before modifying the file association list.
* Updated French translations.

;1.3.1:
* Check whether Preware is the default application for handling packages, and advise the user if it is not.

;1.3.0:
* Added Preware to the Default Applications list to allow for installing packages from email messages and the browser.

;1.2.9:
* Fixed the Saved Package List swipe to delete bug.

;1.2.8:
* Open the My Applications app catalog screen when multiple app catalog applications need updating.

;1.2.7
* Fixed the Install Package problem when running on the emulator.

;1.2.6
* Remove most of the curl download progress messages from the ipkg log (this fixes a buffer overrun crash).

;1.2.5
* Added Ask At Launch option to update preference.
* Added Blacklist support.
* German Translation updates.
* Fixed update banner problem.
* Fixed package with too many dependent packages problem.

;1.2.4
* Added support for MinWebOSVersion, DeviceCompatibility and PreActionMessage package attributes.

;1.2.3
* Enable the Install Package feature to also work for incorrectly formatted filenames.

;1.2.1
* Robustified the Install Package feature - will now run post-install scripts for all correctly formatted filenames (packageid_version_arch.ipk).

;1.2.0
* Added Install Package functionality, allowing installation of packages from URLs and local files.
* Moved Saved Package List from the main screen to the app menu.

;1.1.7
* Added support for Kernel Modules.

;1.1.5
* Use a gentler reboot procedure to allow open files to be flushed to disk.

;1.1.4
* Fixed hang on package download failures.

;1.1.2
*Added support for the ENABLE_TESTING_FEEDS Meta-Doctor feature.
*Removed the tag line about eventually reaching 1.0.
*Minor French translation updates, courtesy of Yannick LE NY.

;1.1.1
*Added languages field in package descriptions.
*Added preference to only show packages with English descriptions.

;1.1.0
*Now defaults (selectable by a preference option) to using an alternative installation method to avoid the webOS 1.4 rescan bug which closes and stops notifications from your phone, email and messaging applications.
*Updated German and French translations.
*Fixed deletion of disabled feeds.
*Added service version number to the ipkgservice API. Robustified the service upgrade process.

;1.0.0
*The Package Manager Service has been rewritten in C and incorporated into this single Preware package.
*Installing Preware 1.0.0 will remove the Package Manager Service as the last step of the upgrade process.

 
=Repository=
Preware and the Package Manager Service are housed in the applications/preware git repository at http://git.webos-internals.org/

For more information getting your application published in the WebOS Internals Source Code Repositories, please see the [[WebOS Internals Source Code Repositories]] page. For commit permission to the open source project, contact rwhitby on #webos-internals or email [mailto:support@webos-internals.org support@webos-internals.org]

WebOS 2 Upgrade

2011-02-24T18:08:43Z

JayCanuck: Added mention of the easier method of installing Adobe Flash

= Overview =
With the release of the webOS 2.1.0 doctor by HP for O2 and Vodafone Pre+ devices, there is now a legal way to get webOS 2.1 onto the legacy devices of carriers that are not onboard with the 2.x upgrade. Compatible devices include all Pre and Pre Plus devices. This is not compatible with Pixi devices.

= Disclaimer =
'''This is a process that uses official HP software in unofficial ways. You should always be prepared for the unlikely possibility that your device may be completely wiped and your palm profile may be permanently destroyed. Do not proceed unless you have made appropriate backups and are OK with that. Working knowledge of MetaDoctor and Linux systems in general is needed.'''

= Video Overview =
''Pre|Central'' forum user @malpha recorded a two-part video overview of the process as she followed this step-by-step. The videos can be found [http://www.youtube.com/watch?v=CJB8NJ72kZg here].

= Using MetaDoctor Scripts =

Note: Scripts currently exist for the following devices:
* Sprint Pre
* Verizon Pre+
* AT&T Pre+
* "WR" devices
* Telcel Pre
* Bell Mobility Pre

== Step 0: Backup your device ==
Make sure you have copies of all the data that you want to preserve from your palm profile. There is a possibility that you will need to clear your palm profile to be successful in this upgrade, so you should act as if that is going to happen from the start.

Also, make sure you run the Save/Restore application from Preware to back up your application data - you don't want to lose your Angry Birds progress, do you?

Then copy all the files from the USB drive onto your PC to keep them safe. The webOS Doctor has been known to wipe your USB drive without warning, so you should act as if that is going to happen from the start.

A guide for backing up using Save/Restore can be found [http://www.precentral.net/backing-your-application-data-settings-save-restore-homebrew here].
== Step 1: Install Prerequisites ==
* '''MetaDoctor''' - see [[Application:MetaDoctor]] for information on how to install MetaDoctor
* '''Palm SDK ''' - see [http://developer.palm.com/index.php?option=com_content&view=article&layout=page&id=1661 Palm Developer Website]

== Step 2: Prepare your Palm Profile ==
With unsupported carrier/device/OS combinations, it may be necessary to clear some Palm Profile data to allow you to sign in on webOS 2.x devices. The process is as follows:
'''Warning: this will delete data from your Palm Profile, including but not limited to: calendars, contacts, account information, bookmarks, memos, tasks, SSM/MMS messages, and icon/launcher arrangement.'''
# Open the Backup app.
# Turn off backups, confirming that you wish to erase your palm profile information.
== Step 3: Run device-specific MetaDoctor script ==
The MetaDoctor scripts will automatically download the latest necessary webOS doctors, will extract and replace radio firmwares as necessary (for CDMA phones), and will build and launch the modified doctor. Run the script in the meta-doctor/scripts folder that corresponds to your device. Example:
<pre><nowiki>
./scripts/meta-sprint-pre-2.1.0
</nowiki></pre>

== Step 4: Run the modified webOS Doctor ==
The meta-script will automatically launch the modified webOS Doctor for you. However, if you need to move it to a different location and run it manually, the modified doctor will be located in the build output directory (e.g. meta-doctor/build/preplus-p101ueude-wr-2.1.0/webosdoctorp101ueude-wr-2.1.0.jar for the meta-sprint-pre-2.1.0 script - look for a similar directory which matches the script you ran). Run this like you would a normal webOS doctor.

== Step 5: Restore /etc/palm-build-info ==
If the meta-script left a palm-build-info-unmasqed file in your working directory, then after you log into your profile you need to copy this file back onto your device:
<pre><nowiki>
novacom run file://usr/sbin/rootfs_open -t
novacom put file://etc/palm-build-info < palm-build-info-unmasqed
novacom run file://sbin/reboot
</nowiki></pre>

== Step 6: Donate to WebOS Internals and purchase the Preware Homebrew Documentation app ==
If this worked for you, we would appreciate a donation at http://donate.webos-internals.org - and if you want to thank Rod Whitby personally for the many hours that he put into creating the Meta-Doctor and this upgrade procedure, you should purchase the Preware Homebrew Documentation app from the official app catalog, and leave a nice 5 star review containing your message of thanks.

= Caveats =
== App Catalog ==
* Apps that are marked as only compatible with webOS versions 2.x and above do not currently work with some of these doctored installations of webOS 2.1.0. On some of the devices/carriers, masquerading is used which leads to the Palm profile still reporting version 1.40.50.

== Masquerading ==
* Palm's servers only accept certain device/OS combinations as valid. While ROW Pre and Pre Plus devices running 2.1 are accepted, Pre and Pre Plus devices running on Sprint, Verizon and AT&T have to masquerade as still running webOS 1.4.5. To achieve this, /etc/palm-build-info is replaced with the version from the 1.4.5 doctor to trick Palm's servers into believing it is a valid device/OS combination and allowing app catalog access. Once app catalog access is achieved, /etc/palm-build-info can be replaced with the 2.1 version which is found in meta-doctor/palm-build-info-unmasqed on the computer you built the doctor with.

== Carrier-Specific Applications ==
* Carrier specific apps such as Sprint Navigation and the Verizon hotspot app are not included.
== Palm Profile ==
* Some people have had problems signing in to existing Palm Profiles on 2.1 due to backup data. To make sure that you can sign in to your profile on 2.1, you should disable backups before doctoring to 2.1 and delete server side backups. Of course, this deletes most of the data in your Palm Profile (memos, tasks, calender entries, accounts, ...). Your apps will be restored on 2.1, but that is about it. Note that not all people have issues with backups. If you would rather not delete your Palm Profile data, you can try doctoring to 2.1 without turning backups off and see if restoring everything works. If it doesn't, you'll have to doctor back to 1.4.5 to turn off backups or use a new Palm Profile, though.

==GPS==
* To enable GPS functionality it may be necessary to go to the "Location Services" application, make sure that "GPS", and "GPS Location Services" are enabled. Test the GPS using ##477# (##GPS#) from the phone application, and press the "Get Fix" button.
* If neither ##477# utility nor Google Maps is able to successfully fix your position, return to the "Location Services" application, open the ''Preferences'' menu, expand ''Locate Me Using...'' and ensure that both '''GPS''' and '''Google Services''' are selected. After selecting '''Google Services''', you will be prompted to accept the Terms of Service. Once both options are selected, test GPS functionality again. The ##477# utility may still fail the first several times, but should complete successfully after repeated attempts, and should continue to function normally thereafter.

== Flash ==
* Adobe Flash is not included in this webOS 2.1 doctor, but can be added with files from a VZW Pre2 2.01 doctor.

=== Adding Flash Support (Easy Method) ===
The easiest way to get flash on your webOS 2.1.0 legacy device is via creating a modular package and installing tat, along with a patch to make the Adobe Flash preferences visible in the browser.

It sounds complex, but it much easier overall and [http://tinyurl.com/flash-webos-2-1-0 a How-To has been detailed here]

=== Adding Flash Support Manually ===
1. Extract WebOS.tar from the Resources folder in the VZW doctor to a location on your hard drive 
2. Copy the following files from the extracted WebOS.tar to their equivalent locations in your MetaDoctor (alternatively, you can copy them manually to a live device using Novaterm)
<blockquote>/etc/adobe/mms.cfg
 /etc/adobe/oem.cfg
 /usr/lib/BrowserServerPlugins/libflashplayer.so
 /usr/lib/BrowserServerPlugins/resource/plugin-icon-noplay.png
 /usr/lib/BrowserServerPlugins/resource/plugin-icon-play-down.png
 /usr/lib/BrowserServerPlugins/resource/plugin-icon-play.png
 /usr/lib/BrowserServerPlugins/resource/plugin-icon-unknown.png
 /usr/lib/BrowserServerPlugins/resource/plugin-scrim.png
 /usr/lib/libFlashGraphics.so
 /usr/lib/BrowserServerPlugins/FlashMiniAdapterData/plugin-icon-noplay.png
 /usr/lib/BrowserServerPlugins/FlashMiniAdapterData/plugin-icon-play.png
 /usr/lib/BrowserServerPlugins/FlashMiniAdapterData/plugin-icon-unknown.png
 /usr/lib/BrowserServerPlugins/FlashMiniAdapterData/plugin-scrim.png
 /usr/lib/BrowserServerPlugins/FlashMiniPlugin.so</blockquote>
3. Open /usr/palm/applications/com.palm.app.browser/app/controllers/preferences-assistant.js (either in your MetaDoctor or on your live device -if on a live device, remember to make a backup!)
 Find the following two lines (should be lines 46 & 47) and comment them out by adding // to the beginning of each line:
<blockquote>this.controller.get("flashPref").hide();
 this.controller.get("autoLoadPref").hide(); </blockquote>
4. Reboot your Pre if the editing was done on a live device

Flash preferences should now be visible under browser preferences.

Auto-Update Patch Technology

2010-02-12T22:02:37Z

JayCanuck: /* WebOS Quick Install */

== Introduction ==
Auto-Update Patch Technology (AUPT) is the existing patching technology found in all homebrew patches in the webos-patches feed. AUPT is built into the installation and removal scripts of patches and allows patches to be installed/removed even after faulty installs, partial or full erases, webos doctors and even OTA updates to new WebOS versions!

There is also a concept of placeholder patches in the webos-patches feeds. All patches will at least build a dummy package with version ending in -0. These dummy packages may be installed to serve as a placeholder so that when they are ported to the new webOS version you will see the Update available in Preware. This will be useful to know when a patch has been ported to the new webOS version after an OTA update without having to check the forums every so often.

All patch installations and removals will now log to /media/internal/webos-patches.log and should be examined for detailed information with regards to any patch installation or removal failures.

== Installation ==
Always install patches with Preware or webOS Quick Install v3.01 or later.

== Verification ==
You may wish to verify that all of your installed patches were indeed installed with AUPT built in and that there are no left-over older or incompatible patches installed. In order to do this, you can open the text file .webosinternals.patches.packages found in USB mode from your PC. Each package should contain "aupt-N" indicating the version of aupt built into that patch. If there are ANY lines in that file that contain nothing after the package name that indicates an old incompatible technology was built into that patch. '''Remove these packages immediately and re-install''' (see: Installation section)

== Re-installation and Upgrades ==
There are various scenarios you may find yourself in where a patch may be installed or uninstalled. We will discuss what to do after each of these situations.

=== webOS Doctor ===

The webOS Doctor is a great way to ensure you are running completely stock Palm webOS files in the root filesystem. There are 3 situations you can be in with patches installed after WebOS Doctor.

* If you used a doctor version that is a PRIOR webOS version than the one that was running when you installed the Patches, install "Emergency Patch Recovery" (EPR) to wipe the device of the patch package information. There are no supported downgrade automatic patch installations.

* If you used a doctor version that is the SAME webOS version as the one that was used to install the Patches, simply install "Emergency Service Enabler" (ESE) to re-apply all of your installed patches.

* If you used a doctor version that is a LATER webOS version than the one that was running when you installed the Patches, use Preware's Update All feature. Launch Preware, Update Feeds, tap Package updates and tap update all.

=== Partial/Full Erase ===
All of your homebrew and App Catalog packages as well as all media data including pictures survive a webOS Doctor and sometimes it is desired to wipe clean the media partition or remove all packages. The situation may arise where you needed to do a partial or full erase without doctoring the device. If you perform a partial or full erase while patches are installed, this will only remove the package data that lists these patches as installed in Preware and webOS Quick Install. The patches will still be applied to Palm's WebOS files. There is not yet a supported method to recover the patch package data. For now it is recommended to clean up all the patches via one of the following methods. These methods are listed in order of robustness. '''The only -guaranteed- way to ensure stock Palm webOS files is by using the webOS doctor: [[Webos Doctor Versions]]'''

* Install "Emergency Patch Recovery" (EPR)
* webOS Repair Utility
* webOS Doctor

AUPT patches are built with smart post-install scripts that are able to detect when a patch is already applied to the stock webOS files. If you remember all the patches you had installed before the partial/full erase you may simply re-install each Patch individually as usual (Preware or QI v3.01 or later)

=== OTA Update ===
==== Preware ====
In the past it was recommended and required to remove all patches prior to updating webOS Over The Air (OTA). The new AUPT system makes this unnecessary and allows you to leave patches installed and then update them all after an OTA update to a new version of webOS. After a webOS OTA update you may use Preware's Update All feature. After an OTA update perform the following steps:

* Launch Preware
* Tap application menu -> Update Feeds
* Tap Package Updates
* Tap Update All.

(SEE: Known Issues section for known roadbumps in Preware's Update All function with regards to patches)

==== WebOS Quick Install ====
WebOS Quick Install is fully compatible with webOS-Internals Auto-Update Patch Technology (AUPT). When you enter the Tweaks section, after a webOS update, WebOS Quick Install will detect the version change and will open an update helper.

For on-feed patches , the update helper will update out-of-date patches to the new version's equivalent (or a dummy package if an updated patch has not yet been released).

For [http://forums.precentral.net/canuck-software/210767-how-install-patch-files-wosqi.html .patch files installed with WebOS Quick Install], the update helper will uninstall them. It will also check to see if the patch can be successfully re-applied. If it can be re-applied, the patch will be reinstalled.

== Submissions ==
Submit all patches to be included into the webos-patches feed found in Preware and webOS Quick Install to: http://patches.webos-internals.org/

== AUPT Versions ==
* aupt-1: First implementation
* aupt-2: Re-ordered logic in prerm to check for OTA first before trying to -R the patch

All versions are fully compatible with each other

== Known Issues ==
=== Preware ===
There are some known bumps in Preware's update-all with regards to patches, but no major roadblocks. The known issues and workarounds for them are:

* It will stop when trying to update a dependent package. The workaround here is to remove patches that depend on another patch or package that has an update. For instance the uscl memos patch depends on universal command line patch. The update all will fail when it gets to these patches, and you can workaround that by removing the uscl memos patch and then re-running update all.
* When the "install" part of the remove/install update process for a patch fails, Preware's installed list doesn't refresh automatically so the failed patch still lists on the update screen as installed. You can workaround this by updating feeds or tapping "remove" on the left-over package in Preware.

=== Miscellaneous ===
There are rare circumstances where a collection of patches in the same category may have to be installed/removed in a certain order and may fail (safely) to install or remove in different orders.

== Known Conflicts ==
* Greg's great Messaging Plugins solution contains a patch to the messaging application that has yet to be incorporated with AUPT. This may cause conflicts with some messaging patches causing installation to fail and should -always- be removed prior to a webOS OTA update.
* Themes have yet to be incorporated into AUPT and may cause conflicts with patches. Themes should also -always- be removed prior to a webOS OTA update.

== Troubleshooting ==
Patching is by nature a very ugly beast. There are bound to be unforeseen issues and difficult to debug situations. In the end you can always get back to a completely stock webOS by performing a full erase followed by a webOS doctor. Here we will list some known problems and workarounds.

== Emergency ==
In the event that you find yourself in an unsupported situation with regards to patching or simply want to ensure a clean slate of stock Palm WebOS files without any patches, the following is the only guaranteed method:

* Backup / take not of any homebrew packages installed as well as any App Catalog applications that are not backed up via your Palm Profile
* Go into device info -> reset -> Partial Erase to erase all applications.
* Perform webOS Doctor to ensure all Palm webOS files are stock.

You may also try the quick solution of installing "Emergency Patch Recovery" (EPR). Please note that this relies on information that patches saved/stored and is not a robust or guaranteed way to ensure patches are completely removed. It is very safe and works a vast majority of the time as intended, it simply is not guaranteed to clean up everything.

Auto-Update Patch Technology

2010-02-12T22:02:04Z

JayCanuck: /* OTA Update */

== Introduction ==
Auto-Update Patch Technology (AUPT) is the existing patching technology found in all homebrew patches in the webos-patches feed. AUPT is built into the installation and removal scripts of patches and allows patches to be installed/removed even after faulty installs, partial or full erases, webos doctors and even OTA updates to new WebOS versions!

There is also a concept of placeholder patches in the webos-patches feeds. All patches will at least build a dummy package with version ending in -0. These dummy packages may be installed to serve as a placeholder so that when they are ported to the new webOS version you will see the Update available in Preware. This will be useful to know when a patch has been ported to the new webOS version after an OTA update without having to check the forums every so often.

All patch installations and removals will now log to /media/internal/webos-patches.log and should be examined for detailed information with regards to any patch installation or removal failures.

== Installation ==
Always install patches with Preware or webOS Quick Install v3.01 or later.

== Verification ==
You may wish to verify that all of your installed patches were indeed installed with AUPT built in and that there are no left-over older or incompatible patches installed. In order to do this, you can open the text file .webosinternals.patches.packages found in USB mode from your PC. Each package should contain "aupt-N" indicating the version of aupt built into that patch. If there are ANY lines in that file that contain nothing after the package name that indicates an old incompatible technology was built into that patch. '''Remove these packages immediately and re-install''' (see: Installation section)

== Re-installation and Upgrades ==
There are various scenarios you may find yourself in where a patch may be installed or uninstalled. We will discuss what to do after each of these situations.

=== webOS Doctor ===

The webOS Doctor is a great way to ensure you are running completely stock Palm webOS files in the root filesystem. There are 3 situations you can be in with patches installed after WebOS Doctor.

* If you used a doctor version that is a PRIOR webOS version than the one that was running when you installed the Patches, install "Emergency Patch Recovery" (EPR) to wipe the device of the patch package information. There are no supported downgrade automatic patch installations.

* If you used a doctor version that is the SAME webOS version as the one that was used to install the Patches, simply install "Emergency Service Enabler" (ESE) to re-apply all of your installed patches.

* If you used a doctor version that is a LATER webOS version than the one that was running when you installed the Patches, use Preware's Update All feature. Launch Preware, Update Feeds, tap Package updates and tap update all.

=== Partial/Full Erase ===
All of your homebrew and App Catalog packages as well as all media data including pictures survive a webOS Doctor and sometimes it is desired to wipe clean the media partition or remove all packages. The situation may arise where you needed to do a partial or full erase without doctoring the device. If you perform a partial or full erase while patches are installed, this will only remove the package data that lists these patches as installed in Preware and webOS Quick Install. The patches will still be applied to Palm's WebOS files. There is not yet a supported method to recover the patch package data. For now it is recommended to clean up all the patches via one of the following methods. These methods are listed in order of robustness. '''The only -guaranteed- way to ensure stock Palm webOS files is by using the webOS doctor: [[Webos Doctor Versions]]'''

* Install "Emergency Patch Recovery" (EPR)
* webOS Repair Utility
* webOS Doctor

AUPT patches are built with smart post-install scripts that are able to detect when a patch is already applied to the stock webOS files. If you remember all the patches you had installed before the partial/full erase you may simply re-install each Patch individually as usual (Preware or QI v3.01 or later)

=== OTA Update ===
==== Preware ====
In the past it was recommended and required to remove all patches prior to updating webOS Over The Air (OTA). The new AUPT system makes this unnecessary and allows you to leave patches installed and then update them all after an OTA update to a new version of webOS. After a webOS OTA update you may use Preware's Update All feature. After an OTA update perform the following steps:

* Launch Preware
* Tap application menu -> Update Feeds
* Tap Package Updates
* Tap Update All.

(SEE: Known Issues section for known roadbumps in Preware's Update All function with regards to patches)

==== WebOS Quick Install ====
WebOS Quick Install is fully compatible with webOS-Internals Auto-Update Patch Technology (AUPT). When you enter the Tweaks section, after a webOS update, WebOS Quick Install will detect the version change and will open an update helper.

For on-feed patches , the update helper will update out-of-date patches to the new version's equivalent (or a dummy package if an updated patch has not yet been released).

For [http://forums.precentral.net/canuck-software/210767-how-install-patch-files-wosqi.html| .patch files installed with WebOS Quick Install], the update helper will uninstall them. It will also check to see if the patch can be successfully re-applied. If it can be re-applied, the patch will be reinstalled.

== Submissions ==
Submit all patches to be included into the webos-patches feed found in Preware and webOS Quick Install to: http://patches.webos-internals.org/

== AUPT Versions ==
* aupt-1: First implementation
* aupt-2: Re-ordered logic in prerm to check for OTA first before trying to -R the patch

All versions are fully compatible with each other

== Known Issues ==
=== Preware ===
There are some known bumps in Preware's update-all with regards to patches, but no major roadblocks. The known issues and workarounds for them are:

* It will stop when trying to update a dependent package. The workaround here is to remove patches that depend on another patch or package that has an update. For instance the uscl memos patch depends on universal command line patch. The update all will fail when it gets to these patches, and you can workaround that by removing the uscl memos patch and then re-running update all.
* When the "install" part of the remove/install update process for a patch fails, Preware's installed list doesn't refresh automatically so the failed patch still lists on the update screen as installed. You can workaround this by updating feeds or tapping "remove" on the left-over package in Preware.

=== Miscellaneous ===
There are rare circumstances where a collection of patches in the same category may have to be installed/removed in a certain order and may fail (safely) to install or remove in different orders.

== Known Conflicts ==
* Greg's great Messaging Plugins solution contains a patch to the messaging application that has yet to be incorporated with AUPT. This may cause conflicts with some messaging patches causing installation to fail and should -always- be removed prior to a webOS OTA update.
* Themes have yet to be incorporated into AUPT and may cause conflicts with patches. Themes should also -always- be removed prior to a webOS OTA update.

== Troubleshooting ==
Patching is by nature a very ugly beast. There are bound to be unforeseen issues and difficult to debug situations. In the end you can always get back to a completely stock webOS by performing a full erase followed by a webOS doctor. Here we will list some known problems and workarounds.

== Emergency ==
In the event that you find yourself in an unsupported situation with regards to patching or simply want to ensure a clean slate of stock Palm WebOS files without any patches, the following is the only guaranteed method:

* Backup / take not of any homebrew packages installed as well as any App Catalog applications that are not backed up via your Palm Profile
* Go into device info -> reset -> Partial Erase to erase all applications.
* Perform webOS Doctor to ensure all Palm webOS files are stock.

You may also try the quick solution of installing "Emergency Patch Recovery" (EPR). Please note that this relies on information that patches saved/stored and is not a robust or guaranteed way to ensure patches are completely removed. It is very safe and works a vast majority of the time as intended, it simply is not guaranteed to clean up everything.

Auto-Update Patch Technology

2010-02-12T22:00:25Z

JayCanuck: /* OTA Update */

== Introduction ==
Auto-Update Patch Technology (AUPT) is the existing patching technology found in all homebrew patches in the webos-patches feed. AUPT is built into the installation and removal scripts of patches and allows patches to be installed/removed even after faulty installs, partial or full erases, webos doctors and even OTA updates to new WebOS versions!

There is also a concept of placeholder patches in the webos-patches feeds. All patches will at least build a dummy package with version ending in -0. These dummy packages may be installed to serve as a placeholder so that when they are ported to the new webOS version you will see the Update available in Preware. This will be useful to know when a patch has been ported to the new webOS version after an OTA update without having to check the forums every so often.

All patch installations and removals will now log to /media/internal/webos-patches.log and should be examined for detailed information with regards to any patch installation or removal failures.

== Installation ==
Always install patches with Preware or webOS Quick Install v3.01 or later.

== Verification ==
You may wish to verify that all of your installed patches were indeed installed with AUPT built in and that there are no left-over older or incompatible patches installed. In order to do this, you can open the text file .webosinternals.patches.packages found in USB mode from your PC. Each package should contain "aupt-N" indicating the version of aupt built into that patch. If there are ANY lines in that file that contain nothing after the package name that indicates an old incompatible technology was built into that patch. '''Remove these packages immediately and re-install''' (see: Installation section)

== Re-installation and Upgrades ==
There are various scenarios you may find yourself in where a patch may be installed or uninstalled. We will discuss what to do after each of these situations.

=== webOS Doctor ===

The webOS Doctor is a great way to ensure you are running completely stock Palm webOS files in the root filesystem. There are 3 situations you can be in with patches installed after WebOS Doctor.

* If you used a doctor version that is a PRIOR webOS version than the one that was running when you installed the Patches, install "Emergency Patch Recovery" (EPR) to wipe the device of the patch package information. There are no supported downgrade automatic patch installations.

* If you used a doctor version that is the SAME webOS version as the one that was used to install the Patches, simply install "Emergency Service Enabler" (ESE) to re-apply all of your installed patches.

* If you used a doctor version that is a LATER webOS version than the one that was running when you installed the Patches, use Preware's Update All feature. Launch Preware, Update Feeds, tap Package updates and tap update all.

=== Partial/Full Erase ===
All of your homebrew and App Catalog packages as well as all media data including pictures survive a webOS Doctor and sometimes it is desired to wipe clean the media partition or remove all packages. The situation may arise where you needed to do a partial or full erase without doctoring the device. If you perform a partial or full erase while patches are installed, this will only remove the package data that lists these patches as installed in Preware and webOS Quick Install. The patches will still be applied to Palm's WebOS files. There is not yet a supported method to recover the patch package data. For now it is recommended to clean up all the patches via one of the following methods. These methods are listed in order of robustness. '''The only -guaranteed- way to ensure stock Palm webOS files is by using the webOS doctor: [[Webos Doctor Versions]]'''

* Install "Emergency Patch Recovery" (EPR)
* webOS Repair Utility
* webOS Doctor

AUPT patches are built with smart post-install scripts that are able to detect when a patch is already applied to the stock webOS files. If you remember all the patches you had installed before the partial/full erase you may simply re-install each Patch individually as usual (Preware or QI v3.01 or later)

=== OTA Update ===
'''Preware'''
In the past it was recommended and required to remove all patches prior to updating webOS Over The Air (OTA). The new AUPT system makes this unnecessary and allows you to leave patches installed and then update them all after an OTA update to a new version of webOS. After a webOS OTA update you may use Preware's Update All feature. After an OTA update perform the following steps:

* Launch Preware
* Tap application menu -> Update Feeds
* Tap Package Updates
* Tap Update All.

(SEE: Known Issues section for known roadbumps in Preware's Update All function with regards to patches)

'''WebOS Quick Install'''
WebOS Quick Install is fully compatible with webOS-Internals Auto-Update Patch Technology (AUPT). When you enter the Tweaks section, after a webOS update, WebOS Quick Install will detect the version change and will open an update helper.

For on-feed patches , the update helper will update out-of-date patches to the new version's equivalent (or a dummy package if an updated patch has not yet been released).

For [http://forums.precentral.net/canuck-software/210767-how-install-patch-files-wosqi.html|.patch files installed with WebOS Quick Install], the update helper will uninstall them. It will also check to see if the patch can be successfully re-applied. If it can be re-applied, the patch will be reinstalled.

== Submissions ==
Submit all patches to be included into the webos-patches feed found in Preware and webOS Quick Install to: http://patches.webos-internals.org/

== AUPT Versions ==
* aupt-1: First implementation
* aupt-2: Re-ordered logic in prerm to check for OTA first before trying to -R the patch

All versions are fully compatible with each other

== Known Issues ==
=== Preware ===
There are some known bumps in Preware's update-all with regards to patches, but no major roadblocks. The known issues and workarounds for them are:

* It will stop when trying to update a dependent package. The workaround here is to remove patches that depend on another patch or package that has an update. For instance the uscl memos patch depends on universal command line patch. The update all will fail when it gets to these patches, and you can workaround that by removing the uscl memos patch and then re-running update all.
* When the "install" part of the remove/install update process for a patch fails, Preware's installed list doesn't refresh automatically so the failed patch still lists on the update screen as installed. You can workaround this by updating feeds or tapping "remove" on the left-over package in Preware.

=== Miscellaneous ===
There are rare circumstances where a collection of patches in the same category may have to be installed/removed in a certain order and may fail (safely) to install or remove in different orders.

== Known Conflicts ==
* Greg's great Messaging Plugins solution contains a patch to the messaging application that has yet to be incorporated with AUPT. This may cause conflicts with some messaging patches causing installation to fail and should -always- be removed prior to a webOS OTA update.
* Themes have yet to be incorporated into AUPT and may cause conflicts with patches. Themes should also -always- be removed prior to a webOS OTA update.

== Troubleshooting ==
Patching is by nature a very ugly beast. There are bound to be unforeseen issues and difficult to debug situations. In the end you can always get back to a completely stock webOS by performing a full erase followed by a webOS doctor. Here we will list some known problems and workarounds.

== Emergency ==
In the event that you find yourself in an unsupported situation with regards to patching or simply want to ensure a clean slate of stock Palm WebOS files without any patches, the following is the only guaranteed method:

* Backup / take not of any homebrew packages installed as well as any App Catalog applications that are not backed up via your Palm Profile
* Go into device info -> reset -> Partial Erase to erase all applications.
* Perform webOS Doctor to ensure all Palm webOS files are stock.

You may also try the quick solution of installing "Emergency Patch Recovery" (EPR). Please note that this relies on information that patches saved/stored and is not a robust or guaranteed way to ensure patches are completely removed. It is very safe and works a vast majority of the time as intended, it simply is not guaranteed to clean up everything.

Application:Precorder

2009-11-24T08:02:18Z

JayCanuck:

{{application
|name=Precorder
|type=webOS
|version=Version: Alpha 0.2.0 (23 Nov 2009)
|tag=Utilities
|screenshot=Precorder_2009-24-11_164136.png
|description=

== Summary ==

Precorder has been developed to bridge the gap between the current revision of WebOS and a future release that will enable video recording. It is capable of recording in multiple combinations of audio and video and includes support for using the built-in LED for lumination while recording in dark areas. Video recorded with Precorder is viewable through Palms built in video application.

== Status ==

Precorder is ALPHA SOFTWARE!

==Installation==

=== WebOS Quick Install ===

Easiest installation method is by installing [http://ipkg.preware.org/feeds/webos-internals/testing/armv7/org.webosinternals.gstservice_0.2.3_armv7.ipk GstService] and [http://ipkg.preware.org/feeds/webos-internals/testing/all/org.webosinternals.precorder_0.2.0_all.ipk Precorder] with [http://www.webos-internals.org/wiki/Tutorials_webOS_Installing_An_Ipk#WebOS_Quick_Install_Method WebOS Quick Install].

# Save the gstservice and and Precorder ipk's to your local computer.
# Install [[Tutorials_webOS_Installing_An_Ipk#WebOS_Quick_Install_Method|WebOS Quick Install]]
# Drag the gstservice IPK into the center of the WebOS Quick install window.
# Click the Install button.
# Drag the Precorder application ipk into the center of the WebOS Quick Install window.
# Click the install button.

=== Command Line ===

Alternatively, you can install the .ipk files manually via commandline:
 
ipkg -o /var install http://ipkg.preware.org/feeds/webos-internals/testing/armv7/org.webosinternals.gstservice_0.2.3_armv7.ipk
 
ipkg -o /var install http://ipkg.preware.org/feeds/webos-internals/testing/all/org.webosinternals.precorder_0.2.0_all.ipk
 
 then run post install script:
 
sh /var/usr/lib/ipkg/info/org.webosinternals.gstservice.postinst

== License ==

== Operating notes ==

When precorder is first launched you will see the main screen. Only one button is currently functional. Tapping the 'Record Now' button will begin recording video to the /media/internal location on the pre making these videos available to be copied via USB. They will be located in the root of the USB drive when connected to your computer.

When you tap the 'Record Now' button the screen will change to notify you that Precorder is currently capturing audio and video. There is a 'Stop recording' button located on the screen. Tapping this button stops the audio/video capture and returns you to the main view.

There are several features of Precorder that can be customized. All of these settings are available via the preferences option within the Precorder menu. The table below lists all possible preferences. Options in bold represent defaults.

<Table><TR><TD>
{{{!}} border="1" cellpadding="4"
{{!}}Option
{{!}}Description
{{!}}Possible Selections
{{!}}-
{{!}}Audio Format
{{!}}Select what format you would like the audio stream to be saved in.
{{!}}'''AAC''', AMRNB, MP3
{{!}}-
{{!}}Video Format
{{!}}Select what format you would like the video stream to be saved in.
{{!}}Mpeg-4, H.263, '''H.264/AVC'''
{{!}}-
{{!}}Container
{{!}}Select what multimedia container the audio/video streams will be in.
{{!}}'''mp4''', 3gp
{{!}}-
{{!}}Media Source
{{!}}Would would you like Precorder to capture.
{{!}}Audio only, Video only, '''Both'''
{{!}}-
{{!}}Flash
{{!}}Would you like to use the built in LED for illumination
{{!}}'''Off''', On
{{!}}}
</TD></TR></Table>

=== Recent enhancements ===

Precorder has just been released for Alpha testing.

=== Known bugs ===

Precorder is currently in Alpha stages and as such is in a constant state of flux with new features being added and old functionality being modified. Please use this software at your own risk.

First run on any phone will cause a blank output. Simply start recording, wait a moment, and stop recording, wait a moment. After that, it should be fine. Getting the video light to work may cause 2 starts. Should be a 1-time-only process.

== Source Code ==

Source at git.webos-internals.org

Packages in the webos-internals testing feed

== Screenshots ==

[[Image:Precorder_2009-24-11_164136.png|alt=Precorder Main View|This is the initial view upon launching Precorder]]
[[Image:Precorder_2009-24-11_164140.png|alt=Precorder Recording View|This is the display during audio/video capture]]
[[Image:Precorder_2009-24-11_164128.png|alt=Precorder Preferences View|This is the preferences selection screen]]
[[Image:Launcher_2009-24-11_164206.png|alt=Palm OEM video app|All videos are viewable on the device via the Palm OEM video application]]

}}

Application:Precorder

2009-11-24T07:36:42Z

JayCanuck:

{{application
|name=Precorder
|type=webOS
|version=Version: Alpha 0.2.0 (23 Nov 2009)
|tag=Utilities
|screenshot=Precorder_2009-24-11_164136.png
|description=

== Summary ==

== Status ==

==Installation==

Easiest installation method is by installing [http://ipkg.preware.org/feeds/webos-internals/testing/armv7/org.webosinternals.gstservice_0.2.3_armv7.ipk GstService] and [http://ipkg.preware.org/feeds/webos-internals/testing/all/org.webosinternals.precorder_0.2.0_all.ipk Precorder] with [http://www.webos-internals.org/wiki/Tutorials_webOS_Installing_An_Ipk#WebOS_Quick_Install_Method WebOS Quick Install].

Alternatively, you can install the ipk files manually via commandline:
 
ipkg -o /var install http://ipkg.preware.org/feeds/webos-internals/testing/armv7/org.webosinternals.gstservice_0.2.3_armv7.ipk
 
ipkg -o /var install http://ipkg.preware.org/feeds/webos-internals/testing/all/org.webosinternals.precorder_0.2.0_all.ipk
 
# then run post install script
 
sh /var/usr/lib/ipkg/info/org.webosinternals.gstservice.postinst

== License ==

== Operating notes ==

=== Recent enhancements ===

=== Known bugs ===
First run on any phone will cause a blank output. Simply start recording, wait a moment, and stop recording, wait a moment. After that, it should be fine. Getting the video light to work may cause 2 starts. Should be a 1-time-only process.

== Source Code ==

Source at git.webos-internals.org

Packages in the webos-internals testing feed

== Screenshots ==

[[Image:Precorder_2009-24-11_164136.png]]
[[Image:Precorder_2009-24-11_164140.png]]
[[Image:Precorder_2009-24-11_164128.png]]
[[Image:Launcher_2009-24-11_164206.png]]

}}

Application:Precorder

2009-11-24T07:36:15Z

JayCanuck:

{{application
|name=Precorder
|type=webOS
|version=Version: Alpha 0.2.0 (23 Nov 2009)
|tag=Utilities
|screenshot=Precorder_2009-24-11_164136.png
|description=

== Summary ==

== Status ==

==Installation==

Easiest installation method is by installing [http://ipkg.preware.org/feeds/webos-internals/testing/armv7/org.webosinternals.gstservice_0.2.3_armv7.ipk GstService] and [http://ipkg.preware.org/feeds/webos-internals/testing/all/org.webosinternals.precorder_0.2.0_all.ipk Precorder] with [http://www.webos-internals.org/wiki/Tutorials_webOS_Installing_An_Ipk#WebOS_Quick_Install_Method WebOS Quick Install].

Alternatively, you can install the ipk files manually via commandline:
ipkg -o /var install http://ipkg.preware.org/feeds/webos-internals/testing/armv7/org.webosinternals.gstservice_0.2.3_armv7.ipk
 
ipkg -o /var install http://ipkg.preware.org/feeds/webos-internals/testing/all/org.webosinternals.precorder_0.2.0_all.ipk
 
# then run post install script
 
sh /var/usr/lib/ipkg/info/org.webosinternals.gstservice.postinst

== License ==

== Operating notes ==

=== Recent enhancements ===

=== Known bugs ===
First run on any phone will cause a blank output. Simply start recording, wait a moment, and stop recording, wait a moment. After that, it should be fine. Getting the video light to work may cause 2 starts. Should be a 1-time-only process.

== Source Code ==

Source at git.webos-internals.org

Packages in the webos-internals testing feed

== Screenshots ==

[[Image:Precorder_2009-24-11_164136.png]]
[[Image:Precorder_2009-24-11_164140.png]]
[[Image:Precorder_2009-24-11_164128.png]]
[[Image:Launcher_2009-24-11_164206.png]]

}}

WebOS Doctor Versions

2009-10-11T00:43:54Z

JayCanuck:

It seems the webOS Doctor jar files provided by Palm keep changing:

Sprint: http://palm.cdnetworks.net/rom/p121r0d10092009/sr1ntp121rod/webosdoctorp100ewwsprint.jar

Bell Mobility: http://palm.cdnetworks.net/rom/p121r0d10092009/b11ep121rod/webosdoctorp100ewwbellmo.jar

(see [[Sprint_vs_Bellmo_Doctor_Differences_1.1.0]])

Note that the webOS Doctor package comes with the following license:

RESTRICTIONS: The Software is licensed for use only with the single Palm device you originally purchased, and you may not distribute or make the Software available over a network or for use with multiple devices. The Software and supporting documentation may be copied only as necessary for backup or archive purposes in support of your use of the Software.

So we can't host different versions of it anywhere - the best we can do is record the md5sums of the versions we know about so that individuals can match this to the files they have for use with their Palm device.

Here is a list of the versions that we know about (with md5sums for each, and the date they were first spotted and recorded here):

Sprint:

4b3e396f8b1f1c5d3388e3c298af0484 webosdoctorp100ewwsprint-1.0.2.jar (10 June 2009)
0c8027b5a707eb0d02b1997d48021bd5 webosdoctorp100ewwsprint-1.0.3.jar (24 June 2009) (changes in [[WebOS_Doctor_version_1.0.3]])
32852c4b57d938e85f0fc819e57eacb7 webosdoctorp100ewwsprint-1.0.4.jar (9 July 2009) (changes in [[WebOS_Doctor_version_1.0.4]])
fc602490fdd7b3be8c5f727349c6195f webosdoctorp100ewwsprint-1.1.0.jar (24 July 2009) (changes in [[WebOS_Doctor_version_1.1.0]])
3123efda0a40821bd03daf1dd11cf2e3 webosdoctorp100ewwsprint-1.2.0-0830.jar (4 Sep 2009 - accidentally released early) (changes in [[WebOS_Doctor_version_1.2.0-0830]])
93c3f106b7a7e5ef572465dcb4488e1c webosdoctorp100ewwsprint-1.2.0.jar (29 September 2009)
e7600251e12e5b96f3143138ba61b9eb webosdoctorp100ewwsprint-1.2.1.jar (10 October 2009)

Bell Mobility:

ffd1bc50066d8f54d134b7aac194e3ec webosdoctorp100ewwbellmo-1.1.0.jar (27 August 2009)
c8f80b3cdbb9b96fd73bbb6062950a83 webosdoctorp100ewwbellmo-1.2.0.jar (29 September 2009)
52f4a4cd9b182004a7060cfaa5be2c6f webosdoctorp100ewwbellmo-1.2.1.jar (10 October 2009)

WebOS Doctor Versions

2009-10-10T23:26:03Z

JayCanuck:

It seems the webOS Doctor jar files provided by Palm keep changing:

Sprint: http://palm.cdnetworks.net/rom/p121r0d10092009/sr1ntp121rod/webosdoctorp100ewwsprint.jar

Bell Mobility: http://palm.cdnetworks.net/rom/ash994djslspam356z/b3y14rhu/webosdoctorp100ewwbellmo.jar

(see [[Sprint_vs_Bellmo_Doctor_Differences_1.1.0]])

Note that the webOS Doctor package comes with the following license:

RESTRICTIONS: The Software is licensed for use only with the single Palm device you originally purchased, and you may not distribute or make the Software available over a network or for use with multiple devices. The Software and supporting documentation may be copied only as necessary for backup or archive purposes in support of your use of the Software.

So we can't host different versions of it anywhere - the best we can do is record the md5sums of the versions we know about so that individuals can match this to the files they have for use with their Palm device.

Here is a list of the versions that we know about (with md5sums for each, and the date they were first spotted and recorded here):

Sprint:

4b3e396f8b1f1c5d3388e3c298af0484 webosdoctorp100ewwsprint-1.0.2.jar (10 June 2009)
0c8027b5a707eb0d02b1997d48021bd5 webosdoctorp100ewwsprint-1.0.3.jar (24 June 2009) (changes in [[WebOS_Doctor_version_1.0.3]])
32852c4b57d938e85f0fc819e57eacb7 webosdoctorp100ewwsprint-1.0.4.jar (9 July 2009) (changes in [[WebOS_Doctor_version_1.0.4]])
fc602490fdd7b3be8c5f727349c6195f webosdoctorp100ewwsprint-1.1.0.jar (24 July 2009) (changes in [[WebOS_Doctor_version_1.1.0]])
3123efda0a40821bd03daf1dd11cf2e3 webosdoctorp100ewwsprint-1.2.0-0830.jar (4 Sep 2009 - accidentally released early) (changes in [[WebOS_Doctor_version_1.2.0-0830]])
93c3f106b7a7e5ef572465dcb4488e1c webosdoctorp100ewwsprint-1.2.0.jar (29 September 2009)
e7600251e12e5b96f3143138ba61b9eb webosdoctorp100ewwsprint-1.2.1.jar (10 October 2009)

Bell Mobility:

ffd1bc50066d8f54d134b7aac194e3ec webosdoctorp100ewwbellmo-1.1.0.jar (27 August 2009)
c8f80b3cdbb9b96fd73bbb6062950a83 webosdoctorp100ewwbellmo-1.2.0.jar (29 September 2009)

WebOS Doctor Versions

2009-10-10T23:25:38Z

JayCanuck:

It seems the webOS Doctor jar files provided by Palm keep changing:

Sprint: http://palm.cdnetworks.net/rom/p121r0d10092009/sr1ntp121rod/webosdoctorp100ewwsprint.jar

Bell Mobility: http://palm.cdnetworks.net/rom/ash994djslspam356z/b3y14rhu/webosdoctorp100ewwbellmo.jar

(see [[Sprint_vs_Bellmo_Doctor_Differences_1.1.0]])

Note that the webOS Doctor package comes with the following license:

RESTRICTIONS: The Software is licensed for use only with the single Palm device you originally purchased, and you may not distribute or make the Software available over a network or for use with multiple devices. The Software and supporting documentation may be copied only as necessary for backup or archive purposes in support of your use of the Software.

So we can't host different versions of it anywhere - the best we can do is record the md5sums of the versions we know about so that individuals can match this to the files they have for use with their Palm device.

Here is a list of the versions that we know about (with md5sums for each, and the date they were first spotted and recorded here):

Sprint:

4b3e396f8b1f1c5d3388e3c298af0484 webosdoctorp100ewwsprint-1.0.2.jar (10 June 2009)
0c8027b5a707eb0d02b1997d48021bd5 webosdoctorp100ewwsprint-1.0.3.jar (24 June 2009) (changes in [[WebOS_Doctor_version_1.0.3]])
32852c4b57d938e85f0fc819e57eacb7 webosdoctorp100ewwsprint-1.0.4.jar (9 July 2009) (changes in [[WebOS_Doctor_version_1.0.4]])
fc602490fdd7b3be8c5f727349c6195f webosdoctorp100ewwsprint-1.1.0.jar (24 July 2009) (changes in [[WebOS_Doctor_version_1.1.0]])
3123efda0a40821bd03daf1dd11cf2e3 webosdoctorp100ewwsprint-1.2.0-0830.jar (4 Sep 2009 - accidentally released early) (changes in [[WebOS_Doctor_version_1.2.0-0830]])
93c3f106b7a7e5ef572465dcb4488e1c webosdoctorp100ewwsprint-1.2.0.jar (29 September 2009)
e7600251e12e5b96f3143138ba61b9eb webosdoctorp100ewwsprint-1.2.1.jar (10 October 2009)

Bell Mobility:

ffd1bc50066d8f54d134b7aac194e3ec webosdoctorp100ewwbellmo-1.1.0.jar (27 August 2009)
c8f80b3cdbb9b96fd73bbb6062950a83 webosdoctorp100ewwbellmo-1.2.0.jar (29 September 2009)

WebOS Doctor Versions

2009-09-30T15:38:01Z

JayCanuck:

It seems the webOS Doctor jar files provided by Palm keep changing:

Sprint: http://palm.cdnetworks.net/rom/ash994djslspam356z/s2x56ydt/webosdoctorp100ewwsprint.jar

Bell Mobility: http://palm.cdnetworks.net/rom/ash994djslspam356z/b3y14rhu/webosdoctorp100ewwbellmo.jar

(see [[Sprint_vs_Bellmo_Doctor_Differences_1.1.0]])

Note that the webOS Doctor package comes with the following license:

RESTRICTIONS: The Software is licensed for use only with the single Palm device you originally purchased, and you may not distribute or make the Software available over a network or for use with multiple devices. The Software and supporting documentation may be copied only as necessary for backup or archive purposes in support of your use of the Software.

So we can't host different versions of it anywhere - the best we can do is record the md5sums of the versions we know about so that individuals can match this to the files they have for use with their Palm device.

Here is a list of the versions that we know about (with md5sums for each, and the date they were first spotted and recorded here):

Sprint:

4b3e396f8b1f1c5d3388e3c298af0484 webosdoctorp100ewwsprint-1.0.2.jar (10 June 2009)
0c8027b5a707eb0d02b1997d48021bd5 webosdoctorp100ewwsprint-1.0.3.jar (24 June 2009) (changes in [[WebOS_Doctor_version_1.0.3]])
32852c4b57d938e85f0fc819e57eacb7 webosdoctorp100ewwsprint-1.0.4.jar (9 July 2009) (changes in [[WebOS_Doctor_version_1.0.4]])
fc602490fdd7b3be8c5f727349c6195f webosdoctorp100ewwsprint-1.1.0.jar (24 July 2009) (changes in [[WebOS_Doctor_version_1.1.0]])
3123efda0a40821bd03daf1dd11cf2e3 webosdoctorp100ewwsprint-1.2.0-0830.jar (4 Sep 2009 - accidentally released early) (changes in [[WebOS_Doctor_version_1.2.0-0830]])
93c3f106b7a7e5ef572465dcb4488e1c webosdoctorp100ewwsprint-1.2.0.jar (29 September 2009)

Bell Mobility:

ffd1bc50066d8f54d134b7aac194e3ec webosdoctorp100ewwbellmo-1.1.0.jar (27 August 2009)
c8f80b3cdbb9b96fd73bbb6062950a83 webosdoctorp100ewwbellmo-1.2.0.jar (29 September 2009)

Tutorials webOS Installing An Ipk

2009-08-19T22:49:31Z

JayCanuck: /* WebOS Quick Install Setup */

== Introduction ==

Our goal is to provide the simplest, most consumer friendly method to install homebrew apps on a stock Pre. The Pre does not have to be 'rooted'. The setup is much easier than the SDK method.

The PreBrew Installer is a tool that not only installs apps, but can run any rooted command on a Pre without having to manually root it. Unfortunately it requires development mode on the Pre, but the rest is very consumer friendly. This is much easier to initially setup than the SDK method. It works on Pres that are rooted or non-rooted.

The WebOS Quick Install program is a full featured WebOS app installer. You can drag and drop as many .ipk files onto the transfer queue as you want. Better yet, among the features, WebOS Quick Install includes a device management panel to get detailed information on your device and offers app uninstall functionality. Oh, and don't forget, WebOS Quick Install works cross-platform on Windows, Mac and Linux.

== PreBrew Install Method ==

=== Setup Instructions ===
{{article-two-columns
|width1=60%
|column1=
==== 1) Set Development Mode on your Pre ====
In order to install Pre apps using this method, you need to have the phone in konami/development mode. You only need to do this section once. To turn Developer Mode on...

* Go to the main Pre screen and swipe away (close) any running apps
* Type: '''upupdowndownleftrightleftrightbastart'''
* Click on the Developer Mode icon (if icon does not appear, repeat 2 steps above)
* Turn '''on''' Developer mode
* Restart your Pre (as prompted)
* Don't plug the phone into computer until completing the Windows install instructions below

==== 2) PreBrew for Windows - Installation Instructions ====
* On a Windows computer, [http://cid-e47a245fdc43bd04.skydrive.live.com/self.aspx/Public/PreBrew%201.5%20Installer.exe download PreBrew Installer.]
* To install PreBrew on the computer, '''double click "PreBrew 1.5 Installer.exe"''' and follow the prompts.
* After extraction '''double click "Setup.vbs"''' and follow the prompts.
* When complete '''Restart Windows''' (only restart if you installed the Novacom drivers.)
* An icon called "Drop File Here To Install Pre App" with a down green arrow should be placed on your Windows desktop.

If you have driver installation issues firstly reboot. If you still have issues run the PreBrew console from START MENU>Programs>Prebrew and try option 9 then reboot. If this doesn't work try option 10 and reboot.

If you have issues, please post '''%temp%\PreTool.log''' and '''%temp%\PreBrewSetup.log''' in this [http://forums.precentral.net/web-os-development/189497-post-os1-04-pinging-collective-new-install-method.html Pre Central thread.]
|column2=

==== 3) To Install Pre Apps ====
* Plug your Pre into computer USB port and put into 'Just Charge' mode, ''not'' 'USB Drive'.
* An icon called "Drop File Here To Install Pre App" with down green arrow should be located on your desktop.
* Drop an IPK file (packaged application) over the icon described above to install the App to your Pre.
==== 3b) To Install Pre Apps Using PuTTY(Wifi)====
* Gain root access to your Pre (instruction here [[Portal:Accessing_Linux]])
* Open a PuTTY terminal to your Pre (instruction here [[Putty]])
* Type "sudo /usr/bin/ipkg -o /var install URL" (where 'URL' is the url of the .ipk you want to install)
* Reboot Pre or Luna using "reboot" or "pkill LunaSysMgr" or "sudo luna-send -n 1 palm://com.palm.applicationManager/rescan {}"

==== 4) Where to Find Pre Homebrew Apps ====
Pre Central has a forum with a repository of many Pre apps. There are now more homebrew apps than in the Palm App Catalog. Download the .ipk App file to computer and install using the step above.

[http://forums.precentral.net/homebrew-apps/ Click Here for Homebrew Apps]

}}

=== Other Info ===

====Tested On:====

* Windows 7 (64bit and 32bit)
* Windows Vista (64bit and 32bit)
* Windows XP (32bit)

====NEW Version 1.5====
* Webosdoctorp100ewwsprint.jar is now saved to %userprofile%\downloads\webos\Webosdoctorp100ewwsprint.jar for futrue installs.
* Webosdoctorp100ewwsprint.jar link is updated. palm.cdnetworks.net hosts an updated version. I had a link to the original version.
* PreBrew attempts to install the novacom dirver (only if they are not installed). If this fails Prebew will try a second install method. If this fails you are notified.
* If Webosdoctorp100ewwsprint.jar already exists on your machine you are asked if you would like to download the latest version.

====KNOWN ISSUES====
* Possible download issues with Firefox (If someone can host the files I will move them)
* I am unable to get any feedback from the application install on the Pre. So if it fails I can't tell you :(

====PreBrew Console====
* PreBrew console can be loaded from START MENU>Programs>PreBrew
* PreBrew console will run most of the commands available in PreTool.

==== Other Commands ====
* PreTool (installed to C:\Program Files\PreBrew) contains various command line options as shown below.

==== USAGE ====
* PreTool EMU -i myapp.ipk (Installs myapp.ipk on emulator)
* PreTool USB -i myapp.ipk (Installs myapp.ipk on Palm Pre)
* PreTool EMU -l (List installed applications.)
* PreTool USB -l (List installed applications.)
* PreTool EMU -l2 (List installed PreBrew applications.)
* PreTool USB -l2 (List installed PreBrew applications.)
* PreTool EMU -r com.myapp (Removes myapp on emulator.)
* PreTool USB -r com.myapp (Removes myapp on Palm Pre connected via USB.)
* PreTool EMU -r2 com.myapp (Removes myapp on emulator.)
* PreTool USB -r2 com.myapp (Removes myapp on Palm Pre connected via USB.)
* PreTool EMU -c COMMAND COMMANDARGS (runs a command on emulator)
* PreTool USB -c COMMAND COMMANDARGS (runs a command on Palm Pre connected via USB)
* PreTool -d (Disables Developer Mode.)
* PreTool -PreBrew (Enables PreBrew.)
* PreTool -drv (Checks for Novacom drivers and installs if neccessary.)
* PreTool -drv2 (Manually install Novacom drivers.)
* PreTool -recovery (Runs the WebOS Doctor)
* PreTool -check (Checks Pre connectivity)

==== NOTES ====
If any of the download links for Java or WebOSDoctor change you can change their locations in "Setup.xml"

==== HELP ====
Need help? Having any issues?

Please post as much information as you can with the below a minimum.

* Windows Version: Xp, Vista, 7
* Windows Arch: 32bit, 64bit
* Any errors?
* What you have done/were doing?
* Please post "%temp%\PreTool.log" and "%temp%\PreBrewSetup.log".
* Open a command prompt and go to c:\Program Files\PreBrew
** Run InstallApp.bat "<FULL PATH TO IPK FILE>"

== WebOS Quick Install Method ==

=== Program Installation ===

==== Java 1.6 Required ====
Make sure you're up to date with Java. With this program, [http://www.java.com/en/download/manual.jsp Java 1.6] is needed.
* For Mac OS X, once you've installed Java 1.6, run /Application/Utilities/Java/Java Preferences. Then click and drag Jave SE 6 to top of both list, and exit the program. This will set Java 1.6 as the default version to use.

==== WebOS Quick Install Setup ====
* Download [http://forums.precentral.net/homebrew-apps/194832-webos-quick-install.html WebOS Quick Install] (free registration on PreCenteal forums required).
* On launch, it will look to see if you have WebOSDoctor downloaded and will download it for you if its not found.
** If you already have WebOSDoctor, close WebOS Quick Install and move it to the same folder as WebOS Quick Install.
* On first launch, there will be a first-time setup popup asking which device you want to use.
** For the emulator, choose "Emulator"
** For a real device, like the Palm Pre, choose "USB Device"
* Also during first launch, WebOS Quick Install will attempt to install Novacom for you.

==== Preparing Your Device ====
Not much is needed on the device-end of setup. Ignore these requirements if you're using WebOS Quick Install with the emulator.
* [http://developer.palm.com/index.php?option=com_content&view=article&id=1552#dev_mode Developer mode enabled].
* When you plugin your device for use with WebOS Quick Install, choose "Just Charge".

=== Usage ===
You can press the "+" button or simply drag and drop .ipk files onto the window and they'll be added to the the transfer queue. Then just press the "Install!" button and the rest is automatic

In addition, WebOS Quick Install offers uninstall functionality to cleanly uninstall applications remotely.

And for those who prefer to frequently enable and disable DevMode, there is also an option to unhide the application so it will appear in the launcher

=== Other Features ===
* No Linux knowledge needed
* Full device information section.
* Support for receiving individual files off of the device
* Support for sending indifidual files to the device
* Support for deleting files/folders on the device
* Quick-access link to the PreCentral homebrew forums.

=== Support ===
Having a problem with WebOS Quick Install? Don't worry, chances are a bit of reading through the [http://forums.precentral.net/homebrew-apps/194832-webos-quick-install-v1-0-a.html PreCentral forums release thread] will help you figure things out.

If you've read through that and still can solve an issue you're having, feel free to post in that thread. Be sure include what OS you're on, what you were doing when the problem arose, and any other information you think would be useful.

== Resetting Pre to Factory Settings ==

If you have serious problems with your Pre due to a homebrew app, you can completely reset your Pre to factory settings. Try removing the problem App first. It is best to attempt a reset to factory settings before returning a Pre to the store. Note that this will wipe out the files stored to the USB drive, so you may want to copy to computer before resetting.

[http://www.palm.com/us/support/downloads/pre/recoverytool/webosdoctor_sprint.html Click here to reset your Pre to factory settings.]

== Discuss ==

Also discuss installation methods on this [http://forums.precentral.net/web-os-development/189497-post-os1-04-pinging-collective-new-install-method.html Pre Central thread.] There are other methods to pursue described in that thread.

== Future Initiatives ==

* Find a way to push command/ipk w/out Dev/Konami mode (somehow webosdoctor can do this)

Now that greg has a solid method that pretty much matches the SDK method, it's time to raise the bar and figure out how to do this w/out Dev mode.

Somehow webosdoctor is able to refresh the Pre w/out manually putting into Dev mode.

This tool provides a way to look into java class files, which should provide clues to how webosdoctor is able to do this.

[http://download.cnet.com/DJ-Java-Decompiler/3000-2213_4-10046809.html DJ Java Decompiler]

Are there better tools than this?

* Develop a PreBrew Installer app for the Pre to download/install ipk over the air

== Credits ==
* '''xorg''' started the initiative seeking various methods, pursued webosdoctor method.
* '''greg_roll''' has made significant progress and completely developed the PreBrew method using webosdoctor.
* '''Jason Robitaille''' created WebOS Quick Install was the first to create a cross-platform GUI installer

Tutorials webOS Installing An Ipk

2009-08-04T12:17:20Z

JayCanuck:

== Introduction ==

Our goal is to provide the simplest, most consumer friendly method to install homebrew apps on a stock Pre. The Pre does not have to be 'rooted'. The setup is much easier than the SDK method.

The PreBrew Installer is a tool that not only installs apps, but can run any rooted command on a Pre without having to manually root it. Unfortunately it requires development mode on the Pre, but the rest is very consumer friendly. This is much easier to initially setup than the SDK method. It works on Pres that are rooted or non-rooted.

The WebOS Quick Install program is a full featured WebOS app installer. You can drag and drop as many .ipk files onto the transfer queue as you want. Better yet, among the features, WebOS Quick Install includes a device management panel to get detailed information on your device and offers app uninstall functionality. Oh, and don't forget, WebOS Quick Install works cross-platform on Windows, Mac and Linux.

== PreBrew Install Method ==

=== Setup Instructions ===
{{article-two-columns
|width1=60%
|column1=
==== 1) Set Development Mode on your Pre ====
In order to install Pre apps using this method, you need to have the phone in konami/development mode. You only need to do this section once. To turn Developer Mode on...

* Go to the main Pre screen and swipe away (close) any running apps
* Type: '''upupdowndownleftrightleftrightbastart'''
* Click on the Developer Mode icon (if icon does not appear, repeat 2 steps above)
* Turn '''on''' Developer mode
* Restart your Pre (as prompted)
* Don't plug the phone into computer until completing the Windows install instructions below

==== 2) PreBrew for Windows - Installation Instructions ====
* On a Windows computer, [http://cid-e47a245fdc43bd04.skydrive.live.com/self.aspx/Public/PreBrew%201.5%20Installer.exe download PreBrew Installer.]
* To install PreBrew on the computer, '''double click "PreBrew 1.5 Installer.exe"''' and follow the prompts.
* After extraction '''double click "Setup.vbs"''' and follow the prompts.
* When complete '''Restart Windows''' (only restart if you installed the Novacom drivers.)
* An icon called "Drop File Here To Install Pre App" with a down green arrow should be placed on your Windows desktop.

If you have driver installation issues firstly reboot. If you still have issues run the PreBrew console from START MENU>Programs>Prebrew and try option 9 then reboot. If this doesn't work try option 10 and reboot.

If you have issues, please post '''%temp%\PreTool.log''' and '''%temp%\PreBrewSetup.log''' in this [http://forums.precentral.net/web-os-development/189497-post-os1-04-pinging-collective-new-install-method.html Pre Central thread.]
|column2=

==== 3) To Install Pre Apps ====
* Plug your Pre into computer USB port and put into 'Just Charge' mode, ''not'' 'USB Drive'.
* An icon called "Drop File Here To Install Pre App" with down green arrow should be located on your desktop.
* Drop an IPK file (packaged application) over the icon described above to install the App to your Pre.
==== 3b) To Install Pre Apps Using PuTTY (Wifi)====
* Gain root access to your Pre (instruction here [[Portal:Accessing_Linux]])
* Open a PuTTY terminal to your Pre (instruction here [[Putty]])
* Type "cd /usr/bin ipkg -o /var install URL" (where 'URL' is the url of the .ipk you want to install)
* Reboot Pre or Luna using "reboot" or "pkill LunaSysMgr"

==== 4) Where to Find Pre Homebrew Apps ====
Pre Central has a forum with a repository of many Pre apps. There are now more homebrew apps than in the Palm App Catalog. Download the .ipk App file to computer and install using the step above.

[http://forums.precentral.net/homebrew-apps/ Click Here for Homebrew Apps]

}}

=== Other Info ===

====Tested On:====

* Windows 7 (64bit and 32bit)
* Windows Vista (64bit and 32bit)
* Windows XP (32bit)

====NEW Version 1.5====
* Webosdoctorp100ewwsprint.jar is now saved to %userprofile%\downloads\webos\Webosdoctorp100ewwsprint.jar for futrue installs.
* Webosdoctorp100ewwsprint.jar link is updated. palm.cdnetworks.net hosts an updated version. I had a link to the original version.
* PreBrew attempts to install the novacom dirver (only if they are not installed). If this fails Prebew will try a second install method. If this fails you are notified.
* If Webosdoctorp100ewwsprint.jar already exists on your machine you are asked if you would like to download the latest version.

====KNOWN ISSUES====
* Possible download issues with Firefox (If someone can host the files I will move them)
* I am unable to get any feedback from the application install on the Pre. So if it fails I can't tell you :(

====PreBrew Console====
* PreBrew console can be loaded from START MENU>Programs>PreBrew
* PreBrew console will run most of the commands available in PreTool.

==== Other Commands ====
* PreTool (installed to C:\Program Files\PreBrew) contains various command line options as shown below.

==== USAGE ====
* PreTool EMU -i myapp.ipk (Installs myapp.ipk on emulator)
* PreTool USB -i myapp.ipk (Installs myapp.ipk on Palm Pre)
* PreTool EMU -l (List installed applications.)
* PreTool USB -l (List installed applications.)
* PreTool EMU -l2 (List installed PreBrew applications.)
* PreTool USB -l2 (List installed PreBrew applications.)
* PreTool EMU -r com.myapp (Removes myapp on emulator.)
* PreTool USB -r com.myapp (Removes myapp on Palm Pre connected via USB.)
* PreTool EMU -r2 com.myapp (Removes myapp on emulator.)
* PreTool USB -r2 com.myapp (Removes myapp on Palm Pre connected via USB.)
* PreTool EMU -c COMMAND COMMANDARGS (runs a command on emulator)
* PreTool USB -c COMMAND COMMANDARGS (runs a command on Palm Pre connected via USB)
* PreTool -d (Disables Developer Mode.)
* PreTool -PreBrew (Enables PreBrew.)
* PreTool -drv (Checks for Novacom drivers and installs if neccessary.)
* PreTool -drv2 (Manually install Novacom drivers.)
* PreTool -recovery (Runs the WebOS Doctor)
* PreTool -check (Checks Pre connectivity)

==== NOTES ====
If any of the download links for Java or WebOSDoctor change you can change their locations in "Setup.xml"

==== HELP ====
Need help? Having any issues?

Please post as much information as you can with the below a minimum.

* Windows Version: Xp, Vista, 7
* Windows Arch: 32bit, 64bit
* Any errors?
* What you have done/were doing?
* Please post "%temp%\PreTool.log" and "%temp%\PreBrewSetup.log".
* Open a command prompt and go to c:\Program Files\PreBrew
** Run InstallApp.bat "<FULL PATH TO IPK FILE>"

== WebOS Quick Install Method ==

=== Program Installation ===

==== Java 1.6 Required ====
Make sure you're up to date with Java. With this program, [http://www.java.com/en/download/manual.jsp Java 1.6] is needed.
* For Mac OS X, once you've installed Java 1.6, run /Application/Utilities/Java/Java Preferences. Then click and drag Jave SE 6 to top of both list, and exit the program. This will set Java 1.6 as the default version to use.

==== WebOS Quick Install Setup ====
* Download [http://www.filefront.com/14171159/WebOSQuickInstall.jar WebOS Quick Install].
* On launch, it will look to see if you have WebOSDoctor downloaded and will download it for you if its not found.
** If you already have WebOSDoctor, close WebOS Quick Install and move it to the same folder as WebOS Quick Install.
* On first launch, there will be a first-time setup popup asking which device you want to use.
** For the emulator, choose "Emulator"
** For a real device, like the Palm Pre, choose "USB Device"
* Also during first launch, WebOS Quick Install will attempt to install Novacom for you.

==== Preparing Your Device ====
Not much is needed on the device-end of setup. Ignore these requirements if you're using WebOS Quick Install with the emulator.
* [http://developer.palm.com/index.php?option=com_content&view=article&id=1552#dev_mode Developer mode enabled].
* When you plugin your device for use with WebOS Quick Install, choose "Just Charge".

=== Usage ===
You can press the "+" button or simply drag and drop .ipk files onto the window and they'll be added to the the transfer queue. Then just press the "Install!" button and the rest is automatic

In addition, WebOS Quick Install offers uninstall functionality to cleanly uninstall applications remotely.

And for those who prefer to frequently enable and disable DevMode, there is also an option to unhide the application so it will appear in the launcher

=== Other Features ===
* No Linux knowledge needed
* Full device information section.
* Support for receiving individual files off of the device
* Support for sending indifidual files to the device
* Support for deleting files/folders on the device
* Quick-access link to the PreCentral homebrew forums.

=== Support ===
Having a problem with WebOS Quick Install? Don't worry, chances are a bit of reading through the [http://forums.precentral.net/homebrew-apps/194832-webos-quick-install-v1-0-a.html PreCentral forums release thread] will help you figure things out.

If you've read through that and still can solve an issue you're having, feel free to post in that thread. Be sure include what OS you're on, what you were doing when the problem arose, and any other information you think would be useful.

== Resetting Pre to Factory Settings ==

If you have serious problems with your Pre due to a homebrew app, you can completely reset your Pre to factory settings. Try removing the problem App first. It is best to attempt a reset to factory settings before returning a Pre to the store. Note that this will wipe out the files stored to the USB drive, so you may want to copy to computer before resetting.

[http://www.palm.com/us/support/downloads/pre/recoverytool/webosdoctor_sprint.html Click here to reset your Pre to factory settings.]

== Discuss ==

Also discuss installation methods on this [http://forums.precentral.net/web-os-development/189497-post-os1-04-pinging-collective-new-install-method.html Pre Central thread.] There are other methods to pursue described in that thread.

== Future Initiatives ==

* Find a way to push command/ipk w/out Dev/Konami mode (somehow webosdoctor can do this)

Now that greg has a solid method that pretty much matches the SDK method, it's time to raise the bar and figure out how to do this w/out Dev mode.

Somehow webosdoctor is able to refresh the Pre w/out manually putting into Dev mode.

This tool provides a way to look into java class files, which should provide clues to how webosdoctor is able to do this.

[http://download.cnet.com/DJ-Java-Decompiler/3000-2213_4-10046809.html DJ Java Decompiler]

Are there better tools than this?

* Develop a PreBrew Installer app for the Pre to download/install ipk over the air

== Credits ==
* '''xorg''' started the initiative seeking various methods, pursued webosdoctor method.
* '''greg_roll''' has made significant progress and completely developed the PreBrew method using webosdoctor.
* '''Jason Robitaille''' created WebOS Quick Install was the first to create a cross-platform GUI installer

Patch Launcher Add or Delete Pages

2009-08-02T03:15:10Z

JayCanuck:

[[Image:Launcher_AddDeletePages.jpg|border|right|Add/Delete Pages]]
==Introduction==

Someone in the forum talked about being able to add and delete pages in the Launcher app and I thought I would look into it further. They stated that they were able to add new pages and delete existing pages. Upon further investigation, they were correct. There is existing code, commented out, that will allow you to create a new launcher page or delete the current launcher page. There is a variable for the max number of pages palm set to 10. This value can probably be increased, but I don't recommend it and seriously, who would need more that 10 pages anyway, right?

===Usage===

*The new page and delete page functions will appear in the launcher menu.
**New Page
***This will create a new page and move whatever page you were on to the right. There is nothing special to this page besides the fact that you now have a new page. You can drag icons to it just like any other page.

**Delete Page
***This will delete the current launcher page. Any icons on the page will automatically move to the page to the left of the page being deleted. If there is no page to the left of the page being deleted icons are automatically moved to the default page of the Web Browser.

==Editing Process==

<pre>
/usr/lib/luna/system/luna-applauncher/app/controllers/launcher-assistant.js
</pre>
*Uncomment the following
**Look for "appMenuModel" (line 29) a few lines below you will see a line that has "newpage" in it. On the line that remove the "/*" and on the line that has "deletepage" remove the "*/"
**Look further in the file (line 120) for "switch" again remove the "/* and "*/" that surrounds the cases for newpage and deletepage.
*Perform a restart and the new page and delete page options will be in the launcher menu.

Original discovery credit is unknown. Pyrognome tested and confirmed the new page and delete page functionality.

==Patch Process==

The patch is also located in the webos-internals gitorious repository. Click [[Applying Patches]] for info on patching from it.

I'm trying to make most of my modifications into patches --[[User:HattCzech|HattCzech]]

*Run the following commands:

''In this example, I have the patch file located in my home directory under '''patches'''''
<source lang="bash">
cd /
sudo patch -p0 --backup-if-mismatch < ~/patches/adddelpages.patch
</source>

*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>

These modifications will require LunaSysMgr to be restarted. A rescan will not work. After you've run the commands above, run one more command:
<source lang="bash">
pkill LunaSysMgr
</source>

===Patch Source (adddelpages.patch)===

<source lang="diff">
diff -ur /usr/lib/luna/system/luna-applauncher/app/controllers/launcher-assistant.js /usr/lib/luna/sysmod/luna-applauncher/app/controllers/launcher-assistant.js
--- /usr/lib/luna/system/luna-applauncher/app/controllers/launcher-assistant.js 2009-07-18 00:21:37.000000000 -0500
+++ /usr/lib/luna/sysmod/luna-applauncher/app/controllers/launcher-assistant.js 2009-07-24 11:03:32.000000000 -0500
@@ -30,8 +30,8 @@
visible: true,
label: $L('Launcher'),
items: [
- /*{ label: $L('New page'), command: 'newpage' },
- { label: $L('Delete page'), command: 'deletepage' },*/
+ { label: $L('New page'), command: 'newpage' },
+ { label: $L('Delete page'), command: 'deletepage' },
Mojo.Menu.editItem,
{ label: $L('List Apps...'), command: 'listapps' },
Mojo.Menu.helpItem
@@ -124,7 +124,6 @@
case 'listapps':
ApplicationService.launch(this.deviceInfo.id, this.deviceInfo.params);
break;
- /*
case 'newpage':
if (this.pageDivs.length < 10) {
this.insertPage(this.activePageIndex, true);
@@ -138,7 +137,6 @@
}
}
break;
- */
}
}
},
</source>