← Back to team overview

ubuntu-sdk-bugs team mailing list archive

[Bug 1313210] Re: Ubuntu Project Templates, specifically the extension library, are vague, confusing, and poorly documented.

 

** No longer affects: qtcreator-plugin-ubuntu

-- 
You received this bug notification because you are a member of Ubuntu
SDK bug tracking, which is subscribed to qtcreator-plugin-ubuntu in
Ubuntu.
https://bugs.launchpad.net/bugs/1313210

Title:
  Ubuntu Project Templates, specifically the extension library, are
  vague, confusing, and poorly documented.

Status in “qtcreator-plugin-ubuntu” package in Ubuntu:
  Confirmed

Bug description:
  There are three main issues here:
  1) Templates provided by Ubuntu are not commented. Ordinarily this is fine for QML, where as the code is largely self explanatory, but for New Project -> "QML Extension Library + Tabbed UI", Mytype and Backend c++ classes are not commented at all, or is commented very ambiguously. In this for example, I point out three issues with the backend.h http://i.imgur.com/UQynLnf.jpg

  2) Web Documentation is confusing. The existing answers and documentation you can find on the web primarily focus on the desktop applications, and mostly do not use the ubuntu templates. For example:
  http://developer.nokia.com/community/wiki/Reading_and_writing_files_in_QML
  http://askubuntu.com/a/431458/253579 ^^ Based off that, which recommends using this template:
  http://i.imgur.com/5VHAZb3.jpg << says "Supported Platform: Desktop"; does that mean it won't work on ubuntu touch?
  this affects other answers as well:
  http://askubuntu.com/questions/446710/qml-simplest-way-to-write-to-a-text-file
  Later I was told in chatting with the author, that this actually may not work with Ubuntu-Touch, for some write reason, and that his answer was only directed to qml. Thus I am sort of left spinning my tires

  3) Other Templates are Red Herrings. As already pointed out, some of
  the templates state they only support Desktop Applications, leaving me
  question whether they will run on Qt. Additionally, If you were to
  follow the afore mentioned tutorials, you would end up with a QMake
  Project, where as all the ubuntu templates employ CMakeLists. Does
  that mean that only CMake can be used for touch applications?

  While I am by no means expert in C++, Qt, or QML, I am not exactly a
  beginner either, but rather just ignorant to how this sdk brings them
  all together.

To manage notifications about this bug go to:
https://bugs.launchpad.net/ubuntu/+source/qtcreator-plugin-ubuntu/+bug/1313210/+subscriptions