qtmobility/dist/changes-1.0.0-beta1
changeset 1 2b40d63a9c3d
child 4 90517678cc4f
equal deleted inserted replaced
0:cfcbf08528c4 1:2b40d63a9c3d
       
     1 tQ Mobility 1.0.0-beta1 is a beta release. It contains a number of changes,
       
     2 including API improvements and bug fixes, since the Qt Mobility 1.0.0-tp2
       
     3 release. For more details, please refer to the online documentation included
       
     4 in this distribution. The documentation is also available online:
       
     5 
       
     6   http://qt.nokia.com/doc/qtmobility-1.0
       
     7 
       
     8 Some of the changes listed in this file include issue tracking numbers
       
     9 corresponding to tasks in the Qt Bug Tracker or the Merge Request queue
       
    10 of the public source repository.
       
    11 
       
    12 Qt Bug Tracker: http://bugreports.qt.nokia.com
       
    13 Merge Request:  http://qt.gitorious.org
       
    14 
       
    15 
       
    16 ****************************************************************************
       
    17 *                           General                                        *
       
    18 ****************************************************************************
       
    19 
       
    20 New features
       
    21 ------
       
    22 
       
    23  - SomeClass, SomeOtherClass
       
    24     * New classes for foo, bar and baz
       
    25 
       
    26 Optimizations
       
    27 ------
       
    28 
       
    29  - Optimized foo in QSomeClass
       
    30     * See list of Important Behavior Changes below
       
    31 
       
    32 
       
    33 ****************************************************************************
       
    34 *                   Important Behavior Changes                             *
       
    35 ****************************************************************************
       
    36 
       
    37  -
       
    38 
       
    39 
       
    40 ****************************************************************************
       
    41 *                          Library                                         *
       
    42 ****************************************************************************
       
    43 
       
    44 QtBearer
       
    45 ------
       
    46 
       
    47  - Various memory leaks.
       
    48  - Documentation fixes.
       
    49  - QNetworkSession API changes.
       
    50     * Renamed isActive() to isOpen().
       
    51     * Renamed property key "ActiveConfigurationIdentifier" to
       
    52       "ActiveConfiguration".
       
    53     * Renamed property key "UserChoiceConfigurationIdentifier" to
       
    54       "UserChoiceConfiguration".
       
    55     * bearerName() function moved to QNetworkConfiguration::bearerName().
       
    56  - Symbian
       
    57     * Add Symbian build time declarations to examples and tests (capabilities,
       
    58       UIDs etc).
       
    59  - Improved unit test coverage and stability.
       
    60 
       
    61 
       
    62 QtContacts
       
    63 ------
       
    64 
       
    65  - QContactManager (and QContactManagerEngine where applicable)
       
    66     * add QContactManager(QObject* parent) ctor
       
    67     * deprecate filterSupported(), add isFilterSupported()
       
    68     * deprecate synthesizeDisplayLabel(), add synthesizedDisplayLabel()
       
    69     * managerFeature - enums as powers of two (deprecation strategy?)
       
    70     * deprecate implementationVersion(), add managerVersion()
       
    71     * deprecate splitUri(), add parseUri()
       
    72     * deprecate contacts() functions, replace with contactIds() functions
       
    73     * add new contacts() functions which return QList<QContact> and can be limited to particular details
       
    74        - add a restrictToDefinitions/Fields parameter in contacts() and contact()
       
    75     * deprecate old batch saveContacts() and removeContacts() functions, replace with new ones
       
    76        - return bool, and take new param: map of int (input list index) to error which occurred for the item at that index
       
    77        - consistent with async request changes, clearer, and more consistent with single save/remove functions too.
       
    78 
       
    79  - QContactManagerEngine
       
    80     * deprecated request-related functions in QCME, replaced with better/cleaner ones
       
    81        - deprecated updateRequest() functions in QCME, replaced with:
       
    82           . updateContactFetchRequest()
       
    83           . updateContactSaveRequest()
       
    84           . updateContactRemoveRequest()
       
    85           . updateContactLocalIdFetchRequest()
       
    86           . updateDetailDefinitionSaveRequest()
       
    87           . updateDetailDefinitionRemoveRequest()
       
    88           . updateDetailDefinitionFetchRequest()
       
    89           . updateRelationshipSaveRequest()
       
    90           . updateRelationshipFetchRequest()
       
    91           . updateRelationshipRemoveRequest()
       
    92        - deprecated updateRequestStatus() and replace with a new updateRequestState() function.
       
    93        - state and results are now updated separately and a distinct signal is emitted for each.
       
    94 
       
    95  - QContactDetail
       
    96     * deprecate values(), add variantValues()
       
    97     * access constraints now in detail instead of definition (set by backend on a per-detail basis)
       
    98        - possible constraints are now: ReadOnly, Irremovable, NoConstraint.  Deprecated CreateOnly constraint.
       
    99 
       
   100  - QContactDetailDefinition
       
   101     * deprecate fields() returning nonconst reference. (To be removed after transition period has elapsed).
       
   102     * Rename QContactDetailDefinitionField class to QContactDetailFieldDefinition (deprecated via typedef).
       
   103 
       
   104  - QContactAction
       
   105     * deprecate metadata(), add metaData()
       
   106 
       
   107  - QContactDetails
       
   108     * Deprecate QContactGeolocation, add QContactGeoLocation
       
   109     * QContactName -> deprecate first() add firstName(), same for middle() and last().
       
   110     * QContactOnlineAccount -> added Capabilities (string list) field
       
   111 
       
   112  - QContactAbstractRequest and leaf classes
       
   113     * QContactDetailDefinitionFetchRequest: deprecated names()/setNames, add definitionNames()/setDefinitionNames()
       
   114     * Deprecate Status enum, add State enum (values suffixed by State; eg, ActiveState)
       
   115     * deprecate status(), add state()
       
   116     * deprecate waitForProgress() -- to be removed (unnecessary API).
       
   117     * add stateChanged() signal to base class
       
   118     * deprecate progress() signal, add resultsAvailable() signal to base class
       
   119        - note that resultsAvailable() signal does not contain a ptr to self - use sender() instead.
       
   120        - state and results are now updated separately in the backend, with distinct signal emitted for each.
       
   121     * QContact*RemoveRequest -> take a list of items as input arguments, instead of a filter / filtering values.
       
   122        - allows detailed error reporting for remove requests, and is more intuitive / simpler API.
       
   123        - current selection criteria functions in RemoveRequests have been deprecated.
       
   124        - this change affects QContactRemoveRequest, QContactDetailDefinitionRemoveRequest and QContactRelationshipRemoveRequest.
       
   125     * deprecated errors() function from base QContactAbstractRequest class
       
   126     * added errorMap() function to various leaf classes where that class' selection input is a list of items
       
   127        - errorMap() returns a map of input list index to an error which occurred for the item at that index.
       
   128  - SamplePhonebook
       
   129     * UI layout refactored to fit small screen better
       
   130 
       
   131 QtLocation
       
   132 ------
       
   133 
       
   134  - foo
       
   135     * bar
       
   136 
       
   137 QtMessaging
       
   138 ------
       
   139 
       
   140  - Wrap QMessageStore with QMessageManager.
       
   141     * In order to provide a consistent interface with other components
       
   142       of QtMobility that provide a central data manager interface, the
       
   143       existing QMessageStore interface is now private, and replaced in
       
   144       the public interface by the QMessageManager class.
       
   145     
       
   146       The new class provides exactly the same interface as the old class
       
   147       except that it is instantiated as a handle rather than accessed as
       
   148       a singleton.  Internally the handle object can be instantiated as
       
   149       needed, but in documentation or examples the class should be treated
       
   150       as if it were potentially expensive to create and destroy; this will
       
   151       give a consistent form of use for all Q{x}Manager classes between
       
   152       the various QtMobility projects.
       
   153     
       
   154       The old QMessageStore class is still used internally by the
       
   155       QMessageManager, so the latter class need not be reimplemented for
       
   156       multiple platforms.
       
   157 
       
   158  - Rename Q{X}Ordering to Q{X}SortOrder.
       
   159     * For increased consistency between QtMobility APIs.
       
   160 
       
   161  - Support ordering via a list of SortOrder objects.
       
   162     * For consistency with other QtMobility APIs, allow a composite ordering
       
   163       to be specified using a list of Q{X}SortOrder objects rather than
       
   164       requiring the objects to be accumulated via the + operator.
       
   165 
       
   166  - Rename QMessageDataComparator::Options to MatchFlags.
       
   167 
       
   168  - Rename QMessageServiceAction to QMessageService.
       
   169     * The term 'action' is already used with conflicting meanings;
       
   170       it can represnt a user-input (QAction), or a facility provided
       
   171       by a service provider which is exposed to the user (as in
       
   172       QContactAction).
       
   173     
       
   174       QMessageService provides a proxy, dispatcher or broker
       
   175       facility, but adding any of these terms to the class name has
       
   176       been judged as not constituting an improvement to readability.
       
   177 
       
   178  - Return int from size() functions.
       
   179     * Consistent with standard Qt practice.
       
   180 
       
   181  - Rename write{Text}ContentTo to write{Text}Content.
       
   182     * For improved consistentcy with Qt naming.
       
   183 
       
   184  - Rename QMessageManager::ErrorCode to QMessageManager::Error.
       
   185     * For improved consistency with Qt naming.
       
   186 
       
   187  - Reorder the parameters for QMessageAddress(Type, Address).
       
   188     * There is a logical dependency of address on type.
       
   189 
       
   190  - API improvements to QMessageService.
       
   191     * Use the same State enum values as used by the QtMobility Contacts
       
   192       API, and provide the same stateChanged() signal signature.
       
   193     
       
   194       Rename cancelOperation() to cancel() for consistency with Qt.
       
   195 
       
   196  - Rename QMessageStore:: and QMessageManager::lastError() to error().
       
   197     * This is the more common form in Qt, and in line with the equivalent
       
   198       Contacts interface name.
       
   199 
       
   200  - Rename QMessageFolder::displayName() to name().
       
   201     * DisplayName should be used where the name used for display purposes
       
   202       differs from the fundamental name property.
       
   203 
       
   204  - Symbian specific fixes
       
   205     * Added correct Symbian UID to Messaging DLL
       
   206     * Corrected exporting of public headers (to /epoc32/include/)
       
   207     * Changed DLL capability to: ALL -TCB (was previously: ALL -TCB -AllFiles -DRM)
       
   208     * Fixed "." (application private) folder support (attachments)
       
   209       Now all auto tests can use "." folder for test files
       
   210     * Fixed auto tests to use "." folder (just like in other backends)
       
   211     * Fixed file type recognition bug (.png files)
       
   212     * Fixed bug: Messaging queries list unknown (for example bluetooth)
       
   213                  messages from Inbox
       
   214     * Nested filters support for account, folder & message filters finalized, all auto tests pass
       
   215     * MIME type handling related bugs fixed
       
   216     * Character set handling bugs fixes
       
   217     * Default account bug fixed
       
   218     * Message attachment memory usage optimized
       
   219     * Standard folder support for emails improved (Inbox filtering)
       
   220     * Message size calculation accuracy improved
       
   221     * CEikonEnv usages removed (relations to Symbian UI Framework)
       
   222     * message type handling improved (if message type is not defined, message type is retrieved from parentAccount)
       
   223       Related to bug that prevented MMS message sending from MessagingEx
       
   224       (Note: MMS message sending in writemessage example worked)
       
   225     * MMS Message content retrieval bug fixed (related to QByteArray QMessageContentContainer::content() const; bug)
       
   226 
       
   227 
       
   228 QtMedia
       
   229 ------
       
   230 
       
   231  - Added Audio and Video QML elements.
       
   232  - Renamed QtMedia::Frequency to QtMedia::SampleRate for consistency and
       
   233    clarity.
       
   234  - Renamed QtMedia::CoverArtUriSmall to QtMedia::CoverArtUrlSmall,
       
   235    QtMedia::CoverArtUriLarge to CoverArtUrlLarge, and  QtMedia::PosterUri
       
   236    to QtMedia::PosterUrl.
       
   237  - QGraphicsVideoItem
       
   238     * Added offset(), size(), nativeSize(), and aspectRatioMode()
       
   239       properties.
       
   240  - QGraphicsVideoItem, QMediaPlaylist, QVideoWidget
       
   241     * Replaced QMediaObject* constructor parameter with setMediaObject()
       
   242       function.
       
   243  - QMediaContent
       
   244     * Renamed canonicalUri() to canonicalUrl().
       
   245     * Removed coverArtUriSmall(), coverArtUriLarge(), posterUri(),
       
   246       thumbnailUriSmall(), and thumbnailUriLarge() properties.
       
   247  - QMediaPlayer
       
   248     * Added static supportedMimeTypes() method.
       
   249     * Added isAudioAvailable() property.
       
   250  - Added QMediaTimeRange and QMediaTimeInterval classes to represent time
       
   251    periods in media items.
       
   252  - QMediaPlayerControl
       
   253     * Renamed seekRanges() to availablePlaybackRanges(). This method now
       
   254       returns a QMediaTimeRange, which can contain multiple disjoint time
       
   255       intervals representing buffered portions of media.
       
   256  - QMediaResource
       
   257     * Renamed uri() to url().
       
   258     * Renamed channels() to channelCount().
       
   259     * Renamed size() to dataSize().
       
   260     * Removed duration() and sampleSize().
       
   261 
       
   262 QtPublishSubscribe
       
   263 ------
       
   264 
       
   265  - Rename QValueSpacePublisher::attributeInterestChanged() to
       
   266    QValueSpacePublisher::interestChanged().
       
   267  - Symbian backend improvements
       
   268     * MOBILITY-387: Symbian central repository related compile error fixed
       
   269     * Support for removeValue.
       
   270     * subPaths only returns the values that are really available.
       
   271     * Unsupported data types are published as serialized QByteArrays.
       
   272       All QVariant data types can be passed through the Publish and Subscribe.
       
   273     * PSPathMapper server added so the QCRML files no longer need to be parsed
       
   274       in client-side.
       
   275     * QCRML files can now be installed on any drive.
       
   276  - Fixed bugs
       
   277     * QTMOBILITY-38: The table/list view in the subscriber window of publish
       
   278       and subscribe example is now readonly.
       
   279     * QTMOBILITY-39: Compile failure with gcc 4.4.
       
   280     * QTMOBILITY-43: Rework P&S example to support small screen sizes.
       
   281     * Memory leak in Registry Layer.
       
   282 
       
   283 QtServiceFramework
       
   284 ------
       
   285 
       
   286  - QService namespace added
       
   287     * Renamed QServiceManager::Scope to QService::Scope
       
   288  - QServiceFilter
       
   289     * Renamed customPropertyKeys() to customAttributes()
       
   290     * Renamed setCustomProperty() to setCustomAttribute()
       
   291     * Removed removeCustomProperty()
       
   292     * Renamed clearCustomProperties() to clearCustomAttribute()
       
   293     * Renamed CapabilityMatchRule::MatchAll to CapabilityMatchRule::MatchMinimum
       
   294     * Renamed interfaceMajorVersion() to majorVersion()
       
   295     * Renamed interfaceMinorVersion() to minorVersion()
       
   296  - QServiceInterfaceDescriptor
       
   297     * Renamed inSystemScope() to scope()
       
   298     * Renamed PropertyKey to Attribute
       
   299     * Renamed property() to attribute()
       
   300     * Renamed customProperty() to customAttribute()
       
   301     * Renamed customPropertyKeys() to customAttributes()
       
   302  - QServiceManager
       
   303     * Renamed getInterface() to loadLocalTypedInterface()
       
   304 
       
   305 
       
   306  - error reporting for Service XML parsing imporved
       
   307  - export macro name changed due to name clash
       
   308  - multiple unit test fixes
       
   309  - Symbian backend
       
   310     * Maturity improvements in emulator environment
       
   311     * DB handling server is terminated automatically when any client no
       
   312       longer uses it
       
   313     * Fixed how library existence is checked in Symbian
       
   314     * databasemanager server UID added
       
   315     * All emulator processes use common service framework database
       
   316     * Multiple QServiceManager instance issue on emulator fixed
       
   317 
       
   318 QtSystemInfo
       
   319 ------
       
   320 
       
   321  - New features for Maemo5 backend
       
   322     * simStatus
       
   323     * Available languages
       
   324     * hasFeatureSupported completed
       
   325     * displayBrightness
       
   326     * imsi
       
   327 
       
   328  - New features for Mac backend
       
   329     * added network signaling
       
   330 
       
   331  - New features for Linux backend
       
   332     * code refactoring
       
   333 
       
   334 
       
   335 
       
   336 ****************************************************************************
       
   337 *                      Platform Specific Changes                           *
       
   338 ****************************************************************************
       
   339 
       
   340 Qt Mobility for Embedded Linux
       
   341 ------
       
   342 
       
   343  -
       
   344 
       
   345 Qt Mobility for Unix (X11 and Mac OS X)
       
   346 ------
       
   347 
       
   348  - 
       
   349 
       
   350 Qt Mobility for Linux/X11
       
   351 ------
       
   352 
       
   353  -
       
   354 
       
   355 Qt Mobility for Windows
       
   356 ------
       
   357 
       
   358  - Added Direct Show based media player service implementation.
       
   359 
       
   360 Qt Mobility for Mac OS X
       
   361 ------
       
   362 
       
   363  -
       
   364 
       
   365 Qt Mobility for Windows CE
       
   366 ------
       
   367 
       
   368  -
       
   369 
       
   370 Qt Mobility for Symbian
       
   371 ------
       
   372 
       
   373  - QContactManager backends
       
   374     * QContactAvatar: Added support for pixmap field and VideoRingtone subtype. For pixmap field there is a known issue that it is not always shown in the name list view of S60 platform Phonebook.
       
   375     * The display label now uses the same formatting rules as the platform phonebook application, except that "unnamed" contact label is not localised.
       
   376     * When filtering with QContactDisplayLabel and match flag MatchStartsWith is set the filtering rules follow the platform Phonebook's name list view filtering rules.
       
   377     * When filtering with a phone number detail and match flags MatchPhoneNumber is set the filtering rules follow the platform Phonebook's phone number matching rules. Known issue: the matched phone number needs to be at least 7 digits.
       
   378     * Contact filtering: added support for intersection and union filters. This improves performance in those cases where the contained filters give only a sub-set of the contacts.
       
   379     * Fixed a bug where modifying the details of a self-contact failed.
       
   380     * Added an experimental support for SIM ADN contacts with QContactManager implementation named "symbiansim".
       
   381     * Several bug fixes to contact relationships.
       
   382     * Fixed the error handling when a client tries to update the contact type. This is not supported.
       
   383     * Bugfix: Saving and deleting contacts in quick successive manner caused the contact database server to fail on S60 3.2 devices.
       
   384     * Bugfix [QTMOBILITY-54]: Loading a QContact for a contact database contact with an undefined field type caused a crash. 
       
   385 
       
   386  - Installpath for Symbian headers changed
       
   387     * Contacts and Versit installed to EPOCROOT/include/app
       
   388     * All other API headers installed to EPOCROOT/include/mw
       
   389 
       
   390  - Multimedia
       
   391     * Symbian backend added for 3rd ed FP1, 3rd ed FP2 and 5th ed. Following services supported
       
   392       - AudioCapture
       
   393         * limited codec support
       
   394       - Radio support (needs sim-card when testing)
       
   395         * listen radio
       
   396         * search channels / frequency
       
   397         * change volume
       
   398       - Mediaplayer
       
   399         * play local files
       
   400         * play local video
       
   401         * play stream e.g. from youtube working
       
   402         * retrieve metadata ( following tags supported: title, artist, comment, genre, ye   ar, copyright, album, composer, albumtrack, audiobitrate, videobitrate, duration, content type)
       
   403 	* read extended metadata supported
       
   404         * writing metada to file not supported by S60
       
   405         * codec support depends on device model
       
   406         * AudioDeviceControl not implemented for mediaplayer, defaults to device default.
       
   407       - Camera
       
   408         * camera support is expiremental
       
   409         * still capture
       
   410         * mediacapture
       
   411         * recording codec support is limited to video/mp4
       
   412 
       
   413 ****************************************************************************
       
   414 *                          Tools                                           *
       
   415 ****************************************************************************
       
   416 
       
   417  - ICheck added 
       
   418     * Validation tool for meta object defined service framework interfaces
       
   419