Community
Participate
Working Groups
We are in the middle of a major API update and migration as we move from Mylyn 2.x to Mylyn 3.0. We have recommended that integrators watch the Mylyn Porting Guide for details of API updates. We will also use this bug to communicate relevant milestones along the path. Our schedule is still unchanged from the original Mylyn 3.0 Plan, meaning that we expect a first cut at the revised APIs by May 7th and a freeze by June 4th. Please feel free to post any questions about the changes or porting. Also see: * http://wiki.eclipse.org/Mylyn_Porting_Guide * http://wiki.eclipse.org/index.php/Mylyn_3.0_Plan (the Themes section still has some changes in progress) * All bugs marked with a 3.0 milestone, in particular bugs tagged [api]
Mylyn currently has a large number of "Discouraged access" and deprecation warnings. As we get closer to the RC0 date these will shrink in number. We recommend that integrators avoid porting or addressing warnings until after the API freeze.
A more detailed RC schedule is now listed at: http://wiki.eclipse.org/index.php/Mylyn_3.0_Plan#Schedule
Please note that we recommend using and building against Mylyn 2.3 until Mylyn 3.0RC1 is available (May 21st).
*** Bug 196511 has been marked as a duplicate of this bug. ***
Mylyn 3.0RC1 is available: http://www.eclipse.org/mylyn/downloads/ For a status summary and recommendations on how to proceed with porting see my blog entry: http://tasktop.com/blog/?p=29
RC update sites: * download.eclipse.org/tools/mylyn/update/dev/e3.4 * download.eclipse.org/tools/mylyn/update/dev/e3.3 * download.eclipse.org/tools/mylyn/update/dev/extras
Steffen and I just did the following clean-up. In most cases connectors should not be affected as these methods should only be used by the framework. ITask: * removed: setCompleted() * removed: isPastReminder() * removed: isSubmitting() * removed: isSynchronizing() * getErrorStatus() -> AbstractTask.getStatus() TaskJob: * getErrorStatus() -> getStatus() TaskRepository: * getErrorStatus() -> getStatus()
We have completed the final review of the Tasks API and did the following finessing. Most connectors should not be affected. If you ported and were using ITaskElement you should use IRepositoryElement in its place. We still have to do a pass at the Javadocs. Additional changes will only be made to correct any major omissions identified by integrators. If you haven't started porting yet we suggest waiting until tomorrow evening's build is ready (we'll notify on this bug). Steffen: please incorporate the list below into the porting guide. I'll make a class diagram when we work on the docs. ITaskElement -> IRepositoryElement and ITaskContainer ITaskRepositoryManager -> IRepositoryManager TasksUi.getTasksModel() -> getRepositoryModel() ITasksModel -> IRepositoryModel TaskRepositoryAdapter -> removed, use IRepositoryListener ITaskListChangeListener -> removed, was not API * ITaskRepositoryManager -> IRepositoryManager ITaskRepositoryListener -> IRepositoryListener * removed repositoriesRead() AbstractRepositoryConnectorUi * isCustomNotificationHandling -> hasCustomNotifications * forceSubtaskHierarchy -> hasStrictSubtaskHierarchy * getReply -> getReplyText * openRepositoryTask -> moved to TasksUiUtilInternal (no longer needed) * getTaskListElementIcon -> getImageDescriptor * removed: getKindLabel (use label provider) WebHyperlink: removed (only used by Trac, no longer needed) org.eclipse.mylyn.tasks.ui.repositories extension point: * removed connector.userManaged, use class instead * removed connectorUi.customNotifications, use class instead
Here are the last of my API changes: TaskData.getVersion() will now return null if no version has been set (it returned "1.0" previously). Connectors that implement AbstractTaskDataManger.migrate() should handle that appropriately. Other changes: AbstractRepositoryConnector.hasChanged() -> AbstractRepositoryConnector.hasTaskChanged() AbstractRepositioryConnectorUi.supportsDueDates() -> AbstractRepositoryConnector.hasRepositoryDueDate() ITaskDataManger -> removed putUpdatedTaskData() and putSubmittedTaskData(), this is now handled by ISynchronizationSession
A couple of small TasksUi changes done last Friday, did not affect any known connectors: * removed getConnector() -> getRepositoryConnector() * getConnectorUi() -> getRepositoryConnectorUi()
Made extension points in org.eclipse.mylyn.tasks.bugs internal and moved API class into provisional package. Other changes: IRepositoryModel: removed createTaskComment() and createTaskAttachment() ITaskMapping: copyFrom() -> merge()
The following minor changes have been committed to Context API. No clients should be affected. * IDegreeOfSeparation: moved to internal (only used by internals and Sandbox) * ContextUi.ID_CONTEXT_PAGE: moved to ContextUiPlugin (not used by known clients) * removed deprecated methods
Additional changes that remove unused API: AbstractTaskFormPage: isExpandAttributeSection() and setExpandAttributeSection() have been removed. AbstractAttributeEditor: MAXIMUM_HEIGHT, MAXIMUM_WIDTH and TEXT_FONT have been moved to EditorUtil.
AbstractTaskEditorPageFactory.createPage() now returns IFormPage instead of FormPage. This change does not break binary compatibility.
Done a while back. The updated porting guide is at: http://wiki.eclipse.org/Mylyn/Porting_Guide/3.0
