Qt Quick best practices wiki page
-
wrote on 30 Nov 2010, 03:41 last edited by
Couldn't find a Qt Quick best practices and guidelines page, along with the DOs and DONTs. So thought of creating one "here":http://developer.qt.nokia.com/wiki/Qt_Quick_Best_Practices
This is just a place holder and have put in a few points, and of course some obvious ones. Will add more to it soon.Feel free to add your findings and help the wiki page grow.
-
wrote on 30 Nov 2010, 08:49 last edited by
Looks good :-)
Maybe mandatory rules like "uniqueness of the id property":http://doc.qt.nokia.com/4.7/qdeclarativeintroduction.html#the-property could be separated. Are there already conventions about indentation and commenting style? Loking on the link above 4 spaces plus line end comments seems to be preferred.BTW: is there a way to subscribe to wiki changes?
-
wrote on 30 Nov 2010, 08:55 last edited by
good suggestions @Wolf P. will update
there is a "Recent Changes" link in the Wiki Menu on the Wiki main page. You could subscribe to that RSS feed, but I think that pushes only newly added pages and not on every edit.
-
wrote on 30 Nov 2010, 09:01 last edited by
[quote author="chetankjain" date="1291107334"]You could subscribe to that RSS feed, but I think that pushes only newly added pages and not on every edit.[/quote]
Oh thanks! I looked rather for a notification mail service as provided for the forum.
-
wrote on 30 Nov 2010, 09:28 last edited by
for mail notification for wiki page entries, you could raise a request for that new feature to be implemented, in the beta forum of devnet
-
wrote on 30 Nov 2010, 11:16 last edited by
just updated the wiki page with more contents
-
wrote on 30 Nov 2010, 11:51 last edited by
Fine. Is the top-level order intended?
I would disagree with your examples of comments. Let me try some editing there...
-
wrote on 30 Nov 2010, 11:53 last edited by
[quote author="Wolf P." date="1291117880"]Fine. Is the top-level order intended?
I would disagree with your examples of comments. Let me try some editing there...[/quote]
yes pls go ahead :) the aim is to collate all the best practices and I am still learning too :D
-
wrote on 30 Nov 2010, 12:01 last edited by
...ready.
Sorry, I found the block end comments questionable.
-
wrote on 30 Nov 2010, 12:10 last edited by
The example looks ok.
I moved the 2 bullets talking about comments to the "Open for discussion" section... lets see what everyone has to say. Maybe we could have a poll later on these topics. Else the trolls could also have a final word :)
-
wrote on 2 Dec 2010, 08:12 last edited by
How about some DOs / DONTs for cross-platform QtQuick?
What about using fixed size width, height, x, y vs anchors/locations. Fixed sizes seem overused, even in the examples.
Also, if you don't specify a font size, it could be anything it seems. Even if it looks fine on one platform, it be quite different on another unless you specify. Important to consider.
-
wrote on 2 Dec 2010, 09:29 last edited by
DONTs are a good idea i find. What about starting an own wiki page for it? I'll help as I can.
I suggested the title "Qt Quick Donts":http://developer.qt.nokia.com/wiki/Qt_Quick_Donts on the best practices page.Happy wikiing :)
-
wrote on 2 Dec 2010, 09:34 last edited by
So should the cross-platform (i.e. cross-resolution) DONTs go in there? You should always try to make your code cross-platform I think. Especially important to learn from the start. However, I'm not so sure on how important it is to make the QML rotatable.
It's quite amazing when you do the right practices and your code works on devices you've never even seen before.
There was a nice app on Qt-Apps made in QML for Linux Desktop. Worked perfect on Symbian devices even though the developer had never used or seen one. -
wrote on 2 Dec 2010, 09:52 last edited by
[quote author="xsacha" date="1291282464"]So should the cross-platform (i.e. cross-resolution) DONTs go in there? You should always try to make your code cross-platform I think. Especially important to learn from the start. However, I'm not so sure on how important it is to make the QML rotatable.[/quote]
If it is actually possible to write platform dependend QML, then I think that it should be included (sorry I'm not an experienced QML developer, I tried hacking some examples up to now)
I find the idea of the reverse style so appealing. :)
-
wrote on 2 Dec 2010, 10:14 last edited by
I have often seen in code (for example the Twitter app in SDK), they use specific font sizes and widths.
I ran it on Windows, looks fine. Though, the app is clearly designed for a mobile device with its small space constraints. So I tried it on Symbian, hideous. I spent a day fixing it up and it looks great now.It's funny because they admit this in the code. I saw a comment that they should use anchors instead. Definitely wiki material.
-
wrote on 2 Dec 2010, 12:36 last edited by
I'd highly appreciate if you would start the wiki page.
-
wrote on 3 Dec 2010, 02:04 last edited by
[quote author="Wolf P." date="1291293375"]I'd highly appreciate if you would start the wiki page.[/quote]
Alright, I started that page. I mentioned the fixed size vs anchors point. -
wrote on 3 Dec 2010, 09:41 last edited by
:) Great! (I immediately made some minor changes.)
-
wrote on 14 Dec 2010, 16:39 last edited by
this has since been added as a "suggestion":http://bugreports.qt.nokia.com/browse/QTBUG-15757 in the Qt bug tracker and seems to be accepted, so we might see an official version soon ...
have also added a few more points in the wiki page ..
ps. a tag is missing for this post ? ;-)