WebOS Internals - User contributions [en]

Testing Feeds

2011-09-17T15:33:28Z

Bgrambo:

This page is currently available in two languages:
:[[Image:Australia.png]] [[Image:USA.png]] [[Testing_Feeds]]
:[[Image:Germany.png]] [[Testing_Feeds-DE]]

=Migration to the Alpha and Beta Testing Feeds=

The old WebOS Internals Testing Feeds (for applications and kernels) have been replaced by separate Alpha and Beta testing feeds. There are a number of reasons for this change:

# We want to separate out bleeding-edge unstable alpha testing packages from generally benign beta testing packages. The old testing feeds did not allow this distinction.
# Too many sites have published the raw testing feed URLs without referencing the rules below, which means many people have the old testing feeds enabled without understanding the risks associated with doing so.
# There were a number of packages which were caught in the old testing feeds when the TouchPad fire sale happened, and as a result of the publicity surrounding those packages many people have the old testing feeds enabled just for those packages (which have since been promoted to the public feeds) and are not aware of the risks associated with other packages which they may be presented with via those old testing feeds.

Please read the [http://www.webos-internals.org/wiki/Testing_Feeds#Testing_Feeds_Q.26A Testing Feeds Q&A] for more information about the rationale for this change.

Each of the Alpha and Beta testing feeds has four sub-feeds: Apps, Kernels, Patches & Optware. Each of these sub-feeds can be enabled or disabled independently.

Transition to the new Alpha and Beta testing feeds is now underway. Preware 1.8.x now supports the new Alpha and Beta testing feeds, and instructions on how to enable the new feeds are on this page. When you enable the new Alpha or Beta testing feeds, the old obsolete testing feeds will be automatically removed from your Preware configuration.

=Rules that you must agree to before using these feeds=

Before you use our testing feeds, please read and agree to the following rules:
[[image:Tux_with_Warning.png|frameless|right]]
# Anyone participating in WebOS Internals alpha or beta testing of any kind must be prepared to fully erase and webOS Doctor their device at a moment's notice without warning and without any regrets or complaints.
# They must be prepared to and able to log into the command line on the device and type Linux commands when instructed to do so. Knowing Linux commands ahead of time is preferred, but not required if you are willing to learn them when necessary or can follow instructions without making mistakes.
# They must be prepared to go to great and extraordinary lengths to try and reliably reproduce any problems they encounter.
# They must give full and detailed bug reports, leaving out no piece of information which could possibly be remotely connected to the problem.
# They must read any and all documentation and forums threads (in their entirety) before asking a question.
# They must fastidiously follow the forum threads where the alpha testing is being discussed by the authors, and follow precisely any instructions given there.
# They will never post the raw testing feed URLs or instructions anywhere, but will always refer others directly to this page using only the URL "http://testing.preware.org/"
# When asking for help, they will include the phrase (which may change occasionally) "I've read the rules". Failure to include the phrase will result in the request for help being silently ignored.

If you're not prepared to do *all* the above, and do it all in good spirit, then please wait for the public release of the item.

If you are prepared to do *all* the above, then by all means please participate in the alpha or beta testing.

Note that everything above is a function of attitude, not of skill.

= Enabling the Beta Testing Feeds =

Beta quality packages have had some end-user testing, but may still delete your data or wipe your device in rare circumstances. You have been warned. Unless you are directly and specifically beta testing a package, you should disable all beta feeds at all times other than when you are explicitly updating or installing a beta package.

[http://www.webos-internals.org/wiki/Testing_Feeds#Rules_that_you_must_agree_to_before_using_these_feeds Re-read the rules above before continuing.]

[http://www.webos-internals.org/wiki/Testing_Feeds#Testing_Feeds_Q.26A It is also wise to read all of the Q&A before continuing]

'''''You must never repost or copy or rewrite these instructions anywhere else, but must always refer others directly to this page using only the URL "http://testing.preware.org/"'''''

To enable the beta testing feeds, you must do the following:

1. Uninstall Preware. Yes, seriously. You must uninstall Preware.

2. Gain access to the Linux command line on your device and run the following two commands. If you do not already know how to do this using novaterm or Xecutah, or cannot find out how to do this using Google, then you should not be beta testing.
mkdir -p /var/preferences/org.webosinternals.preware
touch /var/preferences/org.webosinternals.preware/enable-beta-feeds

3. Install Preware 1.8.3 or later.

4. Start Preware, open the Manage Feeds screen, and enable *only* those feeds which you wish to use. Before enabling a kernel testing feed, you should [http://developer.palm.com/blog/2010/03/a-statement-on-the-overclocking-patches/ read this].

'''''You must never repost or copy or rewrite these instructions anywhere else, but must always refer others directly to this page using only the URL "http://testing.preware.org/"'''''

= Enabling the Alpha Testing Feeds =

Alpha quality packages have had little or no end-user testing, and are likely to delete your data, wipe your device and profile, and potentially damage your device. Packages in the alpha feed *will* regularly break (perhaps even intentionally). You have been warned. Unless you are directly and specifically alpha testing a package, you should disable all alpha feeds at all times other than when you are explicitly updating or installing an alpha package.

In general, very very very very few users would be expected to enable the Alpha testing feeds. The large majority of users should only ever use the Beta testing feeds.

The Beta testing feeds and the Alpha testing feeds can both be enabled at the same time if desired.

[http://www.webos-internals.org/wiki/Testing_Feeds#Rules_that_you_must_agree_to_before_using_these_feeds Re-read the rules above before continuing.]

[http://www.webos-internals.org/wiki/Testing_Feeds#Testing_Feeds_Q.26A It is also wise to read all of the Q&A before continuing]

'''''You must never repost or copy or rewrite these instructions anywhere else, but must always refer others directly to this page using only the URL "http://testing.preware.org/"'''''

To enable the alpha testing feeds, you must do the following:

1. Uninstall Preware. Yes, seriously. You must uninstall Preware.

2. Gain access to the Linux command line on your device and run the following two commands. If you do not already know how to do this using novaterm or Xecutah, or cannot find out how to do this using Google, then you should not be alpha testing.
mkdir -p /var/preferences/org.webosinternals.preware
touch /var/preferences/org.webosinternals.preware/enable-alpha-feeds

3. Install Preware 1.8.3 or later.

4. Start Preware, open the Manage Feeds screen, and enable *only* those feeds which you wish to use. Before enabling a kernel testing feed, you should [http://developer.palm.com/blog/2010/03/a-statement-on-the-overclocking-patches/ read this].

'''''You must never repost or copy or rewrite these instructions anywhere else, but must always refer others directly to this page using only the URL "http://testing.preware.org/"'''''

=Testing Feeds Q&A=

'''Q: Who should use the Alpha testing feeds?'''

A: If you're asking that question, then you should not be using the Alpha testing feeds. Very very very very very few people should ever enable the Alpha testing feeds. Unless you have a git repository cloned and are editing code, you should not enable the Alpha testing feeds.

'''Q: Who should use the Beta testing feeds?'''

A: Anyone is welcome to use the Beta testing feeds, as long as they comply fully with the rules and know exactly why they are using a Beta testing feed (i.e. they are not just blindly following some instructions in some article or forum post somewhere).

'''Q: Why does enabling the feeds require connecting my device to a computer?'''

A: When you are enabling testing feeds for the first time, we want to ensure that you are able to connect to your device from a computer to assist in debugging the things you are testing, or to be able to recover your device if something goes wrong.

'''Q: Why does enabling the feeds require reinstalling Preware?'''

A: The feeds are actually created when Preware is installed, so you need to reinstall Preware for the feeds to be created on your device.

'''Q: Why does enabling the feeds require the use of the Linux command line?'''

A: To be an effective tester, you need to be able to access your device on the Linux command line to provide debugging information. We ensure that you can do that before you are able to access the feeds.

'''Q: Why can't I just enter in the feed URLs directly?'''

A: Too many people got the feed names or feed URLs wrong, so we took those things out of the equation.

'''Q: Why can't I publish the instructions on my blog or website or forum post?'''

A: Too many people were publishing the URLs without the corresponding rules and warnings. This is now strictly forbidden.

'''Q: What are the alpha-patches and beta-patches feeds going to be used for?'''

A: The alpha-patches feed will be used for testing new AUPT scripts which will be able to handle patching files in /media/cryptofs/apps/. Once that is working, we'll use the beta-patches feed to do a complete upgrade of all patches to use the new AUPT scripts and then beta test those.

'''Q: WebOS Quick Install is only presenting Preware 1.7.5 for me to install. How do I get Preware 1.8.3 or later?'''

A: Install Preware 1.7.5, then upgrade to Preware 1.8.3 or later from the testing feed (it's in both the old and the new testing feeds). Once the transition is well tested, we'll make it so that WebOS Quick Install presents 1.8.3 or later directly.

Testing Feeds

2011-09-17T15:32:58Z

Bgrambo:

This page is currently available in two languages:
:[[Image:Australia.png]] [[Image:USA.png]] [[Testing_Feeds]]
:[[Image:Germany.png]] [[Testing_Feeds-DE]]

=Migration to the Alpha and Beta Testing Feeds=

The old WebOS Internals Testing Feeds (for applications and kernels) have been replaced by separate Alpha and Beta testing feeds. There are a number of reasons for this change:

# We want to separate out bleeding-edge unstable alpha testing packages from generally benign beta testing packages. The old testing feeds did not allow this distinction.
# Too many sites have published the raw testing feed URLs without referencing the rules below, which means many people have the old testing feeds enabled without understanding the risks associated with doing so.
# There were a number of packages which were caught in the old testing feeds when the TouchPad fire sale happened, and as a result of the publicity surrounding those packages many people have the old testing feeds enabled just for those packages (which have since been promoted to the public feeds) and are not aware of the risks associated with other packages which they may be presented with via those old testing feeds.

Please read the [http://www.webos-internals.org/wiki/Testing_Feeds#Testing_Feeds_Q.26A Testing Feeds Q&A] for more information about the rationale for this change.

Each of the Alpha and Beta testing feeds has four sub-feeds: Apps, Kernels, Patches & Optware. Each of these sub-feeds can be enabled or disabled independently.

Transition to the new Alpha and Beta testing feeds is now underway. Preware 1.8.x now supports the new Alpha and Beta testing feeds, and instructions on how to enable the new feeds are on this page. When you enable the new Alpha or Beta testing feeds, the old obsolete testing feeds will be automatically removed from your Preware configuration.

=Rules that you must agree to before using these feeds=

Before you use our testing feeds, please read and agree to the following rules:
[[image:Tux_with_Warning.png|frameless|right]]
# Anyone participating in WebOS Internals alpha or beta testing of any kind must be prepared to fully erase and webOS Doctor their device at a moment's notice without warning and without any regrets or complaints.
# They must be prepared to and able to log into the command line on the device and type Linux commands when instructed to do so. Knowing Linux commands ahead of time is preferred, but not required if you are willing to learn them when necessary or can follow instructions without making mistakes.
# They must be prepared to go to great and extraordinary lengths to try and reliably reproduce any problems they encounter.
# They must give full and detailed bug reports, leaving out no piece of information which could possibly be remotely connected to the problem.
# They must read any and all documentation and forums threads (in their entirety) before asking a question.
# They must fastidiously follow the forum threads where the alpha testing is being discussed by the authors, and follow precisely any instructions given there.
# They will never post the raw testing feed URLs or instructions anywhere, but will always refer others directly to this page using only the URL "http://testing.preware.org/"
# When asking for help, they will include the phrase (which may change occasionally) "I've read the rules". Failure to include the phrase will result in the request for help being silently ignored.

If you're not prepared to do *all* the above, and do it all in good spirit, then please wait for the public release of the item.

If you are prepared to do *all* the above, then by all means please participate in the alpha or beta testing.

Note that everything above is a function of attitude, not of skill.

= Enabling the Beta Testing Feeds =

Beta quality packages have had some end-user testing, but may still delete your data or wipe your device in rare circumstances. You have been warned. Unless you are directly and specifically beta testing a package, you should disable all beta feeds at all times other than when you are explicitly updating or installing a beta package.

[http://www.webos-internals.org/wiki/Testing_Feeds#Rules_that_you_must_agree_to_before_using_these_feeds Re-read the rules above before continuing.]

[http://www.webos-internals.org/wiki/Testing_Feeds#Testing_Feeds_Q.26A It is also wise to read all of the FAQ before continuing]

'''''You must never repost or copy or rewrite these instructions anywhere else, but must always refer others directly to this page using only the URL "http://testing.preware.org/"'''''

To enable the beta testing feeds, you must do the following:

1. Uninstall Preware. Yes, seriously. You must uninstall Preware.

2. Gain access to the Linux command line on your device and run the following two commands. If you do not already know how to do this using novaterm or Xecutah, or cannot find out how to do this using Google, then you should not be beta testing.
mkdir -p /var/preferences/org.webosinternals.preware
touch /var/preferences/org.webosinternals.preware/enable-beta-feeds

3. Install Preware 1.8.3 or later.

4. Start Preware, open the Manage Feeds screen, and enable *only* those feeds which you wish to use. Before enabling a kernel testing feed, you should [http://developer.palm.com/blog/2010/03/a-statement-on-the-overclocking-patches/ read this].

'''''You must never repost or copy or rewrite these instructions anywhere else, but must always refer others directly to this page using only the URL "http://testing.preware.org/"'''''

= Enabling the Alpha Testing Feeds =

Alpha quality packages have had little or no end-user testing, and are likely to delete your data, wipe your device and profile, and potentially damage your device. Packages in the alpha feed *will* regularly break (perhaps even intentionally). You have been warned. Unless you are directly and specifically alpha testing a package, you should disable all alpha feeds at all times other than when you are explicitly updating or installing an alpha package.

In general, very very very very few users would be expected to enable the Alpha testing feeds. The large majority of users should only ever use the Beta testing feeds.

The Beta testing feeds and the Alpha testing feeds can both be enabled at the same time if desired.

[http://www.webos-internals.org/wiki/Testing_Feeds#Rules_that_you_must_agree_to_before_using_these_feeds Re-read the rules above before continuing.]

[http://www.webos-internals.org/wiki/Testing_Feeds#Testing_Feeds_Q.26A It is also wise to read all of the FAQ before continuing]

'''''You must never repost or copy or rewrite these instructions anywhere else, but must always refer others directly to this page using only the URL "http://testing.preware.org/"'''''

To enable the alpha testing feeds, you must do the following:

1. Uninstall Preware. Yes, seriously. You must uninstall Preware.

2. Gain access to the Linux command line on your device and run the following two commands. If you do not already know how to do this using novaterm or Xecutah, or cannot find out how to do this using Google, then you should not be alpha testing.
mkdir -p /var/preferences/org.webosinternals.preware
touch /var/preferences/org.webosinternals.preware/enable-alpha-feeds

3. Install Preware 1.8.3 or later.

4. Start Preware, open the Manage Feeds screen, and enable *only* those feeds which you wish to use. Before enabling a kernel testing feed, you should [http://developer.palm.com/blog/2010/03/a-statement-on-the-overclocking-patches/ read this].

'''''You must never repost or copy or rewrite these instructions anywhere else, but must always refer others directly to this page using only the URL "http://testing.preware.org/"'''''

=Testing Feeds Q&A=

'''Q: Who should use the Alpha testing feeds?'''

A: If you're asking that question, then you should not be using the Alpha testing feeds. Very very very very very few people should ever enable the Alpha testing feeds. Unless you have a git repository cloned and are editing code, you should not enable the Alpha testing feeds.

'''Q: Who should use the Beta testing feeds?'''

A: Anyone is welcome to use the Beta testing feeds, as long as they comply fully with the rules and know exactly why they are using a Beta testing feed (i.e. they are not just blindly following some instructions in some article or forum post somewhere).

'''Q: Why does enabling the feeds require connecting my device to a computer?'''

A: When you are enabling testing feeds for the first time, we want to ensure that you are able to connect to your device from a computer to assist in debugging the things you are testing, or to be able to recover your device if something goes wrong.

'''Q: Why does enabling the feeds require reinstalling Preware?'''

A: The feeds are actually created when Preware is installed, so you need to reinstall Preware for the feeds to be created on your device.

'''Q: Why does enabling the feeds require the use of the Linux command line?'''

A: To be an effective tester, you need to be able to access your device on the Linux command line to provide debugging information. We ensure that you can do that before you are able to access the feeds.

'''Q: Why can't I just enter in the feed URLs directly?'''

A: Too many people got the feed names or feed URLs wrong, so we took those things out of the equation.

'''Q: Why can't I publish the instructions on my blog or website or forum post?'''

A: Too many people were publishing the URLs without the corresponding rules and warnings. This is now strictly forbidden.

'''Q: What are the alpha-patches and beta-patches feeds going to be used for?'''

A: The alpha-patches feed will be used for testing new AUPT scripts which will be able to handle patching files in /media/cryptofs/apps/. Once that is working, we'll use the beta-patches feed to do a complete upgrade of all patches to use the new AUPT scripts and then beta test those.

'''Q: WebOS Quick Install is only presenting Preware 1.7.5 for me to install. How do I get Preware 1.8.3 or later?'''

A: Install Preware 1.7.5, then upgrade to Preware 1.8.3 or later from the testing feed (it's in both the old and the new testing feeds). Once the transition is well tested, we'll make it so that WebOS Quick Install presents 1.8.3 or later directly.

Testing Feeds

2011-09-17T15:31:58Z

Bgrambo:

This page is currently available in two languages:
:[[Image:Australia.png]] [[Image:USA.png]] [[Testing_Feeds]]
:[[Image:Germany.png]] [[Testing_Feeds-DE]]

=Migration to the Alpha and Beta Testing Feeds=

The old WebOS Internals Testing Feeds (for applications and kernels) have been replaced by separate Alpha and Beta testing feeds. There are a number of reasons for this change:

# We want to separate out bleeding-edge unstable alpha testing packages from generally benign beta testing packages. The old testing feeds did not allow this distinction.
# Too many sites have published the raw testing feed URLs without referencing the rules below, which means many people have the old testing feeds enabled without understanding the risks associated with doing so.
# There were a number of packages which were caught in the old testing feeds when the TouchPad fire sale happened, and as a result of the publicity surrounding those packages many people have the old testing feeds enabled just for those packages (which have since been promoted to the public feeds) and are not aware of the risks associated with other packages which they may be presented with via those old testing feeds.

Please read the [http://www.webos-internals.org/wiki/Testing_Feeds#Testing_Feeds_Q.26A Testing Feeds Q&A] for more information about the rationale for this change.

Each of the Alpha and Beta testing feeds has four sub-feeds: Apps, Kernels, Patches & Optware. Each of these sub-feeds can be enabled or disabled independently.

Transition to the new Alpha and Beta testing feeds is now underway. Preware 1.8.x now supports the new Alpha and Beta testing feeds, and instructions on how to enable the new feeds are on this page. When you enable the new Alpha or Beta testing feeds, the old obsolete testing feeds will be automatically removed from your Preware configuration.

=Rules that you must agree to before using these feeds=

Before you use our testing feeds, please read and agree to the following rules:
[[image:Tux_with_Warning.png|frameless|right]]
# Anyone participating in WebOS Internals alpha or beta testing of any kind must be prepared to fully erase and webOS Doctor their device at a moment's notice without warning and without any regrets or complaints.
# They must be prepared to and able to log into the command line on the device and type Linux commands when instructed to do so. Knowing Linux commands ahead of time is preferred, but not required if you are willing to learn them when necessary or can follow instructions without making mistakes.
# They must be prepared to go to great and extraordinary lengths to try and reliably reproduce any problems they encounter.
# They must give full and detailed bug reports, leaving out no piece of information which could possibly be remotely connected to the problem.
# They must read any and all documentation and forums threads (in their entirety) before asking a question.
# They must fastidiously follow the forum threads where the alpha testing is being discussed by the authors, and follow precisely any instructions given there.
# They will never post the raw testing feed URLs or instructions anywhere, but will always refer others directly to this page using only the URL "http://testing.preware.org/"
# When asking for help, they will include the phrase (which may change occasionally) "I've read the rules". Failure to include the phrase will result in the request for help being silently ignored.

If you're not prepared to do *all* the above, and do it all in good spirit, then please wait for the public release of the item.

If you are prepared to do *all* the above, then by all means please participate in the alpha or beta testing.

Note that everything above is a function of attitude, not of skill.

= Enabling the Beta Testing Feeds =

Beta quality packages have had some end-user testing, but may still delete your data or wipe your device in rare circumstances. You have been warned. Unless you are directly and specifically beta testing a package, you should disable all beta feeds at all times other than when you are explicitly updating or installing a beta package.

[http://www.webos-internals.org/wiki/Testing_Feeds#Rules_that_you_must_agree_to_before_using_these_feeds Re-read the rules above before continuing.]

[http://www.webos-internals.org/wiki/Testing_Feeds#Testing_Feeds_Q&A It is also wise to read all of the FAQ before continuing]

'''''You must never repost or copy or rewrite these instructions anywhere else, but must always refer others directly to this page using only the URL "http://testing.preware.org/"'''''

To enable the beta testing feeds, you must do the following:

1. Uninstall Preware. Yes, seriously. You must uninstall Preware.

2. Gain access to the Linux command line on your device and run the following two commands. If you do not already know how to do this using novaterm or Xecutah, or cannot find out how to do this using Google, then you should not be beta testing.
mkdir -p /var/preferences/org.webosinternals.preware
touch /var/preferences/org.webosinternals.preware/enable-beta-feeds

3. Install Preware 1.8.3 or later.

4. Start Preware, open the Manage Feeds screen, and enable *only* those feeds which you wish to use. Before enabling a kernel testing feed, you should [http://developer.palm.com/blog/2010/03/a-statement-on-the-overclocking-patches/ read this].

'''''You must never repost or copy or rewrite these instructions anywhere else, but must always refer others directly to this page using only the URL "http://testing.preware.org/"'''''

= Enabling the Alpha Testing Feeds =

Alpha quality packages have had little or no end-user testing, and are likely to delete your data, wipe your device and profile, and potentially damage your device. Packages in the alpha feed *will* regularly break (perhaps even intentionally). You have been warned. Unless you are directly and specifically alpha testing a package, you should disable all alpha feeds at all times other than when you are explicitly updating or installing an alpha package.

In general, very very very very few users would be expected to enable the Alpha testing feeds. The large majority of users should only ever use the Beta testing feeds.

The Beta testing feeds and the Alpha testing feeds can both be enabled at the same time if desired.

[http://www.webos-internals.org/wiki/Testing_Feeds#Rules_that_you_must_agree_to_before_using_these_feeds Re-read the rules above before continuing.]

[http://www.webos-internals.org/wiki/Testing_Feeds#Testing_Feeds_Q&A It is also wise to read all of the FAQ before continuing]

'''''You must never repost or copy or rewrite these instructions anywhere else, but must always refer others directly to this page using only the URL "http://testing.preware.org/"'''''

To enable the alpha testing feeds, you must do the following:

1. Uninstall Preware. Yes, seriously. You must uninstall Preware.

2. Gain access to the Linux command line on your device and run the following two commands. If you do not already know how to do this using novaterm or Xecutah, or cannot find out how to do this using Google, then you should not be alpha testing.
mkdir -p /var/preferences/org.webosinternals.preware
touch /var/preferences/org.webosinternals.preware/enable-alpha-feeds

3. Install Preware 1.8.3 or later.

4. Start Preware, open the Manage Feeds screen, and enable *only* those feeds which you wish to use. Before enabling a kernel testing feed, you should [http://developer.palm.com/blog/2010/03/a-statement-on-the-overclocking-patches/ read this].

'''''You must never repost or copy or rewrite these instructions anywhere else, but must always refer others directly to this page using only the URL "http://testing.preware.org/"'''''

=Testing Feeds Q&A=

'''Q: Who should use the Alpha testing feeds?'''

A: If you're asking that question, then you should not be using the Alpha testing feeds. Very very very very very few people should ever enable the Alpha testing feeds. Unless you have a git repository cloned and are editing code, you should not enable the Alpha testing feeds.

'''Q: Who should use the Beta testing feeds?'''

A: Anyone is welcome to use the Beta testing feeds, as long as they comply fully with the rules and know exactly why they are using a Beta testing feed (i.e. they are not just blindly following some instructions in some article or forum post somewhere).

'''Q: Why does enabling the feeds require connecting my device to a computer?'''

A: When you are enabling testing feeds for the first time, we want to ensure that you are able to connect to your device from a computer to assist in debugging the things you are testing, or to be able to recover your device if something goes wrong.

'''Q: Why does enabling the feeds require reinstalling Preware?'''

A: The feeds are actually created when Preware is installed, so you need to reinstall Preware for the feeds to be created on your device.

'''Q: Why does enabling the feeds require the use of the Linux command line?'''

A: To be an effective tester, you need to be able to access your device on the Linux command line to provide debugging information. We ensure that you can do that before you are able to access the feeds.

'''Q: Why can't I just enter in the feed URLs directly?'''

A: Too many people got the feed names or feed URLs wrong, so we took those things out of the equation.

'''Q: Why can't I publish the instructions on my blog or website or forum post?'''

A: Too many people were publishing the URLs without the corresponding rules and warnings. This is now strictly forbidden.

'''Q: What are the alpha-patches and beta-patches feeds going to be used for?'''

A: The alpha-patches feed will be used for testing new AUPT scripts which will be able to handle patching files in /media/cryptofs/apps/. Once that is working, we'll use the beta-patches feed to do a complete upgrade of all patches to use the new AUPT scripts and then beta test those.

'''Q: WebOS Quick Install is only presenting Preware 1.7.5 for me to install. How do I get Preware 1.8.3 or later?'''

A: Install Preware 1.7.5, then upgrade to Preware 1.8.3 or later from the testing feed (it's in both the old and the new testing feeds). Once the transition is well tested, we'll make it so that WebOS Quick Install presents 1.8.3 or later directly.

Application:Preware

2011-09-17T14:33:48Z

Bgrambo:

[[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.2.3]'''

# 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.3.jar Click Here] to download WebOS Quick Install v4.2.3
# 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 Xecutah on webOS 2.x or lower, hold the Orange button on your keypad and choose Xecutah 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]

Buy propecia 1mg cheap - propecia sperm - buy propecia fedex

2011-09-11T17:50:54Z

Bgrambo: moved Buy propecia 1mg cheap - propecia sperm - buy propecia fedex to DELETE -- Buy propecia 1mg cheap - propecia sperm - buy propecia fedex: Spam.

#REDIRECT [[DELETE -- Buy propecia 1mg cheap - propecia sperm - buy propecia fedex]]

DELETE -- Buy propecia 1mg cheap - propecia sperm - buy propecia fedex

2011-09-11T17:50:54Z

Bgrambo: moved Buy propecia 1mg cheap - propecia sperm - buy propecia fedex to DELETE -- Buy propecia 1mg cheap - propecia sperm - buy propecia fedex: Spam.

DELETE -- Buy propecia 1mg cheap - propecia sperm - buy propecia fedex

2011-09-11T17:50:06Z

Bgrambo: Delete this spam.

Application:Preware

2011-09-11T14:05:24Z

Bgrambo: /* Summary */

[[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.7.5 (28 August 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 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-2-3-a.html WebOS Quick Install v4.2.3]'''

# 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.3.jar Click Here] to download WebOS Quick Install v4.2.3
# 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 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.

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



== 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.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-09-11T14:04:21Z

Bgrambo:

[[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.7.5 (28 August 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-2-3-a.html WebOS Quick Install v4.2.3]'''

# 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.3.jar Click Here] to download WebOS Quick Install v4.2.3
# 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 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.

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



== 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.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-09-11T14:03:13Z

Bgrambo: /* Changelog */

[[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-2-3-a.html WebOS Quick Install v4.2.3]'''

# 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.3.jar Click Here] to download WebOS Quick Install v4.2.3
# 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 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.

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



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

Testing Feeds

2011-09-11T13:52:52Z

Bgrambo: /* Kernel Testing Feeds */

=Rules that you must agree to before using these feeds=

Before you use our testing feeds, please read and agree to the following rules:
[[image:Tux_with_Warning.png|frameless|right]]
# Anyone participating in WebOS Internals alpha testing of any kind must be prepared to fully erase and webOS Doctor their device at a moment's notice without warning and without any regrets or complaints.
# They must be prepared to and able to log into the command line on the device and type Linux commands when instructed to do so. Knowing Linux commands ahead of time is preferred, but not required if you are willing to learn them when necessary or can follow instructions without making mistakes.
# They must be prepared to go to great and extraordinary lengths to try and reliably reproduce any problems they encounter.
# They must give full and detailed bug reports, leaving out no piece of information which could possibly be remotely connected to the problem.
# They must read any and all documentation and forums threads (in their entirety) before asking a question.
# They must fastidiously follow the forum threads where the alpha testing is being discussed by the authors, and follow precisely any instructions given there.
# They will never post the raw testing feed URLs anywhere, but will always refer others directly to this page using only the URL "http://testing.preware.org/"
# When asking for help, they will include the phrase (which may change occasionally) "I've read the rules". Failure to include the phrase will result in the request for help being silently ignored.

If you're not prepared to do *all* the above, and do it all in good spirit, then please wait for the public release of the item.

If you are prepared to do *all* the above, then by all means please participate in the alpha testing.

Note that everything above is a function of attitude, not of skill.

Testing feeds for kernels are at the bottom of this page.

=Configuring the WebOS Internals Testing Feeds=

===Using Preware===
[[image:Tux_with_Pre.png|frameless|right]]
With Preware versions 0.9.30 and above, incombination with webOS 1.3.5 and above, users are now able to add custom feeds through Preware without the use of a computer. The following instructions will explain how to add the Webos-Internals Testing feeds.

Note that you will need to enable *TWO* feeds below. You need the *ALL* feed and you need the device-specific feed as well (armv7, armv6 or i686).

{| border="0" width="470"
|colspan="2" align="left"|'''Target Device:''' ALL
|-
|'''Name:'''||webos-testing-all
|-
|'''URL:'''||[http://ipkg.preware.org/feeds/webos-internals/testing/all/ http://ipkg.preware.org/feeds/webos-internals/testing/all]
|-
|} 
{| border="0" width="470"
|-
|colspan="2" align="left"|'''Target Device:''' <nowiki>Pre/Pre+/Pre2/Veer/TouchPad/Pre3</nowiki>
|-
|'''Name:'''||webos-testing-armv7
|-
|'''URL:'''||[http://ipkg.preware.org/feeds/webos-internals/testing/armv7/ http://ipkg.preware.org/feeds/webos-internals/testing/armv7]
|-
|} 
{| border="0" width="470"
|-
|colspan="2" align="left"|'''Target Device:''' <nowiki>Pixi/Pixi+</nowiki>
|-
|'''Name:'''||webos-testing-armv6
|-
|'''URL:'''||[http://ipkg.preware.org/feeds/webos-internals/testing/armv6/ http://ipkg.preware.org/feeds/webos-internals/testing/armv6]
|-
|} 
{| border="0" width="470"
|-
|colspan="2" align="left"|'''Target Device:''' Palm SDK Emulator
|-
|'''Name:'''||webos-testing-i686
|-
|'''URL:'''||[http://ipkg.preware.org/feeds/webos-internals/testing/i686/ http://ipkg.preware.org/feeds/webos-internals/testing/i686]
|}
 
#Open Preware and wait for it to finish loading.
#Open the App Menu (tap "Preware" in the top left corner of the screen) and tap Manage feeds.
#Scroll to the bottom until you see the New Feed box.
#Type or paste a name and corresponding URL from above in the appropriate text boxes. Make sure the URL does *not* have a slash at the end.
#Make sure the IS COMPRESSED option is set to YES.
#Tap Add Feed and then tap Yes when the alert pops up.
#Repeat these steps for each feed you wish to enable.
#Gesture swipe back. Preware will alert you that you have added feeds and ask if you want to update them now. Choose YES.
 
Congratulations, you have just added a custom feed! For adding other feeds, be sure to replace the name and URL in these instructions with the proper name and URL.
 
'''TIP:'''

shift+tap (and drag) on text to select
gesture+c to copy
gesture+v to paste
Make sure to delete 'http://' before pasting the URL if the URL already contains 'http://'

 

===Using a Computer===
[[image:Tux_Chat.png|frameless|right]]
1. Gain access to the shell, either through novaterm/ssh or via the terminal application available through the regular WebOS Internals Feed 
2. Execute the following commands:
<pre>
cd /media/cryptofs/apps/etc/ipkg
echo "src/gz webosinternals-testing http://ipkg.preware.org/feeds/webos-internals/testing/all" > webos-internals-testing.conf
echo "src/gz webosinternals-testing-armv7 http://ipkg.preware.org/feeds/webos-internals/testing/armv7" >> webos-internals-testing.conf
</pre>
3. Once Preware is launched, select "Update Feeds" from the Application Menu.

Replace 'armv7' with 'armv6' or 'i686' in the instructions above if you are using a Pixi or the Emulator respectively.

 
=Kernel Testing Feeds=
[http://www.webos-internals.org/index.php?title=Testing_Feeds&action=submit#Rules_that_you_must_agree_to_before_using_these_feeds Re-read the rules above before continuing.]
Also see http://forums.precentral.net/2532084-post3.html for further warnings up to and including your device wiping itself, (literally) melting, and/or eating your kitten.

If you do not want a puddle of molten plastic and silicon where your Pre/Pixi/TouchPad once was, DO NOT CONTINUE.

You have been warned.

[http://developer.palm.com/blog/2010/03/a-statement-on-the-overclocking-patches/ And Palm is not going to help you.]

#Type 'webos-kernels-testing' (without the quotes, and using lower case letters and hyphens only) in the NAME field of the NEW FEED section of the Manage Feeds screen accessible from the Preware application menu. If you make any error in this feed name, the URL below will not be replaced by the real URL when the device is rebooted, and you will not get access to the feeds. MAKE SURE YOU GET THE FEED NAME CORRECT!
#Put http://preware.is.awesome.com in the URL field. Note that this is not a real URL - it is a placeholder only. Again, you need to get the feed name correct for the real URL to be replaced correctly when the device is rebooted. Note: the actual URL that you type does not matter since it is placeholder URL.
#Leave the IS COMPRESSED toggled on.
#Hit "Add Feed" and read the disclaimer carefully. Yes, the things you might find in kernel testing feeds are likely to completely wipe your device without warning. Hit the Ok button only if you are prepared to lose all your data and destroy your device without any regrets or complaints.
#Immediately reboot the device by simultaneously pressing the Opt, Sym and R keys on a Pre/Pixi, or by holding the lock/power button on a TouchPad until the option to Reset Device appears and choosing it. If you don't reboot the device, or if you only do a Luna Restart instead of a Device Reboot, then placeholder URL will not be replaced by the real URL and you will not get access to the feeds. MAKE SURE YOU REBOOT THE DEVICE!
#Wait for the device to boot. If you got the feed name correct, the placeholder URL will be replaced by the real feed URL automatically.
#Open Preware, and hit Update Feeds. Make sure you have a working network connection for this.

Preware will repair the URL field automatically when the device boots. Did I mention that you have to get the feed name precisely correct for this to happen? MAKE SURE YOU GET THE FEED NAME CORRECT AND REBOOT THE DEVICE!

You must be running Preware 1.1.4 or later for this to work (yes, this has been possible for quite some time).

Testing Feeds

2011-09-11T13:51:56Z

Bgrambo: /* Kernel Testing Feeds */

=Rules that you must agree to before using these feeds=

Before you use our testing feeds, please read and agree to the following rules:
[[image:Tux_with_Warning.png|frameless|right]]
# Anyone participating in WebOS Internals alpha testing of any kind must be prepared to fully erase and webOS Doctor their device at a moment's notice without warning and without any regrets or complaints.
# They must be prepared to and able to log into the command line on the device and type Linux commands when instructed to do so. Knowing Linux commands ahead of time is preferred, but not required if you are willing to learn them when necessary or can follow instructions without making mistakes.
# They must be prepared to go to great and extraordinary lengths to try and reliably reproduce any problems they encounter.
# They must give full and detailed bug reports, leaving out no piece of information which could possibly be remotely connected to the problem.
# They must read any and all documentation and forums threads (in their entirety) before asking a question.
# They must fastidiously follow the forum threads where the alpha testing is being discussed by the authors, and follow precisely any instructions given there.
# They will never post the raw testing feed URLs anywhere, but will always refer others directly to this page using only the URL "http://testing.preware.org/"
# When asking for help, they will include the phrase (which may change occasionally) "I've read the rules". Failure to include the phrase will result in the request for help being silently ignored.

If you're not prepared to do *all* the above, and do it all in good spirit, then please wait for the public release of the item.

If you are prepared to do *all* the above, then by all means please participate in the alpha testing.

Note that everything above is a function of attitude, not of skill.

Testing feeds for kernels are at the bottom of this page.

=Configuring the WebOS Internals Testing Feeds=

===Using Preware===
[[image:Tux_with_Pre.png|frameless|right]]
With Preware versions 0.9.30 and above, incombination with webOS 1.3.5 and above, users are now able to add custom feeds through Preware without the use of a computer. The following instructions will explain how to add the Webos-Internals Testing feeds.

Note that you will need to enable *TWO* feeds below. You need the *ALL* feed and you need the device-specific feed as well (armv7, armv6 or i686).

{| border="0" width="470"
|colspan="2" align="left"|'''Target Device:''' ALL
|-
|'''Name:'''||webos-testing-all
|-
|'''URL:'''||[http://ipkg.preware.org/feeds/webos-internals/testing/all/ http://ipkg.preware.org/feeds/webos-internals/testing/all]
|-
|} 
{| border="0" width="470"
|-
|colspan="2" align="left"|'''Target Device:''' <nowiki>Pre/Pre+/Pre2/Veer/TouchPad/Pre3</nowiki>
|-
|'''Name:'''||webos-testing-armv7
|-
|'''URL:'''||[http://ipkg.preware.org/feeds/webos-internals/testing/armv7/ http://ipkg.preware.org/feeds/webos-internals/testing/armv7]
|-
|} 
{| border="0" width="470"
|-
|colspan="2" align="left"|'''Target Device:''' <nowiki>Pixi/Pixi+</nowiki>
|-
|'''Name:'''||webos-testing-armv6
|-
|'''URL:'''||[http://ipkg.preware.org/feeds/webos-internals/testing/armv6/ http://ipkg.preware.org/feeds/webos-internals/testing/armv6]
|-
|} 
{| border="0" width="470"
|-
|colspan="2" align="left"|'''Target Device:''' Palm SDK Emulator
|-
|'''Name:'''||webos-testing-i686
|-
|'''URL:'''||[http://ipkg.preware.org/feeds/webos-internals/testing/i686/ http://ipkg.preware.org/feeds/webos-internals/testing/i686]
|}
 
#Open Preware and wait for it to finish loading.
#Open the App Menu (tap "Preware" in the top left corner of the screen) and tap Manage feeds.
#Scroll to the bottom until you see the New Feed box.
#Type or paste a name and corresponding URL from above in the appropriate text boxes. Make sure the URL does *not* have a slash at the end.
#Make sure the IS COMPRESSED option is set to YES.
#Tap Add Feed and then tap Yes when the alert pops up.
#Repeat these steps for each feed you wish to enable.
#Gesture swipe back. Preware will alert you that you have added feeds and ask if you want to update them now. Choose YES.
 
Congratulations, you have just added a custom feed! For adding other feeds, be sure to replace the name and URL in these instructions with the proper name and URL.
 
'''TIP:'''

shift+tap (and drag) on text to select
gesture+c to copy
gesture+v to paste
Make sure to delete 'http://' before pasting the URL if the URL already contains 'http://'

 

===Using a Computer===
[[image:Tux_Chat.png|frameless|right]]
1. Gain access to the shell, either through novaterm/ssh or via the terminal application available through the regular WebOS Internals Feed 
2. Execute the following commands:
<pre>
cd /media/cryptofs/apps/etc/ipkg
echo "src/gz webosinternals-testing http://ipkg.preware.org/feeds/webos-internals/testing/all" > webos-internals-testing.conf
echo "src/gz webosinternals-testing-armv7 http://ipkg.preware.org/feeds/webos-internals/testing/armv7" >> webos-internals-testing.conf
</pre>
3. Once Preware is launched, select "Update Feeds" from the Application Menu.

Replace 'armv7' with 'armv6' or 'i686' in the instructions above if you are using a Pixi or the Emulator respectively.

 
=Kernel Testing Feeds=
[http://www.webos-internals.org/index.php?title=Testing_Feeds&action=submit#Rules_that_you_must_agree_to_before_using_these_feeds Re-read the rules above before continuing.]
Also see http://forums.precentral.net/2532084-post3.html for further warnings up to and including your device wiping itself, (literally) melting, and/or eating your kitten.

If you do not want a puddle of molten plastic and silicon where your Pre/Pixi once was, DO NOT CONTINUE.

You have been warned.

[http://developer.palm.com/blog/2010/03/a-statement-on-the-overclocking-patches/ And Palm is not going to help you.]

#Type 'webos-kernels-testing' (without the quotes, and using lower case letters and hyphens only) in the NAME field of the NEW FEED section of the Manage Feeds screen accessible from the Preware application menu. If you make any error in this feed name, the URL below will not be replaced by the real URL when the device is rebooted, and you will not get access to the feeds. MAKE SURE YOU GET THE FEED NAME CORRECT!
#Put http://preware.is.awesome.com in the URL field. Note that this is not a real URL - it is a placeholder only. Again, you need to get the feed name correct for the real URL to be replaced correctly when the device is rebooted. Note: the actual URL that you type does not matter since it is placeholder URL.
#Leave the IS COMPRESSED toggled on.
#Hit "Add Feed" and read the disclaimer carefully. Yes, the things you might find in kernel testing feeds are likely to completely wipe your device without warning. Hit the Ok button only if you are prepared to lose all your data and destroy your device without any regrets or complaints.
#Immediately reboot the device by simultaneously pressing the Opt, Sym and R keys on a Pre/Pixi, or by holding the lock/power button on a TouchPad until the option to Reset Device appears and choosing it. If you don't reboot the device, or if you only do a Luna Restart instead of a Device Reboot, then placeholder URL will not be replaced by the real URL and you will not get access to the feeds. MAKE SURE YOU REBOOT THE DEVICE!
#Wait for the device to boot. If you got the feed name correct, the placeholder URL will be replaced by the real feed URL automatically.
#Open Preware, and hit Update Feeds. Make sure you have a working network connection for this.

Preware will repair the URL field automatically when the device boots. Did I mention that you have to get the feed name precisely correct for this to happen? MAKE SURE YOU GET THE FEED NAME CORRECT AND REBOOT THE DEVICE!

You must be running Preware 1.1.4 or later for this to work (yes, this has been possible for quite some time).