November 30, 2010

Deleted Member # 4a2 Deleted Member # 4a2
Ant Farmer
1274 posts

Qt Quick best practices wiki page

Page  
1

Couldn’t find a Qt Quick best practices and guidelines page, along with the DOs and DONTs. So thought of creating one here [developer.qt.nokia.com]
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.

18 replies

November 30, 2010

Wolf P. Wolf P.
Ant Farmer
326 posts

Looks good :-)
Maybe mandatory rules like uniqueness of the id property [doc.qt.nokia.com] 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?

November 30, 2010

Deleted Member # 4a2 Deleted Member # 4a2
Ant Farmer
1274 posts

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.

November 30, 2010

Wolf P. Wolf P.
Ant Farmer
326 posts
chetankjain wrote:
You could subscribe to that RSS feed, but I think that pushes only newly added pages and not on every edit.

Oh thanks! I looked rather for a notification mail service as provided for the forum.

November 30, 2010

Deleted Member # 4a2 Deleted Member # 4a2
Ant Farmer
1274 posts

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

November 30, 2010

Deleted Member # 4a2 Deleted Member # 4a2
Ant Farmer
1274 posts

just updated the wiki page with more contents

November 30, 2010

Wolf P. Wolf P.
Ant Farmer
326 posts

Fine. Is the top-level order intended?

I would disagree with your examples of comments. Let me try some editing there…

November 30, 2010

Deleted Member # 4a2 Deleted Member # 4a2
Ant Farmer
1274 posts

Wolf P. wrote:
Fine. Is the top-level order intended?

I would disagree with your examples of comments. Let me try some editing there…

yes pls go ahead :) the aim is to collate all the best practices and I am still learning too :D

November 30, 2010

Wolf P. Wolf P.
Ant Farmer
326 posts

…ready.

Sorry, I found the block end comments questionable.

November 30, 2010

Deleted Member # 4a2 Deleted Member # 4a2
Ant Farmer
1274 posts

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 :)

December 2, 2010

xsacha xsacha
Lab Rat
502 posts

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.

 Signature 

- Sacha

December 2, 2010

Wolf P. Wolf P.
Ant Farmer
326 posts

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 [developer.qt.nokia.com] on the best practices page.

Happy wikiing :)

December 2, 2010

xsacha xsacha
Lab Rat
502 posts

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.

 Signature 

- Sacha

December 2, 2010

Wolf P. Wolf P.
Ant Farmer
326 posts
xsacha wrote:
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.

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. :)

December 2, 2010

xsacha xsacha
Lab Rat
502 posts

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.

 Signature 

- Sacha

December 2, 2010

Wolf P. Wolf P.
Ant Farmer
326 posts

I’d highly appreciate if you would start the wiki page.

Page  
1

  ‹‹ Is there a way to "bookmark" a wiki page (other than using the browser)?      Recommended Books for learning C++ ››

You must log in to post a reply. Not a member yet? Register here!