|
|
(13 intermediate revisions by 5 users not shown) |
Line 1: |
Line 1: |
− | This page explains how to write useful bug reports for RAP
| + | Moved to the [http://eclipse.org/rap/bugs/ RAP Bugs page] |
− | | + | |
− | == Before you submit a bug ==
| + | |
− | | + | |
− | === Check whether it's working with SWT / RCP ===
| + | |
− | | + | |
− | We provide strict subsets of SWT, JFace and Workbench bundles. Thus, things should work just as they do in SWT and RCP.
| + | |
− | If you find that RAP does not work as you expect in some point, please make sure that the same code works with SWT / RCP.
| + | |
− | If you see the same problem in the original, then it is not a RAP bug.
| + | |
− | | + | |
− | == Where to submit ==
| + | |
− | | + | |
− | Start here: [http://www.eclipse.org/rap/bugs.php]
| + | |
− | | + | |
− | == What to Include in the Bug Report ==
| + | |
− | | + | |
− | === Bug Description ===
| + | |
− | | + | |
− | The bug description should be as short and exact as possible.
| + | |
− | It should contain:
| + | |
− | * Your environment (operating system, browser type and version, RAP version)
| + | |
− | * The steps to reproduce the behavior described
| + | |
− | * The expected outcome / solution
| + | |
− | | + | |
− | === Provide a Code Snippet ===
| + | |
− | | + | |
− | If the bug only occurs under certain circumstances, it's helpful if you can provide a snippet to reproduce.
| + | |
− | * The snippet should be as simple as possible.
| + | |
− | * The snippet should be self-contained (i.e. not rely on third-party code) and fit into one single class.
| + | |
− | * The snippet should be runnable without hacking, i.e. it should implement IEntryPoint.
| + | |
− | | + | |
− | Example:
| + | |
− | public class ExampleSnippet implements IEntryPoint {
| + | |
− |
| + | |
− | public int createUI() {
| + | |
− | Display display = new Display();
| + | |
− | Shell shell = new Shell( display );
| + | |
− | shell.setLayout( new GridLayout() );
| + | |
− |
| + | |
− | final Label label = new Label( shell, SWT.PUSH );
| + | |
− | label.setText( "Label" );
| + | |
− | label.setLayoutData( new GridData( SWT.FILL, SWT.TOP, true, false ) );
| + | |
− |
| + | |
− | Button button = new Button( shell, SWT.PUSH );
| + | |
− | button.setText( "Test" );
| + | |
− | button.addSelectionListener( new SelectionAdapter() {
| + | |
− |
| + | |
− | public void widgetSelected( SelectionEvent e ) {
| + | |
− | label.setText( "Button pressed" );
| + | |
− | }
| + | |
− | } );
| + | |
− |
| + | |
− | while( !shell.isDisposed() ) {
| + | |
− | if( !display.readAndDispatch() ) {
| + | |
− | display.sleep();
| + | |
− | }
| + | |
− | }
| + | |
− | return 0;
| + | |
− | }
| + | |
− | }
| + | |
− | | + | |
− | === Provide a screenshot ===
| + | |
− | | + | |
− | Remember that we don't have your exact desktop environment and browser.
| + | |
− | If you describe some visual misbehavior, a screenshot helps us understand your problem.
| + | |
− | | + | |
− | The best image formats for screenshots is PNG or GIF.
| + | |
− | JPG is for photographs (is has lossy compression),
| + | |
− | uncompressed image formats like BMP, TIFF, etc. are just too big and take too long to download.
| + | |