Article is part 2 of the SailfishOS Introduction Tutorial
< Go to part 1 ||| Go To Part 3 >

First application

if you don't have the SDK installed and running yet, follow the installation guide.

1.Launch Sailfish OS IDE

You can launch from the 'SailfishOS IDE' entry in the system menu (or from ~/SailfishOS/bin/qtcreator if you're a linux terminal person).

As an example, on Ubuntu, open the dash, type in 'sailfish'. Click on the 'SailfishOS IDE' icon to launch the IDE.

2. Create a Sailfish UI project

The SDK comes with a Sailfish UI template project that makes it very easy to get started. Dialog windows shown in screenshots may vary between different versions/systems so treat them as an example.

1. In the IDE, click on File→New File or Project 2. Select Applications→SailfishOS Qt Quick Application.

3. Give a name to your project. Ensure it is created somewhere under your home directory and click Next.

4. Select MerSDK-SailfishOS-i486-x86 or MerSDK-SailfishOS-armv7hl kit and click Next. What's the difference? Generally MerSDK-SailfishOS-i486-x86 kit is used when deploying your application on emulator, the second kit is used when deploying application on Mer ARM device.

5. You can edit the short description of your project or just click Next

6. You can add version control to your project(in example GIT or SVN)

7. Click Finish 8. The project template is imported into your project and opened in the editor.

3. Launch the Mer build machine and Emulator

The SailfishOS SDK uses a Mer build machine to compile your code and another virtual machine to run an emulator. If these are not running when you attempt to build or deploy an application you will be asked to start them.

Note: The Mer build machine needs access to your source code to compile it and by default your home directory is shared - this is why the project should be in your home.

When a Sailfish OS project is open, the SDK automatically displays two control buttons in the left toolbar for starting/stopping the Mer build machine and Emulator.