Difference between revisions of "Application:Preware"

From WebOS Internals
Jump to navigation Jump to search
(Cleanup, Clearification, Minor Reformatting)
(→‎Installing Preware: Change link for Preware Homebrew Documentation to github repo)
 
(124 intermediate revisions by 33 users not shown)
Line 1: Line 1:
 +
[[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
 
{{application
|name=Preware
+
| name=Preware
|type=webOS
+
| type=webOS
|version=Version: Beta 0.9.19 <br />(6 Feb 2010)
+
| version=Version: 1.9.7 (15 December 2011)
|tag=Utilities
+
| tag=Utilities
|screenshot=Preware_ss1.png
+
| screenshot=Preware_ss1.png
|description=
+
| description=
 +
}}
 +
 
 +
<BR>
 +
== Summary ==
 +
<!--{{icon|Icon_Preware.png|float:right;}}-->
 +
[[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.
  
== Summary ==
+
'''Preware requires webOS 1.4.0 or later to functionDo not try to install it on earlier webOS versions, it will not work.'''
{{icon|Icon_Preware.png|float:right;}}
 
Preware is a package management application for the Palm Pre. 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.
 
  
 
This application was the result of extensive community-based design in [[IPKG Service]] and [[Preware Design]].
 
This application was the result of extensive community-based design in [[IPKG Service]] and [[Preware Design]].
Line 19: Line 31:
 
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.
 
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 ===
+
<BR>
 +
=== Key features ===
 +
Install / Remove / Update:
 +
* Homebrew Applications including advanced applications with special requirements. 
 +
* WebOS Themes
 +
* Patches
 +
* webOS Kernels
 +
* Support for installation of signed packages
 +
 
 +
<BR>
 +
=== 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.
 +
* Since 15 December 2011, access to webOS app catalog feeds has been restored via App Tuckerbox.
 +
* Since 15 December 2011, it also supports downloading feeds and packages from authenticated secure sites.
 +
 
 +
<BR>
 +
=== 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].
 +
 
 +
<BR>
 +
 
 +
== Installing Preware ==
 +
 
 +
There are four supported methods for installing Preware: Official HP/Palm SDK, WebOS Quick Install, Stand Alone Installers, and Command Line.
 +
 
 +
For a step-by-step tutorial, the official [https://github.com/rwhitby/phd Preware Homebrew Documentation] '''''was''''' highly recommended but it was available from the now closed app catalog and is no longer available for installation although one could build it from the github source linked above.
 +
 
 +
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.
 +
 
 +
<BR>
 +
=== 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.net
 +
## 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
 +
 
 +
<BR>
 +
 
 +
=== Installing Preware with WebOS Quick Install ===
 +
You can use version 4.6.0 or later of 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.webosnation.com/canuck-coding/274461-webos-quick-install-v4-6-0-a.html WebOS Quick Install v4.6.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
 +
## Download the current version of WebOS Quick Install (link see above)
 +
# 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.
 +
 
 +
<BR>
 +
 
 +
=== Installing Preware with the standalone installer ===
 +
'''Historical information:''' ''The standalone installers are not available in October 2017''
 +
 
 +
Preware installers can be downloaded here: <del><nowiki>http://get.preware.org/</nowiki></del> 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 Preware Standalone Installer from <del><nowiki>http://get.preware.org/</nowiki></del> (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.
 +
 
 +
<BR>
 +
 
 +
=== 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.
 +
 
 +
<code><nowiki>
 +
cd /tmp
 +
curl -L https://raw.githubusercontent.com/bbito/webos-internals-gitorious-bootstrap/master/preware-bootstrap.sh > preware-bootstrap.sh
 +
sh /tmp/preware-bootstrap.sh
 +
</nowiki></code>
 +
 
 +
''Historical note:'' The original script can be found at the gitorious mirror: https://gitorious.org/webos-internals/bootstrap/blobs/raw/master/preware-bootstrap.sh?p=webos-internals:bootstrap.git;a=blob_plain;f=preware-bootstrap.sh;hb=HEAD
 +
 
 +
About the gitorious mirror, see: https://gitorious.org
 +
 
 +
 
 +
 
 +
<BR>
 +
 
 +
=== 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.
  
* Install / Remove / Update Homebrew Applications including advanced applications with special requirements.
+
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.
* Install / Remove / Update WebOS Themes
+
 
* Install / Remove / Update WebOS Patches
+
<BR>
* Install / Remove / Update Palm App Catalog Applications
+
 
* Support for installation of signed 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.
 +
 
 +
<BR>
  
 
== Usage ==
 
== 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.<BR>
 +
In the upper right corner is a blue question mark. To get additional information on each preference tap on the blue question mark. All preferences are now highlighted in blue. Tap on a certain preference to enter the help screen. To leave the help screen back swipe. Tap again on the blue question mark to leave the help mode.
 +
<BR>
 +
{| 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.
 +
|}
 +
|}
 +
<BR>
  
=== Preferences ===  
+
=== 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).
  
[[Image:Preferences.png|160px|bottom]]<br><br>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:#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]
 +
|-
 +
|}
 +
|}
  
=== Feed Management ===
 
  
[[Image:Preware_ss9.png|160px|bottom]]<br><br>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.  
+
{| 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.
 +
|}
 +
<BR>
  
* Optware
+
=== Package updates ===
* Palm Beta
+
{| Width="70%" VAlign="top"
* Palm Catalog
+
| valign="top"|[[image:UpdateFeeds.png|160px|frameless|left|text-top]]
* Palm Web
+
| 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.
* PreCentral
+
|}
* PreCentral Themes
+
<BR>
* PreThemer
+
 
* WebOS Internals
+
=== Installing packages ===
* WebOS Patches
+
{| 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.
 +
|}
 +
<BR>
 +
 
 +
=== 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.
 +
|}
 +
<BR>
 +
 
 +
=== 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.
 +
|}
 +
<BR>
 +
 
 +
<!--
 +
{| style="color:black; background-color:#F9F9F9;border:1px outset;" cellpadding="3" cellspacing="0"
  
=== Package Updates ===
 
 
=== Applications ===
 
=== Applications ===
 
=== Themes ===
 
=== Themes ===
Line 53: Line 251:
 
=== Installed Packages ===
 
=== Installed Packages ===
 
=== List of Everything ===
 
=== List of Everything ===
 +
=== Saved Package List ===
 +
-->
 +
 +
== Operating notes ==
 +
=== Limitations ===
 +
No known limitations.
  
 +
<BR>
 +
=== 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.
  
== Status ==
+
* The Update All button can get confused if there are patches with complex dependencies.  This will be fixed in a future version.
  
This is beta softwareEven so:
+
* 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 CatalogDon'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.
  
* 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.
+
<BR>
* Since 27 August 2009 it is the only application supporting installation from all existing palm homebrew feeds.
+
== Changelog ==
* Since 17 September 2009 it also supports installation of themes.
+
<BR>
* Since 8 October 2009 it also supports installation of webos patches.
+
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.
* Since 12 Jan 2010 it also supports all Palm App Catalog feeds.
+
<BR><BR>
  
== License ==
+
; 1.9.12
 +
* Added support for WebOS Community Edition (WOCE) feeds by the WebOS Ports team from WebOS Internals.
  
Please be aware that org.webosinternals.preware and org.webosinternals.ipkgservice are licensed under the GPLv2.
+
; 1.9.10
 +
* Updated German translation (courtesy of DiplPhy).
  
They 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 authors.
+
; 1.9.9
 +
* Added Traditional Chinese translation (courtesy of tonyw).
  
== Operating notes ==
+
; 1.9.8
 +
* Updated German translation (courtesy of DocZet).
 +
 
 +
; 1.9.7
 +
* Added support for secure package downloads.
 +
 
 +
; 1.9.6
 +
* Added support for secure feed downloads.
 +
 
 +
; 1.9.5
 +
* Fixed the window orientation for the blue question mark help items.
 +
 
 +
; 1.9.4
 +
* Added disclaimer when installing apps marked incompatible with current device.
  
=== Limitations ===
+
; 1.9.2
 +
* Revamped feed downloading to give better error and status reporting.
  
No known limitations.
+
; 1.9.1
 +
* Fixed device identification of WiFi TouchPads.
  
=== Known bugs ===
+
; 1.9.0
 +
* Added feed display and installation support for App Tuckerbox.
  
*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.
+
; 1.8.7
 +
* Hide authentication information in the Manage Feeds display.
  
*The Update All button can get confused if there are patches with complex dependencies.  This will be fixed in a future version.
+
; 1.8.6
 +
* Added support for displaying the Changelog and DeviceCompatibility fields.
  
*If updates to App Catalog applications are pending, they will be silently skipped when using the Update All button.
+
; 1.8.5
 +
* Fixed missing package information bug
  
*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.)  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.
+
; 1.8.4
 +
* Added some additional Second Line preference options
  
== Installing Preware ==
+
; 1.8.3
 +
* Please read http://testing.preware.org/ if you use the testing feeds
  
''Simple step-by-step instructions with screenshots are here: [http://forums.precentral.net/showthread.php?p=2040315 Getting Started: Preware]''
+
; 1.8.2
 +
* Fixed the removal of obsolete testing feeds
  
You do not need to access the Linux command line or "root your Pre" to install or use Preware.
+
; 1.8.1
 +
* Remove the obsolete testing feeds when adding alpha or beta feeds
  
Please use version 2.96 or later of the [http://forums.precentral.net/canuck-software/206905-webos-quick-install-v2-96-a.html WebOS Quick Install] tool to install the Package Manager Service and the Preware application directly from the WebOS Internals feed. 
+
; 1.8.0
 +
* Disabled support for adding obsolete testing feeds
  
No other application installer tool is sophisticated enough to install the custom Package Manager Service that Preware requires. Preware can install it, but you need a way to bootstrap Preware first, so you need to use our stand-alone Preware Installers or WebOS Quick Install for the very first installation of Preware.
+
; 1.7.7
 +
* Enabled support of alpha and beta testing feeds
  
You need to have your Pre in [[Getting started|developer mode]] when using the stand-alone Preware Installer or WebOS Quick Install for the very first installation of the Package Manager Service and Preware. Once you have Preware correctly installed, you never need to use [[Getting started|developer mode]] again with Preware (it does the required steps in the background for you whenever it needs to).
+
; 1.7.6:
 +
* Larger screenshots on the TouchPad
 +
* Pressed states for TouchPad back buttons
 +
* Fixed search backspace on TouchPad
  
Note that Preware works just as well on the Emulator as it does on a real device, and is installed in exactly the same way.
+
; 1.7.5:
 +
* Fixed list rendering on TouchPad (courtesy of chpwn).
  
=== Installing Preware with WebOS Quick Install ===
+
; 1.7.4:
'''Simple step-by-step instructions with screenshots are here: [http://www.precentral.net/how-add-homebrew-apps-patches-and-themes Getting Started: Preware]'''
+
* Removed catalog feed specific preferences (show only free/show only english).
'''Latest Version of WebOS Quick Install available here: [http://forums.precentral.net/canuck-software/228310-webos-quick-install-v3-01-a.html WebOS Quick Install v3.01]'''
 
  
# Install the required Software
+
; 1.7.3:
## [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
+
* Added support for font packages.
## [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 your will remember (maybe "Palm"?).  If you already have it, skip this step.
 
##* '''Do not run the webOS Doctor'''
 
## [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]]
 
# Run WebOS Quick Install
 
# Click the third button on the right (Blue Down Arrow)
 
# Choose WebOS Internals Feed (all) from the dropdown list at the top.
 
# Select ''Package Manager Service'' from the list. 
 
# Select ''Preware'' from the list. 
 
# Click Download.
 
# Click Close.
 
# Click Install.
 
Note: If WebOS Quick Install offers to install the Package Manager Service automatically to enable tweaking, do not agree.  It will install the wrong version.  You must install it as detailed above.
 
  
=== Installing Preware from Terminal, Novaterm or WebOS Quick Install "Linux Commandline" ===
+
; 1.7.2:
 +
* Replaced the word phone with the word device in all messages.
  
Really, unless you *really* know what you are doing, you should use the normal WebOS Quick Install installation instructions above.
+
; 1.7.1:
 +
* Fixed fullscreen screenshot resizing on TouchPad rotate (courtesy of Appsotutely).
 +
* Fixed dependent packages spinner location (courtesy of chpwn).
  
<source lang="bash">
+
; 1.7.0:
cd /tmp
+
* Rolled up all the beta release features for a TouchPad-compatible public release.
wget http://bit.ly/preware-bootstrap
 
sh preware-bootstrap
 
</source>
 
  
=== Installing Preware with Preware Installer ===
+
; 1.6.8:
 +
* Enabled back tap on header for all devices.
  
# '''Put your phone into [[Getting started|Developer Mode]]''' (skip if you already have developer mode on)
+
; 1.6.7:
# '''Install Required Software''':
+
* Fixed full-screen formatting of ipkg log screen.
## [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://www.webos-internals.org/wiki/Webos_Doctor_Versions Click here] to download the current webOS Doctor for your carrier and phone in a subdirectory your will remember (maybe "Palm"?).  If you already have it, skip this step.
 
##* '''Do not run the webOS Doctor'''
 
# '''Install Preware''':
 
## Right click the most recent PrewareInstaller.jar from [http://get.preware.org/ get.preware.org] and choose ''Save As...''
 
## Save the Preware Installer in the same folder where your save the webOS Doctor.
 
## Open (run) the Preware Installer (Double click the jar file you just downloaded.) 
 
## Click Tools then Update Drivers to refresh Novacomd. This may take a few minutes.
 
## Click INSTALL. Wait while the ''Install'' button is grayed out (Preware is being installed).
 
## When the Preware Installer Button is no longer grayed out, close the Preware Installer.
 
# '''Restart your phone''':
 
## Press and hold the ON/OFF button for 8 seconds
 
## Tap Power
 
## Tap Restart
 
# '''Update the Package Manager Service and Preware'''
 
## Tap Launcher
 
## Tap Preware
 
## Tap OK to continue if there is a splash screen
 
## Tap Package Updates (an update for Package Manager Service and Preware should be shown)
 
## Tap Package Manager Service
 
## Tap Update
 
## Tap OK when the Package Manager Service application has installed
 
## Swipe back to return to Package Updates
 
## Tap Preware
 
## Tap Update
 
## Tap OK when the Preware application has installed
 
  
=== Updating ===
+
; 1.6.6:
 +
* Preware is now fully compatible with the TouchPad, using the full screen area.
  
To update Preware or the Package Manager Service, simpy use Preware version 0.9.0 or later.
+
; 1.6.5:
 +
* Now usable on devices without a back gesture.
 +
* Set the wget user-agent to Preware when retrieving indexes and packages.
  
Make sure you update the Package Manager Service first, and the Preware application second. As of Preware 0.9.4, this restriction will be enforced automatically.
+
; 1.6.4:
 +
* Fixed a problem when loading the saved packages list.
  
If you are updating to Preware version 0.9.3 or later and you have previously used the autopatch-feed package, please follow these [http://forums.precentral.net/webos-patches/208312-autopatch-transitioning-webos-patches-feed.html] directions for the update.
+
; 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.
  
=== Removal ===
+
; 1.6.2:
 +
* Added the clock themes feed (disabled by default).
  
''Why would you ever want to remove Preware?''
+
; 1.6.0:
 +
* webOS 2.x Just Type integration.
 +
* Fixed package list ordering bug.
 +
* Layout fixes for Pixi/Veer.
  
To remove Preware, use WebOS Quick Install's Device Management page and unselect the Package Manager Service and the Preware application.
+
; 1.5.9:
 +
* Fixed parse errors resulting from packages with very large descriptions.
 +
* Fixed problems with updates to app catalog apps.
  
=== Recent enhancements ===
+
; 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.
  
0.9.19: Localization support and French translations added, courtesy of Yannick LE NY. Fixed the OnFeeds split error, caused by zero length feed config files. Now continues to load the package feeds after an update error.
+
; 1.5.7:
 +
* Added check to make sure package has a title before trying to search it.
  
0.9.18: Added second line options for feed, price & feed, and price & version & feed.  Added reporting of each feed index file as it is being downloaded.
+
; 1.5.6:
 +
* Removed support for Visibility feed value - use a category filter to exclude Unavailable packages if desired.
  
0.9.16: Removed the partial app limit fix (obsolete as of webOS 1.3.5)
+
; 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.
  
0.9.15: Added Palm App Catalog feeds, including price information.
+
; 1.5.4:
 +
* Updated French translations (courtesy of Clément).
  
0.9.14: Added support for installation of signed packages without confirmation.
+
; 1.5.3:
 +
* Reinstated banner notification of manual saved package list update.
  
0.9.13: Enabled the Update All button, and added support for skipping restart actions (e.g. when installing multiple patches).
+
; 1.5.2:
 +
* Check if package dates are actually dates.
 +
* Removed banner notification of saved package list being saved.
  
0.9.12: Fixed the recurring splash screen bug.
+
; 1.5.1:
 +
* Added support for optware testing feeds.
  
0.9.11: Added a preference for enabling and disabling the fair dinkum partial app limit fix.
+
; 1.5.0:
 +
* You must upgrade to this version for full webOS 2.0 compatibility.
  
0.9.10: Added support for category themes.
+
; 1.4.9:
 +
* Better compatibility with unknown future webOS versions.
  
0.9.9: Massive speed improvements, a fix for the theme hanging problem, and support for Pixi patching.
+
; 1.4.8:
  
0.9.8: Robustified the calls to the JSON parser to handle packages with syntax errors in appinfo.json
+
* Now calls the correct software manager updates screen on webOS 2.0.
  
0.9.7: Added a preference to enable or disable fixing the metadata for unknown type packages.
+
; 1.4.7:
 +
* Fixed update, install and remove status messages on webOS 2.0.
  
0.9.6: Added the initial startup screen. Fixed the display of packages with multiple maintainers. Now loads extended appinfo and control file information for Unknown packages. Changed default list second-line to version + maintainer. No longer allows back-gestures during package operations. Multi-line package titles are now supported. Show All Packages changed to Show Available Types and now defaults to No.
+
; 1.4.6:
 +
* New "App Catalog" theme preferences thanks to Garrett92C.
 +
* Added support for "MaxWebOSVersion" in the feeds.
  
0.9.5: A package is removed if the user cancels installation.  More verbose status and error messages.  Selects appropriate webos-patches feed automatically.
+
; 1.4.5:
 +
* Added support for identifying when running on a Pre 2 device.
  
0.9.4: Added support for package dependencies.
+
; 1.4.4:  
 +
* Updated the version check to support future webOS versions.
  
0.9.3: Adds the webos-patches feed, and feed management support.
+
; 1.4.2:
 +
* Added Category as a blacklist option.
  
0.9.1: Adds the All category, plus other miscellaneous fixes.
+
; 1.4.1:
 +
* Added a Changelog button to the Help scene.
  
0.9.0: Now supports themes, restart flags and the new memory-reduction service methods.
+
; 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.
  
0.8.5: Massive speed improvement on loading, now supports package types and adding feeds.
+
; 1.3.8:
 +
* Updated French translations (courtesy of Yannick LE NY).
  
0.8.2: More preferences added and now functional, with listing and update frequency options.
+
; 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.
  
0.8.1: Preferences scene implemented. Upstart job stops on removal.
+
; 1.3.5:
 +
* Updated German translations.
  
0.8.0: Now supports Descriptions and Screenshots.
+
; 1.3.3:
 +
* Always ask the user before modifying the file association list.
 +
* Updated French translations.  
  
0.7.7: Addition of ipkglog and config list, and if ipkgservice fails at start it notifies people, and if it fails after postinst it considers it complete anyways
+
; 1.3.1:
 +
* Check whether Preware is the default application for handling packages, and advise the user if it is not.
  
0.7.6: Fixed the superfluous update subscription message windows
+
; 1.3.0:
 +
* Added Preware to the Default Applications list to allow for installing packages from email messages and the browser.
  
0.7.5: Fixed update subscription oddity.
+
; 1.2.9:
 +
* Fixed the Saved Package List swipe to delete bug.
  
0.7.4: Fixed remounting of root filesystem for post-install and pre-remove scripts on the Pre.
+
; 1.2.8:
 +
* Open the My Applications app catalog screen when multiple app catalog applications need updating.
  
0.7.1: Fixed buttons and title on script view screen.
+
; 1.2.7
 +
* Fixed the Install Package problem when running on the emulator.
  
0.7.0: Initial support for post-install and pre-remove scripts, including secure informed user consent.  Does not work properly with dependencies yet, so please install dependencies one at a time.
+
; 1.2.6
 +
* Remove most of the curl download progress messages from the ipkg log (this fixes a buffer overrun crash).
  
0.6.7: Fixed bug in category drop-down list.
+
; 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.
  
0.6.6: Fixed bug in package size reporting.
+
; 1.2.4
 +
* Added support for MinWebOSVersion, DeviceCompatibility and PreActionMessage package attributes.
  
0.6.5: Updated icon and other graphical annotations.
+
; 1.2.3
 +
* Enable the Install Package feature to also work for incorrectly formatted filenames.
  
0.6.4: Categories drop-down bug fixed. Preware category updated.
+
; 1.2.1
 +
* Robustified the Install Package feature - will now run post-install scripts for all correctly formatted filenames (packageid_version_arch.ipk).
  
0.6.2: Categories now work to some extent.  Still a bug in the drop down box.
+
; 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.
  
0.6.1: Sorting by name or date is now available. Application details screen is much more organized.
+
; 1.1.7
 +
* Added support for Kernel Modules.
  
0.6.0: No user visible changes.  Preparation for the secure informed user consent functionality.
+
; 1.1.5
 +
* Use a gentler reboot procedure to allow open files to be flushed to disk.
  
0.5.1: Filtering is now available on the list screens.  Just start typing ...
+
; 1.1.4
 +
* Fixed hang on package download failures.
  
== Repository ==
+
; 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.
  
Preware and the Package Manager Service are housed in the applications/preware and services/ipkservice git repositories at http://git.webos-internals.org/
+
; 1.1.1
 +
* Added languages field in package descriptions.  
 +
* Added preference to only show packages with English descriptions.
  
For commit permission to the open source project, contact rwhitby on #webos-internals or email [[mailto:support@webos-internals.org support@webos-internals.org]]
+
; 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.
  
== Preware Bootstrap ==
+
; 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.
  
The Preware Bootstrap is the fastest, most robust way to install or update Preware and the Package Manager Service.
+
<BR>
  
<source lang="bash">
+
== Repository ==
cd /tmp
+
Preware and the Package Manager Service are housed in the applications/preware git repository at http://git.webos-internals.org/
wget http://bit.ly/preware-bootstrap
 
sh preware-bootstrap
 
</source>
 
  
}}
+
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]

Latest revision as of 20:37, 5 October 2017

This page is currently available in four languages:

Australia.png USA.png Application:Preware
France.png Application:Preware-FR
Germany.png Application:Preware-DE
China.png Application:Preware-ZH


« Go Back to the Utilities application list
Preware ss1.png

Preware - Version: 1.9.7 (15 December 2011)



Summary

Icon Preware.png

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 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.
  • Since 15 December 2011, access to webOS app catalog feeds has been restored via App Tuckerbox.
  • Since 15 December 2011, it also supports downloading feeds and packages from authenticated secure sites.


License

Please be aware that org.webosinternals.preware is licensed under the 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 authors.


Installing Preware

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

For a step-by-step tutorial, the official Preware Homebrew Documentation was highly recommended but it was available from the now closed app catalog and is no longer available for installation although one could build it from the github source linked above.

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:

  1. Install the latest official Palm webOS SDK from http://developer.palm.com
  2. 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
  3. Close the doctor
  4. Your device should remain disconnected
  5. Download the latest Preware package onto your computer from http://get.preware.net
    1. To install Preware on a device, download the 'arm' .ipk file
    2. To install Preware on an emulator, download the 'i686' .ipk file
  6. Typing webos20090606, select the developer mode icon that will appear, and verify that your device is in developer mode
  7. Connect your device to your computers USB port, and select 'Just Charge' (or 'Cancel' on your Touchpad)
  8. 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
  9. Use palm-install to install the package you downloaded
    1. 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.6.0 or later of 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: WebOS Quick Install v4.6.0

  1. Install the required Software
    1. Click here to verify that you have the latest java installed on your computer and update if needed
    2. Download the current version of WebOS Quick Install (link see above)
  2. Put your device in Developer Mode
  3. Connect your device to your computer with the USB cable, and select "Just Charge" or "Cancel" (on a Touchpad). Do not select USB Drive.
  4. Run WebOS Quick Install. If the novacom driver is not installed, WebOS Quick Install will download and install that for you.
    1. 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.
  5. 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".
  6. Click the third button on the right (the globe icon)
  7. Select the Applications tab at the top
  8. Search for Preware
  9. Click Install.


Installing Preware with the standalone installer

Historical information: The standalone installers are not available in October 2017

Preware installers can be downloaded here: http://get.preware.org/ These instructions are currently only for Mac and PC users.

  1. Install the required software.
    1. Click here to verify that you have the latest version of Java installed on your computer and update it if needed.
    2. 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.
  2. Put your device into 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.
  3. Download the Preware Standalone Installer from http://get.preware.org/ (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.
  4. Run the Preware Installer.
  5. Click on the Tools menu and choose Install Drivers. This will install the Palm Novacom drivers for webOS devices.
  6. If you are installing on a Veer, you may need to reboot the phone at this point.
  7. 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.


cd /tmp
curl -L https://raw.githubusercontent.com/bbito/webos-internals-gitorious-bootstrap/master/preware-bootstrap.sh > preware-bootstrap.sh
sh /tmp/preware-bootstrap.sh

Historical note: The original script can be found at the gitorious mirror: https://gitorious.org/webos-internals/bootstrap/blobs/raw/master/preware-bootstrap.sh?p=webos-internals:bootstrap.git;a=blob_plain;f=preware-bootstrap.sh;hb=HEAD

About the gitorious mirror, see: https://gitorious.org



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

Preferences.png
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.

In the upper right corner is a blue question mark. To get additional information on each preference tap on the blue question mark. All preferences are now highlighted in blue. Tap on a certain preference to enter the help screen. To leave the help screen back swipe. Tap again on the blue question mark to leave the help mode.

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

Preware feeds.png
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).
Default Feeds
PreCentral
WebOS Internals Optware WebOS Patches WebOS Kernels


See Testing Feeds for detailed instructions on adding custom feeds.


Package updates

UpdateFeeds.png
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

SelectApp.png
There are a few ways to select and install a "package" (application/patch/theme/etc.). Using "List of Everything" would be the simplest.
  1. Find the package you want to install either by scrolling and tapping on it, or just start typing
  2. Tap the "Install" button that the bottom of the package's page to install.


Removing packages

RemoveAppTap.png
Removing a package is just as easy.
  1. On the main screen, tap "Installed Packages", then the category of the package you want to remove
  2. Tap the Package you want to remove
  3. Tap the "Remove" button that the bottom of the package's page.


Blacklist (category filters)

Preware 2011-09-03 165038.png Preware 2011-09-03 165049.png
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 found here. Listed below is the Changelog since the 1.0 milestone.

1.9.12
  • Added support for WebOS Community Edition (WOCE) feeds by the WebOS Ports team from WebOS Internals.
1.9.10
  • Updated German translation (courtesy of DiplPhy).
1.9.9
  • Added Traditional Chinese translation (courtesy of tonyw).
1.9.8
  • Updated German translation (courtesy of DocZet).
1.9.7
  • Added support for secure package downloads.
1.9.6
  • Added support for secure feed downloads.
1.9.5
  • Fixed the window orientation for the blue question mark help items.
1.9.4
  • Added disclaimer when installing apps marked incompatible with current device.
1.9.2
  • Revamped feed downloading to give better error and status reporting.
1.9.1
  • Fixed device identification of WiFi TouchPads.
1.9.0
  • Added feed display and installation support for App Tuckerbox.
1.8.7
  • Hide authentication information in the Manage Feeds display.
1.8.6
  • Added support for displaying the Changelog and DeviceCompatibility fields.
1.8.5
  • Fixed missing package information bug
1.8.4
  • Added some additional Second Line preference options
1.8.3
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 support@webos-internals.org