maemo.org - Talk - Sailfish SDK version 1608 (2.0.2) Qt5 released

Sailfish SDK releases :
- Alpha (Qt4 & X11) in February 25th 2013 (for Linux), then updated in April 5th 2013 with Windows and Mac OS, see the release notes;
- Alpha (Qt5 & Wayland) August 1st 2013;
- Alpha 1310 (Qt5 & Wayland) October 22nd 2013, see the annoucement;
- Alpha 1312 (Qt5 & Wayland) December 13th 2013, see the annoucement;
- Alpha 1404 (Qt5 & Wayland) April 16th 2014, see the annoucement;
- Alpha 1406 (Qt5 & Wayland) June 12th 2014, see the annoucement;
- Alpha 1407 (Qt5 & Wayland) July 15th 2014, see the annoucement;
- Beta 1410 (Qt5 & Wayland) October 27th 2014, see the annoucement;
- Beta 1412 (Qt5 & Wayland) January 5th 2015, see the annoucement;
- Beta 1511 (Qt5 & Wayland) November 10th 2015, see the annoucement;
- 1602 (Qt5 & Wayland) May 10th 2016, see the annoucement;
- 1608 (Qt5 & Wayland) Aug 9th 2016, see the annoucement.
See the
Developer section of the Sailfish Wiki to download, how to install, etc.

This topic is intended to discuss Sailfish SDK installation and use.

Sailfish SDK Qt5 release notes :
"SailfishOS SDK is a collection of tools for developing SailfishOS applications. It includes:
- QtCreator integrated development environment (IDE)
- Mer build engine for cross compilation
- The SailfishOS Emulator
- Tutorial, Design and API Documentation
- Repositories for additional libraries and open source code

This release provides the following programming interfaces :
- Sailfish Silica Qt Quick components 1.0
- Standard Qt Quick2 components"

Tips & Hints & Info :
================

1) "Why is the emulator showing a black screen?"
Type "<host-key> + H" (host key is "Right Ctrl" by default) in Sailfish Emulator.

2) How do I login into the Sailfish Emulator or Mer SDK ?
Start the Emulator and/or Mer-SDK from the SailfishOS IDE, i.e., select a project, then click in "Start SDK" and/or "Start Emulator".
Then, to connect to Emulator from your host Linux :
$ ssh -p 2223 nemo@localhost
with password which you set using Developer Settings in Settings application (inside Emulator GUI).
Or using (without password) :
$ ssh -p 2223 -i ~/SailfishOS/vmshare/ssh/private_keys/SailfishOS_Emulator/nemo nemo@localhost
You can uso "sudo" to run root commands.
Or by pressing "<host-key> + F2" (host key is "Right Ctrl" by default) in Sailfish Emulator you get a terminal login. "<host-key> + F1" comes back to the Saifish Emulator GUI.
To connect to Mer-SDK from your host Linux :
$ ssh -p 2222 -i ~/SailfishOS/vmshare/ssh/private_keys/engine/mersdk mersdk@localhost
or, as root:
$ ssh -p 2222 -i ~/SailfishOS/vmshare/ssh/private_keys/engine/root root@localhost
If MerSDK is to be accessed, UI can be activated from Sailfish SDK -> Tools -> Options-> Mer menu -> Headless (untick it). By pressing "<host-key> + F2" (host key is "Right Ctrl" by default) in Mer SDK you can get a terminal login, the root login has no password. "<host-key> + F1" comes back to the Mer SDK initial screen.

3) How do I copy files between host PC and Sailfish SDK Emulator ?
The host PC folder "~/SailfishOS/vmshare/" is shared to "/etc/mersdk/share/" in Sailfish Emulator as read-only. So you can copy files and folders from PC to Sailfish Emulator. Be careful to not delete the folder "ssh" and file "devices.xml". From Sailfish Emulator to PC, you can use scp, e.g., "scp -P 2223 nemo@localhost:filename .".

4) What are versions of the Linux kernel, Qt, gcc and Python ?
Linux kernel 3.6.11, Qt 5.2, gcc/g++ 4.6.4 and Python 2.7.5.

5) Useful softwares to install in Sailfish Emulator ?
zypper, nano, htop, fingerterm :
[nemo@SailfishEmul ~]$ pkcon install zypper nano htop fingerterm

6) gcc and Python development :
gcc/g++ is not installed, but it can be with :
[nemo@SailfishEmul ~]$ pkcon install gcc gcc-c++
Python 2.7.5 is already installed. Additional python packages for development :
[nemo@SailfishEmul ~]$ pkcon install python-devel python-setuptools
For Python 3, PyOtherSide, PyQt 5.1, etc, see the Sailfish/Python Development page.

7) Qt Creator SailfishOS Mode blank window :
For some users (including me), the SailfishOS Mode (in left vertical bar of Qt Creator) shows a blank window ("about:blank"). The solution is to type "127.0.0.1:8080" and "<Enter>".

8) Repository list of Sailfish Emulator :
[nemo@SailfishEmul ~]$ ls /etc/zypp/repos.d/
ssu_adaptation1_release.repo, ssu_jolla_release.repo, ssu_sdk_release.repo, ssu_adaptation0_release.repo, ssu_hotfixes_release.repo, ssu_mer-tools_release.repo

[nemo@SailfishEmul ~]$ ssu lr
Enabled repositories (global):
- adaptation0 ... http://releases.sailfishos.org/sdk/l...6-common/i486/
- adaptation1 ... http://releases.sailfishos.org/sdk/l...x86-emul/i486/
- hotfixes ... http://releases.sailfishos.org/sdk/l...hotfixes/i486/
- jolla ... http://releases.sailfishos.org/sdk/latest/jolla/i486/
- mer-tools ... http://releases.sailfishos.org/sdk/l...i486/packages/
- sdk ... http://releases.sailfishos.org/sdk/latest/sdk/i486/

Enabled repositories (user):

Disabled repositories (global, might be overridden by user config):
- apps ... http://releases.sailfishos.org/jolla-apps/latest/i486/
- apps-mw ...

Disabled repositories (user):
- home ... https://download.jollamobile.com/hom...r/latest_i486/

9) Packages in (default) repositories :
There are about 3,560 packages listed in the Sailfish OS repositories. About Python : approx. 93 packages; Qt5 : 758 packages; Wayland : 27 packages; X11 : 12 packages.

10) to have an almost complete Sailfish without a Jolla smartphone, use a Nokia N9/N950 with Sailfish 1.0.2.5 or Nexus 4/5 with Sailfish 1.1.0.39, so you have web browser, real ARM device, etc.

New features of Sailfish SDK Beta Qt5 :
===============================

- it uses Qt 5.2 instead of Qt 4.8;
- Wayland is used instead of X11 graphical server;
- there is no standard Qt Quick components 1.1 (used in MeeGo Harmattan) package;
- there is no PySide (Qt 4.8 bindings for Python), but there is PyOtherSide and PyQt 5, see the "Python & Qt5 on Sailfish" topic;
- so it is now harder to migrate from MeeGo Harmattan to Sailfish, C/C++ developers need to port your Qt 4/Qt Quick 1/Qt Quick components softwares to Qt 5/Qt Quick 2/Silica components. Python developers have PyOtherSide and PyQt 5 instead of PySide, the "Python & Qt5 on Sailfish" topic;
- Sailfish Emulator has no pre-installed terminal, but fingerterm is available to install.

Requested features :
================

Some are already know by Jolla :

1) landscape mode in Sailfish Emulator;

2) Sailfish Emulator more populated with softwares, like web browser (needed to test web interfaces, etc), native Terminal, file manager, etc.