Need a document to address the relations between firmware, Ubuntu.Components, QtQuick, Qt toolkit

[XiaoGuo, Liu]

Currently, I find that it is very confusing about the following version numbers:

- Ubuntu phone OS version
- Firmware version and OTA version
- Ubuntu.Components version
- Qt version
- Qt Quick version
- Platform service API versions

Do they have the dependence with each other? If yes, what are the relationships?

For example, if I have a MX4 phone, how can I verify the new APIs? I need to find the correct firmware to test them. Otherwise, the new APIs are of no much use for the developers. Preferably, it is good to have a tool to check all of the revisions on the devices

Thanks & best regards,
XiaoGuo

[Andrea Bernabei (faenil)]

I agree this is very confusing for developers, it's very difficult to find info about which framework corresponds to which OTA, and to which API documentation.

Currently the website shows 15.04.1, although the documentation it shows is actually 15.04.3 (the Community team is already thinking about a way to improve this)

[Rex Tsai (chihchun)]

Also Scope API is included in unity8 package. If unity8 APIs or any Qt/Quick/Web or binding APIs got updated, the framework number should be bumped, which ensure that app or scope works in that rootfs.

There are several API support[1] got dropped or new feature like preview widget and share-data been introduced[2]. The user can have a newer app or scope running in old rootfs, and caused some compatible issue.

I think the best inforamtion for developers are a mapping table of

- ubuntu version from $(system-image-cli -i)
- tag name from $(system-image-cli -i)
- related packages version,
libqt*
qtdeclarative5-*
ubuntu-system-settings
ubuntu-ui-toolkit-theme
unity8-common
unity-webapps-qml
and so on ...

[1] Bug #1542375 “Get rid of the formFactor context property” : Bugs : webbrowser-app package : Ubuntu - https://bugs.launchpad.net/bugs/1542375
[2] Preview widget types | Ubuntu developer portal - https://developer.ubuntu.com/api/scopes/cpp/sdk-15.04.1/previewwidgets/