Difference between revisions of "Application:Preware"
(updated for wosqi 4.2.0)
m (updating bootstrap location)
|Line 131:||Line 131:|
Revision as of 23:06, 24 July 2011
This page is currently available in four languages:
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.
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.
Install / Remove / Update:
- Homebrew Applications including advanced applications with special requirements.
- WebOS Themes
- webOS Kernels
- Support for installation of signed packages
Preware has been upgraded to release status, and is no longer considered beta.
Some milestones worth mentioning in Preware's history include:
- Since 27 August 2009 it is the only over-the-air installer for the palm capable of installing advanced palm applications such as the On Screen Keyboard or the terminal application.
- Since 27 August 2009 it is the only application supporting installation from all existing palm homebrew feeds.
- Since 17 September 2009 it also supports installation of themes.
- Since 8 October 2009 it also supports installation of webOS patches.
- Since 12 Jan 2010 it also supports all Palm App Catalog feeds.
- Since 3 May 2010 it also supports installation of webOS custom kernels.
- Since 20 July 2010 it also supports installation of packages from URLs and local files.
- Since 24 July 2010 is also supports blacklisting packages and authors.
- Since 8 June 2011 access to webOS app catalog feeds is no longer available to third party developers or applications.
Please be aware that org.webosinternals.preware is licensed under the GPLv2.
Code from Preware cannot be used by a closed source application. If you want to use them in a non-GPLv2 but otherwise open source application, please contact the authors.
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 WebOS Quick Install to install Preware on any device easily and quickly, without the need to download a big 200MB SDK and webOSDoctor.
Latest Version of WebOS Quick Install available here: WebOS Quick Install v4.2.0
- Install the required Software
- Put your device in 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: Preware Standalone Installers. These instructions are currently only for Mac and PC users.
- Install the required software.
- Click here to verify that you have the latest version of Java installed on your computer and update it if needed.
- 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 Developer Mode.
- Windows users: When connecting your device to the computer for the first time, you will be prompted to install new hardware. Click Next to start the device installation. You may get a message regarding Novacom drivers not being installed. If so, you can disregard it. Once your device is installed, proceed with the Preware installation.
- Download the Preware Standalone Installer (you should choose the latest file name PrewareInstaller-X.Y.Z.jar) and place it in the same directory as the webOS Doctor .jar file.
- Run the Preware Installer.
- Click on the Tools menu and choose Install Drivers. This will install the Palm Novacom drivers for webOS devices.
- Once the drivers have finished installing, click on Install Preware. After Preware is installed, your device will be unresponsive for a few seconds while Luna restarts.
Installing Preware from the Commandline
If you have access to the command line of your webOS Device or emulator using Terminal, Novaterm, the "Linux Commandline" in WebOS Quick Install, or other techniques, you can install Preware by typing three lines. This technique is always the shortest and in many ways the simplest, but if you are in any way unsure of operating at the Linux command line, please use either of the methods described above.
<source lang="bash"> cd /tmp wget http://gitorious.org/webos-internals/bootstrap/blobs/raw/master/preware-bootstrap.sh sh preware-bootstrap</source>
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.
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.
|You can select preferences in the top left corner of the Pre to bring up the preferences screen. On the Preferences screen you can specify the look of the application, the frequency that feeds are updated, and what Preware will show you by default.
|In the 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).
|See Testing Feeds for detailed instructions on adding custom feeds.|
|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.|
|There are a few ways to select and install a "package" (application/patch/theme/etc.). Using "List of Everything" would be the simplest.
|Removing a package is just as easy.
Blacklist (Category Filters)
|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.
No known limitations.
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 firstname.lastname@example.org