Difference between revisions of "Testing Feeds"

From WebOS Internals
Jump to navigation Jump to search
 
(69 intermediate revisions by 3 users not shown)
Line 2: Line 2:
 
:[[Image:Australia.png]] [[Image:USA.png]] [[Testing_Feeds]]
 
:[[Image:Australia.png]] [[Image:USA.png]] [[Testing_Feeds]]
 
:[[Image:Germany.png]] [[Testing_Feeds-DE]]
 
:[[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 needed 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 complete.  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 are automatically removed from your Preware configuration.
  
 
=Rules that you must agree to before using these feeds=
 
=Rules that you must agree to before using these feeds=
Line 7: Line 21:
 
Before you use our testing feeds, please read and agree to the following rules:
 
Before you use our testing feeds, please read and agree to the following rules:
 
[[image:Tux_with_Warning.png|frameless|right]]
 
[[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.
+
# 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 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 be prepared to go to great and extraordinary lengths to try and reliably reproduce any problems they encounter.
Line 13: Line 27:
 
# They must read any and all documentation and forums threads (in their entirety) before asking a question.
 
# 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 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/"
+
# 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.
 
# 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'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.
+
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.
 
Note that everything above is a function of attitude, not of skill.
  
−
Testing feeds for kernels are at the bottom of this page.
+
=How to only use safe stable feeds=
 +
 
 +
If you are one of the people who were told to use testing feeds by some article or forum post, but are really not actively testing anything, then you should do the following to revert your Preware configuration to only using safe stable feeds:
 +
 
 +
# Open Preware
 +
# Go to the Manage Feeds page
 +
# Swipe to delete any feed which has "testing" anywhere in the name
 +
 
 +
Note that this does not affect any packages that you have already installed on your device.
  
−
=Configuring the WebOS Internals Testing Feeds=
+
If you have done this, and want to stick with safe stable feeds only, you can stop here. The rest of this page is not relevant to you and you should not do anything else on this page after this point.
  
−
===Using Preware===
+
= Enabling the Beta Testing Feeds =
  
−
[[image:Tux_with_Pre.png|frameless|right]]
+
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.
  
−
If you are using Preware version 1.8.0 or later, please refer to the Alpha and Beta Feeds section below.
+
[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.]
  
−
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).
+
[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/"'''''
 +
 
 +
Being able to gain access to the command line using novaterm or Xecutah and being able to reinstall Preware are important obligations for anyone who participates in beta testing.
 +
 
 +
To enable the beta testing feeds, you must do the following:
 +
 
 +
:1. Uninstall Preware.  Yes, seriously. You must uninstall Preware. This will not affect any other packages that you have installed.
 +
 
 +
:2. Gain access to the Linux command line on your device and run the following two commands.
 +
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].
 +
 
 +
:5. Donate to WebOS Internals http://donate.webos-internals.org and http://bit.ly/phd-ac
 +
 
 +
'''''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/"'''''
  
−
{| border="0" width="470"
+
=Disabling the Beta Feeds=
−
|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]
 
−
|-
 
−
|}<BR>
 
−
{| 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]
 
−
|-
 
−
|}<BR>
 
−
{| 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]
 
−
|-
 
−
|}<BR>
 
−
{| 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]
 
−
|}
 
−
<BR>
 
−
#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.
 
−
<BR>
 
−
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.
 
−
<BR>
 
−
'''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://'
 
  
−
<BR>
+
To temporarily disable the beta feeds, simply set the toggle switch in the Preware Manage Feeds screen to Off for each feed.
  
−
===Using a Computer===
+
To permanently disable the beta feeds, you must do the following:
  
−
[[image:Tux_Chat.png|frameless|right]]
+
:1. Gain access to the Linux command line on your device and run the command.
 +
rm -f /var/preferences/org.webosinternals.preware/enable-beta-feeds
  
−
If you are using Preware version 1.8.0 or later, please refer to the Alpha and Beta Feeds section below.
+
:2. Swipe to delete all the beta-* feeds in the Preware Manage Feeds screen.
  
−
1. Gain access to the shell, either through novaterm/ssh or via the terminal application available through the regular WebOS Internals Feed<BR>
+
Note that if you do not remove the <code>enable-beta-feeds</code> file, the beta feeds will reappear the next time you install a new version of Preware.
−
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.
+
= Enabling the Alpha Testing Feeds =
  
−
<BR>
+
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.
  
−
=Kernel Testing Feeds=
+
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.
  
−
If you are using Preware version 1.8.0 or later, please refer to the Alpha and Beta Feeds section below.
+
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#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.
+
[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/"'''''
  
−
You have been warned.
+
Being able to gain access to the command line using novaterm or Xecutah and being able to reinstall Preware are important obligations for anyone who participates in alpha testing.
  
−
[http://developer.palm.com/blog/2010/03/a-statement-on-the-overclocking-patches/ And Palm is not going to help you.]
+
To enable the alpha testing feeds, you must do the following:
  
 +
:1. Uninstall Preware.  Yes, seriously. You must uninstall Preware. This will not affect any other packages that you have installed.
  
−
#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!
+
:2. Gain access to the Linux command line on your device and run the following two commands.
−
#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.
+
mkdir -p /var/preferences/org.webosinternals.preware
−
#Leave the IS COMPRESSED toggled on.
+
  touch /var/preferences/org.webosinternals.preware/enable-alpha-feeds
−
#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!
+
:3. Install Preware 1.8.3 or later.
  
−
You must be running Preware 1.1.4 or later for this to work (yes, this has been possible for quite some time).
+
: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].
  
−
= Alpha and Beta Feeds =
+
:5. Donate to WebOS Internals http://donate.webos-internals.org and http://bit.ly/phd-ac
  
 
'''''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/"'''''
 
'''''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/"'''''
  
−
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.  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.
+
=Disabling the Alpha Feeds=
 +
 
 +
To temporarily disable the alpha feeds, simply set the toggle switch in the Preware Manage Feeds screen to Off for each feed.
 +
 
 +
To permanently disable the alpha feeds, you must do the following:
 +
 
 +
:1. Gain access to the Linux command line on your device and run the following command.
 +
  rm -f /var/preferences/org.webosinternals.preware/enable-alpha-feeds
 +
 
 +
:2. Swipe to delete all the alpha-* feeds in the Preware Manage Feeds screen.
 +
 
 +
Note that if you do not remove the <code>enable-alpha-feeds</code> file, the alpha feeds will reappear the next time you install a new version of Preware.
 +
 
 +
=Testing Feeds Q&A=
 +
 
 +
'''Q: Who should use the Alpha testing feeds?'''
  
−
'''''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/"'''''
+
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).
  
−
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.
+
'''Q: Why does enabling the feeds require connecting my device to a computer?'''
  
−
'''''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/"'''''
+
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.
  
−
[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.]
+
'''Q: Why does enabling the feeds require reinstalling Preware?'''
  
−
'''''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/"'''''
+
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.
  
−
To enable the alpha testing feeds, you must do the following:
+
'''Q: Why does enabling the feeds require the use of the Linux command line?'''
  
−
'''''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/"'''''
+
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.
  
−
# Uninstall Preware.  Yes, seriously. You must uninstall Preware.
+
'''Q: Why can't I just enter in the feed URLs directly?'''
−
# Gain access to the Linux command line on your device. If you do not already know how to do this, 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
 
−
# reboot
 
−
# Install Preware.
 
  
−
'''''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/"'''''
+
A: Too many people got the feed names or feed URLs wrong, so we took those things out of the equation.
  
−
To enable the beta testing feeds, you must do the following:
+
'''Q: Why can't I publish the instructions on my blog or website or forum post?'''
  
−
'''''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/"'''''
+
A: Too many people were publishing the URLs without the corresponding rules and warnings. This is now strictly forbidden.
  
−
# Uninstall Preware.  Yes, seriously. You must uninstall Preware.
+
'''Q: What are the alpha-patches and beta-patches feeds going to be used for?'''
−
# Gain access to the Linux command line on your device. If you do not already know how to do this, 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
 
−
# reboot
 
−
# Install Preware.
 
  
−
'''''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/"'''''
+
A: The alpha-patches feed will be used for testing new AUPT scripts which will be able to handle patching files in <code>/media/cryptofs/apps/</code> (files not inside <code>/md5sums</code>). 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.

Latest revision as of 22:57, 28 September 2011

This page is currently available in two languages:

Australia.png USA.png Testing_Feeds
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:

  1. We needed to separate out bleeding-edge unstable alpha testing packages from generally benign beta testing packages. The old testing feeds did not allow this distinction.
  2. 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.
  3. 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 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 complete. 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 are 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:

Tux with Warning.png
  1. 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.
  2. 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.
  3. They must be prepared to go to great and extraordinary lengths to try and reliably reproduce any problems they encounter.
  4. They must give full and detailed bug reports, leaving out no piece of information which could possibly be remotely connected to the problem.
  5. They must read any and all documentation and forums threads (in their entirety) before asking a question.
  6. They must fastidiously follow the forum threads where the alpha testing is being discussed by the authors, and follow precisely any instructions given there.
  7. 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/"
  8. 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.

How to only use safe stable feeds

If you are one of the people who were told to use testing feeds by some article or forum post, but are really not actively testing anything, then you should do the following to revert your Preware configuration to only using safe stable feeds:

  1. Open Preware
  2. Go to the Manage Feeds page
  3. Swipe to delete any feed which has "testing" anywhere in the name

Note that this does not affect any packages that you have already installed on your device.

If you have done this, and want to stick with safe stable feeds only, you can stop here. The rest of this page is not relevant to you and you should not do anything else on this page after this point.

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.

Re-read the rules above before continuing.

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/"

Being able to gain access to the command line using novaterm or Xecutah and being able to reinstall Preware are important obligations for anyone who participates in beta testing.

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

1. Uninstall Preware. Yes, seriously. You must uninstall Preware. This will not affect any other packages that you have installed.
2. Gain access to the Linux command line on your device and run the following two commands.
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 read this.
5. Donate to WebOS Internals http://donate.webos-internals.org and http://bit.ly/phd-ac

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/"

Disabling the Beta Feeds

To temporarily disable the beta feeds, simply set the toggle switch in the Preware Manage Feeds screen to Off for each feed.

To permanently disable the beta feeds, you must do the following:

1. Gain access to the Linux command line on your device and run the command.
rm -f /var/preferences/org.webosinternals.preware/enable-beta-feeds
2. Swipe to delete all the beta-* feeds in the Preware Manage Feeds screen.

Note that if you do not remove the enable-beta-feeds file, the beta feeds will reappear the next time you install a new version of Preware.

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.

Re-read the rules above before continuing.

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/"

Being able to gain access to the command line using novaterm or Xecutah and being able to reinstall Preware are important obligations for anyone who participates in alpha testing.

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

1. Uninstall Preware. Yes, seriously. You must uninstall Preware. This will not affect any other packages that you have installed.
2. Gain access to the Linux command line on your device and run the following two commands.
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 read this.
5. Donate to WebOS Internals http://donate.webos-internals.org and http://bit.ly/phd-ac

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/"

Disabling the Alpha Feeds

To temporarily disable the alpha feeds, simply set the toggle switch in the Preware Manage Feeds screen to Off for each feed.

To permanently disable the alpha feeds, you must do the following:

1. Gain access to the Linux command line on your device and run the following command.
rm -f /var/preferences/org.webosinternals.preware/enable-alpha-feeds
2. Swipe to delete all the alpha-* feeds in the Preware Manage Feeds screen.

Note that if you do not remove the enable-alpha-feeds file, the alpha feeds will reappear the next time you install a new version of Preware.

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/ (files not inside /md5sums). 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.

Retrieved from "http://wiki.webos-internals.org/index.php?title=Testing_Feeds&oldid=19241"