Method Detail

• openInstallWizard

  public static boolean openInstallWizard​(org.netbeans.api.autoupdate.OperationContainer<org.netbeans.api.autoupdate.InstallSupport> container)

  Open standard dialog for installing set of modules. Shows it to the user, asks for confirmation, license acceptance, etc. The whole operation requires AWT dispatch thread access (to show the dialog) and blocks (until the user clicks through), so either call from AWT dispatch thread directly, or be sure you hold no locks and block no progress of other threads to avoid deadlocks.

  Single module installation can be handled easily by installSingle(java.lang.String, java.lang.String, java.lang.Object[]).

  OperationContainer container = OperationContainer.createForInstall();
  for (UpdateUnit u : UpdateManager.getDefault().getUpdateUnits(UpdateManager.TYPE.MODULE)) {
      if (u.getCodeName().matches("org.my.favorite.module")) {
          if (u.getAvailableUpdates().isEmpty()) {
              continue;
          }
          container.add(u.getAvailableUpdates().get(0));
      }
  }
  PluginManager.openInstallWizard(container);
  

  Parameters:

  container - the container with list of modules for install

  Returns:

  true if all the requested modules were successfully installed, false otherwise.

  See Also:

  installSingle(java.lang.String, java.lang.String, java.lang.Object[]), install(java.util.Set, java.lang.Object[])

• openInstallWizard

  public static void openInstallWizard​(org.netbeans.api.autoupdate.OperationContainer<org.netbeans.api.autoupdate.InstallSupport> container,
                                       boolean runInBackground)

  Open standard dialog for installing set of modules. Shows it to the user, asks for confirmation, license acceptance, etc. The whole operation requires AWT dispatch thread access (to show the dialog) and blocks (until the user clicks through), so either call from AWT dispatch thread directly, or be sure you hold no locks and block no progress of other threads to avoid deadlocks.

  Parameters:

  container - the container with list of modules for install

  runInBackground - if true then installation run in the background after license acceptance

• installSingle

  @CheckForNull
  public static java.lang.Object installSingle​(@NonNull
                                               java.lang.String codenamebase,
                                               @NonNull
                                               java.lang.String displayName,
                                               @NonNull
                                               java.lang.Object... alternativeOptions)

  Open standard dialog for installing a module including declared dependencies. Shows it to the user, asks for confirmation, license acceptance, etc. The whole operation requires AWT dispatch thread access (to show the dialog) and blocks (until the user clicks through), so either call from AWT dispatch thread directly, or be sure you hold no locks and block no progress of other threads to avoid deadlocks.

  Parameters:

  codenamebase - the codenamebase of module to install

  displayName - the display name of the module

  alternativeOptions - alternative options possibly displayed in error dialog user may choose if it is not possible to install the plugin; if chosen the option is return value of this method

  Returns:

  null if the module has been successfully installed and/or activated, otherwise it returns the options user has selected in problem dialog, typically NotifyDescriptor.DEFAULT_OPTION (on esc), NotifyDescriptor.CANCEL_OPTION or any of alternativeOptions.

  Since:

  1.35

  See Also:

  install(java.util.Set, java.lang.Object[])

• install

  @CheckForNull
  public static java.lang.Object install​(@NonNull
                                         java.util.Set<java.lang.String> codenamebases,
                                         @NonNull
                                         java.lang.Object... alternativeOptions)

  Open standard dialog for installing modules including declared dependencies. Shows it to the user, asks for confirmation, license acceptance, etc. The whole operation requires AWT dispatch thread access (to show the dialog) and blocks (until the user clicks through), so either call from AWT dispatch thread directly, or be sure you hold no locks and block no progress of other threads to avoid deadlocks.

  Parameters:

  codenamebases - the codenamebases of modules to install; must contain at least one codenamebase

  alternativeOptions - alternative options possibly displayed in error dialog user may choose if it is not possible to install the plugin; if chosen the option is return value of this method

  Returns:

  null if all the requested modules have been successfully installed and/or activated, otherwise it returns the options user has selected in problem dialog, typically NotifyDescriptor.DEFAULT_OPTION (on esc), NotifyDescriptor.CANCEL_OPTION or any of alternativeOptions.

  Throws:

  java.lang.IllegalArgumentException - if the codenamebases is empty

  Since:

  1.35