|
|
| (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.
| + | |
