Mylyn/Porting Guide

This document will have Mylar 2.0 specific API changes added to it as we make them. If interested in keeping up with these changes we suggest setting a watch for this page. Note that changes involving classes moving packages are not listed, use Organize Imports to resolve.

Porting from 1.0 to 2.0

See the Mylyn Porting Guide 2.0

Porting from 2.0 to 3.0

There is currently no need to port Mylyn from the 2.0 APIs since current Mylyn releases are backwards compatible. Throughout the 2.x release cycle we will be using this wiki to gather changes and suggestions for improving the APIs for 3.0.

Tasks API

• AbstractRepositoryConnector
  • isRepositoryConfigurationStale(TaskRepository) has been added

• AbstractRenderingEngine has been added for converting Wiki syntax to HTML

• AbstractRepositoryTaskEditor has been extended to provide HTML preview capabilities for repositories that support Wiki syntax in ticket descriptions and comments
  • addSelectableControl(): added
  • createReplyHyperlink() is now protected (was private)
  • DescriptionListener is now protected (was private)
  • getParentEditor(): added
  • getRenderingEngine(): added
  • removeSelectableControl(): added
  • fillToolBar(..): added

• TaskEditor
  • class no longer final (experimental extensibility)

• TaskListManager
  • resolveIdentifiersConflict() has been added

• TaskTextViewerConfiguration has been added (former name was RepositoryViewerConfig)

Pending Changes for Mylyn 3.0

• Rename IMylarMonitorLifecycleListener to IMonitorLifecycleListener
• Rename MockRepositoryTask to MockTask
• Refactor TaskActivationHistory into a TaskActivityManager that encapsulates both activity monitoring and activation history