Test app

 =Summary=

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.

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 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 is also supports installation of webOS custom kernels.



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 [mailto:support@webos-internals.org authors].

 =Installing Preware=

There are three supported methods for installing Preware: 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 with WebOS Quick Install
You can use version 3.14 or later of WebOS Quick Install to install Preware directly from the WebOS Internals feed.

Latest Version of WebOS Quick Install available here: WebOS Quick Install v3.14


 * 1) Install the required Software
 * 2) Click here to verify that you have the latest java installed on your computer and update if needed
 * 3) 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.
 * 4) * Do not run the webOS Doctor
 * 5) Click Here to download the latest version of WebOS Quick Install
 * 6) Put your device in Developer Mode
 * 7) Connect your device to your computer with the USB cable, and select "Just Charge" (do not select USB Drive)
 * 8) Run WebOS Quick Install
 * 9) Click the third button on the right (Blue Down Arrow)
 * 10) Choose WebOS Internals Feed (Pre) or WebOS Internals Feed (Pixi) from the drop-down list at the top.
 * 11) Select Preware from the list.
 * 12) Click Download.
 * 13) Click Close.
 * 14) Click Install.



Installing Preware with the standalone installer
Preware installers can be downloaded here: Preware Standalone Installers. These instructions are currently only for Mac and PC users.


 * 1) Install the required software.
 * 2) Click here to verify that you have the latest version of Java installed on your computer and update it if needed.
 * 3) 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.
 * 4) * Do not run the webOS Doctor.
 * 5) Put your device into Developer Mode.
 * 6) * 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.
 * 7) Download the Preware Standalone Installer and place it in the same directory as the webOS Doctor .jar file.
 * 8) Run the Preware Installer.
 * 9) Click on the Tools menu and choose Install Drivers. This will install the Palm Novacom drivers for webOS devices.
 * 10) 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 Terminal, Novaterm or WebOS Quick Install "Linux Commandline"
If you have access to the command line of your webOS Device or emulator using Terminal, Novaterm, 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.



Updating
To update Preware, simply use 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
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
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.



Feed Management
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).


 * Optware
 * Palm Beta
 * Palm Beta Updates
 * Palm Catalog
 * Palm Catalog Updates
 * Palm Web
 * Palm Web Updates
 * PreCentral
 * PreCentral Themes
 * PreThemer
 * WebOS Internals
 * WebOS Kernels
 * WebOS Patches



Adding Custom Feeds
See Testing Feeds for custom feed instructions.

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


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


 * 0.9.38
 * Robustified the scanning of unknown packages, with the hope of preventing hangs.
 * Added the ability to swipe delete items from the Saved Package List.
 * Disabled the app catalog and themes feeds on first installation, but kept palm update feeds enabled.
 * Added prerm conditionals to assist an easy transition from Preware Alpha back to Preware 1.0. Added support for the webos-kernels feed.


 * 0.9.36
 * Added searching from the main screen.
 * Added the ability to email an IPKG Log.
 * Added warning message for custom feed additions, and robustified the feed management page.
 * Added support for kernel packages.


 * 0.9.35
 * Added Saved Package List functionality for saving and restoring your list of installed packages.
 * Updated German translations, courtesy of Markus Leutwyler (swisstomcat).
 * Restricted new feed names to lower case characters for consistency.


 * 0.9.33
 * Restricted input character set for new custom feed names.
 * Fixed javascript timeout problem with large feeds.


 * 0.9.31
 * Renamed Fix Unknown Types to Scan Unknown Packages, and now reports the id of the package being scanned.


 * 0.9.30
 * Now chooses the correct information to display for packages in multiple feeds.


 * 0.9.29
 * Added option to search package descriptions instead of just the titles.
 * Integrated Luna Manager into Preware, find it in the app menu.


 * 0.9.28
 * Added support for displaying the countries for which an application is released.


 * 0.9.27
 * Fixed a serious bug in update subscription handling.
 * Now hides the price sort option when none of the loaded packages have any prices.


 * 0.9.26
 * Fixed a bug in App Catalog background operation detection.


 * 0.9.25
 * Added a preference to only show free applications.


 * 0.9.24
 * Added protection against App Catalog installs clobbering the ipkg status file.


 * 0.9.23
 * Spanish translations added, courtesy of Ángel Prada (Malakun).


 * 0.9.22
 * Italian translations added, courtesy of Federico Pietta (Darkmagister).


 * 0.9.21
 * German translations added, courtesy of Volker Zota (DocZet) and Thomas Linden (debilator).


 * 0.9.20
 * Fixed an error in the French support which prevented Preware from loading.


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


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


 * 0.9.16
 * Removed the partial app limit fix (obsolete as of webOS 1.3.5)


 * 0.9.15
 * Added Palm App Catalog feeds, including price information.


 * 0.9.14
 * Added support for installation of signed packages without confirmation.


 * 0.9.13
 * Enabled the Update All button
 * Added support for skipping restart actions (e.g. when installing multiple patches).


 * 0.9.12
 * Fixed the recurring splash screen bug.


 * 0.9.11
 * Added a preference for enabling and disabling the fair dinkum partial app limit fix.


 * 0.9.10
 * Added support for category themes.


 * 0.9.9
 * Massive speed improvements
 * Fix for the theme hanging problem
 * Support for Pixi patching.


 * 0.9.8
 * Robustified the calls to the JSON parser to handle packages with syntax errors in appinfo.json


 * 0.9.7
 * Added a preference to enable or disable fixing the metadata for unknown type packages.


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


 * 0.9.5
 * A package is removed if the user cancels installation.
 * More verbose status and error messages.
 * Selects appropriate webos-patches feed automatically.


 * 0.9.4
 * Added support for package dependencies.


 * 0.9.3
 * Adds the webos-patches feed, and feed management support.


 * 0.9.1
 * Adds the All category, plus other miscellaneous fixes.


 * 0.9.0
 * Now supports themes, restart flags and the new memory-reduction service methods.


 * 0.8.5
 * Massive speed improvement on loading
 * Package types and adding feeds.


 * 0.8.2
 * More preferences added and now functional, with listing and update frequency options.


 * 0.8.1
 * Preferences scene implemented.
 * Upstart job stops on removal.


 * 0.8.0
 * Now supports Descriptions and Screenshots.


 * 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


 * 0.7.6
 * Fixed the superfluous update subscription message windows


 * 0.7.5
 * Fixed update subscription oddity.


 * 0.7.4
 * Fixed remounting of root file system for post-install and pre-remove scripts on the Pre.


 * 0.7.1
 * Fixed buttons and title on script view screen.


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


 * 0.6.7
 * Fixed bug in category drop-down list.


 * 0.6.6
 * Fixed bug in package size reporting.


 * 0.6.5
 * Updated icon and other graphical annotations.


 * 0.6.4
 * Categories drop-down bug fixed.
 * Preware category updated.


 * 0.6.2
 * Categories now work to some extent. Still a bug in the drop down box.


 * 0.6.1
 * Sorting by name or date is now available.
 * Application details screen is much more organized.


 * 0.6.0
 * No user visible changes. Preparation for the secure informed user consent functionality.


 * 0.5.1
 * Filtering is now available on the list screens. Just start typing ...

<BR> =Repository= Preware and the Package Manager Service are housed in the applications/preware and services/ipkservice git repositories at http://git.webos-internals.org/

For commit permission to the open source project, contact rwhitby on #webos-internals or email [mailto:support@webos-internals.org support@webos-internals.org]