Difference between revisions of "Getting Started"

From WebOS-Ports
Jump to navigation Jump to search
(Correcting version info for Debian)
(More info on installing Qt 5.5.)
Line 9: Line 9:
 
* Qt 5.5 or up and Qt Creator (included with Qt which can be downloaded from http://www.qt.io/download-open-source/) or installed on Linux using one of these commands:
 
* Qt 5.5 or up and Qt Creator (included with Qt which can be downloaded from http://www.qt.io/download-open-source/) or installed on Linux using one of these commands:
 
*; Ubuntu <16.04 (Xenial Xerus)/Debian < Stretch
 
*; Ubuntu <16.04 (Xenial Xerus)/Debian < Stretch
*: You will need to download the version direct from Qt at http://www.qt.io/download-open-source/  The versions included in the system repositories are too old.
+
*: You will need to download the version direct from Qt at http://www.qt.io/download-open-source/  The versions included in the system repositories are too old. The default Qt packages it selects should be all you need, and you can install this version of Qt in a directory within your home directory if you don't want to install it system-wide or replace the system packages.  You will also need to run: <pre>sudo apt-get install g++</pre>
 
*; Ubuntu &gt;=16.04 (Xenial Xerus)/Debian &gt;= Stretch (untested and may need to be changed a bit)
 
*; Ubuntu &gt;=16.04 (Xenial Xerus)/Debian &gt;= Stretch (untested and may need to be changed a bit)
 
*: <pre>sudo apt-get install qtcreator qtdeclarative5-private-dev qtbase5-private-dev qtdeclarative5-qtmultimedia-plugin # Due to the way Qt is packaged, we also need to install some dependencies.</pre>
 
*: <pre>sudo apt-get install qtcreator qtdeclarative5-private-dev qtbase5-private-dev qtdeclarative5-qtmultimedia-plugin # Due to the way Qt is packaged, we also need to install some dependencies.</pre>
Line 17: Line 17:
 
*: Unmask a version of Qt &gt;= 5.5 (needed at the time of writing), then run: <pre>emerge dev-qt/qt-creator</pre>
 
*: Unmask a version of Qt &gt;= 5.5 (needed at the time of writing), then run: <pre>emerge dev-qt/qt-creator</pre>
  
* lune-next-cardshell (This acts as both the system shell and a library of components)
+
* luna-next-cardshell (This acts as both the system shell and a library of components)
 
*# <pre>git clone https://github.com/webOS-ports/luna-next-cardshell.git</pre>
 
*# <pre>git clone https://github.com/webOS-ports/luna-next-cardshell.git</pre>
  
Line 33: Line 33:
 
*## Add a setting called <pre>QT_QUICK_CONTROLS_STYLE</pre> and give it a value of <pre>LuneOS</pre>
 
*## Add a setting called <pre>QT_QUICK_CONTROLS_STYLE</pre> and give it a value of <pre>LuneOS</pre>
  
* Our QML apps being:
+
* One of the QML apps:
  
 
:* luna-next-cardshell itself
 
:* luna-next-cardshell itself

Revision as of 22:30, 1 January 2016

How to get started as a developer?

QML Apps

We have various apps and components written in QML. By using stub data you'll be able to use most of them on a desktop for agile development :)

What you will need:

  • Qt 5.5 or up and Qt Creator (included with Qt which can be downloaded from http://www.qt.io/download-open-source/) or installed on Linux using one of these commands:
    Ubuntu <16.04 (Xenial Xerus)/Debian < Stretch
    You will need to download the version direct from Qt at http://www.qt.io/download-open-source/ The versions included in the system repositories are too old. The default Qt packages it selects should be all you need, and you can install this version of Qt in a directory within your home directory if you don't want to install it system-wide or replace the system packages. You will also need to run:
    sudo apt-get install g++
    Ubuntu >=16.04 (Xenial Xerus)/Debian >= Stretch (untested and may need to be changed a bit)
    sudo apt-get install qtcreator qtdeclarative5-private-dev qtbase5-private-dev qtdeclarative5-qtmultimedia-plugin # Due to the way Qt is packaged, we also need to install some dependencies.
    Fedora (this one is also untested and may be too old)
    yum install qt-creator
    Gentoo (untested)
    Unmask a version of Qt >= 5.5 (needed at the time of writing), then run:
    emerge dev-qt/qt-creator
  • luna-next-cardshell (This acts as both the system shell and a library of components)
    1. git clone https://github.com/webOS-ports/luna-next-cardshell.git
  • luneos-components (This is our shared library of components used across various QML apps and can be found at https://github.com/webOS-ports/luneos-components)
    1. git clone https://github.com/webOS-ports/luneos-components.git
    2. Open the luneos-components.pro file in Qt Creator.
    3. Under Projects (on the left side), go to the Build tab (should be the default) and change the following settings:
      1. Deactivate Shadow Build.
      2. For the qmake build steps, click on Details to expand the edit area.
      3. Set Additional Arguments to:
        CONFIG+=desktop
    4. Now, under the Run tab at the top:
      1. Set Executable to
        qmlscene
      2. Set Additional Arguments to
        -l modules -l test/imports examples/gallery/main.qml
      3. Under Run Environment, click Details to expand the settings.
      4. Add a setting called
        QT_QUICK_CONTROLS_STYLE
        and give it a value of
        LuneOS
  • One of the QML apps:
  • luna-next-cardshell itself
  • FirstUse
  • Browser
  • Phone
  • webos-keyboard