TS 61 PluginInstallation

NetBeans Plugin Installation Test Specification

Author: Jaromir Uhrik
Last update: Feb 08, 2008
Introduction: It is necessary to test plugin installation into NetBeans IDE before it is placed on any NetBeans Update Center and made available to whole NetBeans community. It is module author responsibility to make sure the module does not break IDE or affects badly other modules. This test-specification describes basic steps how the module should be tested before it may be included on Update Center.

Contents


Test suite: Install from local .NBM files

Purpose: The NetBeans Plugin Manager provides installation of a plugin from local .nbm file. This way of installation should be tested before the module goes to any Update Center.
Setup: Start NetBeans IDE with clean userdir, invoke main menu 'Tools|Plugins' to start Plugin Manager.


  1. Prepare .NBM
    1. Select 'Downloaded' tab.
    2. Push Add Plugins... button and browse desired plugin (.nbm file).
    3. Push filechooser's 'Open' button.
    • EXPECTED RESULT: In Downloaded tab there appears the added plugin in the list of plugins to install.
  1. Install .NBM
    1. Push Install button and proceed with the installation
    2. Push Finish button at the last panel of the installer
    • EXPECTED RESULT: If the plugin requires restart then select 'Restart IDE Now' before the Finish button is pushed at the last installer's panel - the restart proceeds then. The plugin is installed correctly and it appears in the Installed tab, vanishes from the Downloaded tab.
  1. Check plugin functionality
    1. Test that the functionality of installed plugin work fine.
    2. Try at least to create, compile and run some projects.
    3. Deactivate the installed plugin (in the Installed tab push the Deactivate button while the plugin is selected).
    4. Activate the plugin again.
    • EXPECTED RESULT: The plugin functionality should be available only in case that the plugin is Activated. No problem should appear during the work with NetBeans (no exceptions, no deadlocks or other suspicious behavior - all works properly).
  1. Restart IDE
    1. Select main menu File|Exit.
    2. Wait for IDE exit and run it again (with the same userdir).
    • EXPECTED RESULT: The previously installed plugin is enabled, works fine and other plugins don't have corrupted functionality. All plugins that have been Activated/Deactivated stay in their proper status after the restart. Track carefully any breaks of IDE functionality.
  1. Uninstall plugin
    1. Select the installed plugin and push Uninstall button.
    2. The uninstall action requires restart.
    3. Select radio button Restart IDE Later and push Finish (so that the IDE doesn't restart).
    4. Restart IDE.
    • EXPECTED RESULT: The plugin disappears from the installed tab and appears in the Available Plugins.
  1. Test Help
    1. Test online help invocation (if your plugin provides any).
    • EXPECTED RESULT: The Help online dialog appears with the correct content.

Test suite: Install from staging and any production Update Center

Purpose: It is highly recommended to test the module installation from a staging Update Center before it is available on any production Update Center.
Setup: It is assumed that the plugin is available at any Staging Update Center (see How do I create own update center). Start NetBeans IDE with clean userdir, invoke main menu 'Tools|Plugins' to start Plugin Manager.

  1. Register staging update center in IDE
    1. Go to the Settings tab of plugin manager.
    2. Push Add button and fill in the URL of your staging update center.
    3. Push OK button.
    • EXPECTED RESULT: The update center appears in the list. Plugins from this update center appear in tab Available Plugins (or in Updates in case that the former version of the plugin is already installed.
  1. Plugin installation
    1. Select the plugin you want to install.
    2. Set the checkbox selected.
    3. Push Install button (or Update if you are installing an update).
    4. Proceed with the installer.
    5. Push Finish button
    • EXPECTED RESULT: If the plugin requires restart then select 'Restart IDE Now' before the Finish button is pushed at the last installer's panel - the restart proceeds then. The plugin is installed correctly and it appears in the Installed tab, vanishes from the Downloaded tab.
  1. Test Help
    1. Test online help invocation (if your plugin provides any).
    • EXPECTED RESULT: The Help online dialog appears with the correct content.
  1. Check plugin functionality
    1. Test that the functionality of installed plugin work fine.
    2. Try at least to create, compile and run some projects.
    3. Deactivate the installed plugin (in the Installed tab push the Deactivate button while the plugin is selected).
    4. Activate the plugin again.
    • EXPECTED RESULT: The plugin functionality should be available only in case that the plugin is Activated. No problem should appear during the work with NetBeans (no exceptions, no deadlocks or other suspicious behavior - all works properly).
  1. Uninstall plugin
    1. Select the installed plugin and push Uninstall button.
    2. The uninstall action requires restart.
    3. Select radio button Restart IDE Now and push Finish (so that the IDE restarts immediately).
    • EXPECTED RESULT: The plugin disappears from the installed tab and appears in the Available Plugins.

Generated: Feb 08 12:15:28 CET 2008

Not logged in. Log in, Register

By use of this website, you agree to the NetBeans Policies and Terms of Use. © 2012, Oracle Corporation and/or its affiliates. Sponsored by Oracle logo