Getting Started with coding for Jolla Sailfish OS

Artem Marchenko

@AgileArtem

22.02.2014, Tampere, Finland

22.02.14@AgileArtem

http://www.codingsubmarine.com

Today

• Quick start on emulator

– And how to run on device

• Structure of the build process and artifacts

• Packaging for app store

• Troubleshooting / debugging

• Support channels and further questions

22.02.14@AgileArtem

http://www.codingsubmarine.com

QUICK START

22.02.14@AgileArtem

http://www.codingsubmarine.com

Preparing SDK

1. Install SDK https://sailfishos.org/develop.html2. Run its Updater ( Help -> Start Updater)3. Get HelloWorld Pro from

https://github.com/amarchen/helloworld-pro-sailfish and open it (you need a project for Updating part of SDK)– Configure for all available platforms

4. Rename project into harbour-my-great-app via rename-to-my-project.sh

5. Start Mer build machine (can take a couple of clicks)

6. Install more updates via Sailfish OS tab

22.02.14@AgileArtem

http://www.codingsubmarine.com

Starting app on emulator

• Set i486 platform as active

• Deploy as RPM

• Run subproject src

22.02.14

Start emulator and app

22.02.14

Running tests on emulator

• Run /usr/share/tst-

harbour-my-

great-

app/runTestsOnD

evice.sh

– As README.md says

22.02.14@AgileArtem

http://www.codingsubmarine.com

Connecting device• https://sailfishos.org/develop-firstapp-article.html covers it

well– Works fine on WiFi– Couldn’t make it work via USB

22.02.14@AgileArtemhttp://www.codingsubmarine.co

m

Then run on device

• Same as on emulator

• Just don’t forget to select armv7 platform

22.02.14

Continue in QML

22.02.14@AgileArtem

http://www.codingsubmarine.com

STRUCTURE OF THE BUILD PROCESS

22.02.14@AgileArtem

http://www.codingsubmarine.com

Project directoriesYour PC

Mer build

machine

Jolla device/

emulator

/Users/artem/

projects/great-app//home/mersdk/

projects/great-app/

/home/mersdk/

projects/build-great-

app-MerSDK.../

/home/deploy/

installroot/usr/share/

harbour-great-app/...

/home/deploy/

installroot/usr/bin/

harbour-great-app

/usr/bin/harbour-

great-app

/usr/share/harbour-

great-app/...

Same dir

Compile

INSTALLS

phase of

qmake build

Default comes from

~/mersdk/targets/Sailfish.../usr/

share/qt5/mkspecs/

features/sailfishapp.prf

RPM package

22.02.14@AgileArtem

http://www.codingsubmarine.com

Building-packaging

harbour-great-

app.yaml

gstreamer-devel

libresourceqt5

sailfishapp

Build-time

dependencies

libsailfishapp

Runtime

dependencies

/usr/bin/harbour-great-app

/usr/share/icons/...

/usr/share/harbour-great-app/..Files in main

package

harbour-great-

app-tests

subpackage

/usr/bin/tst-harbour-great-app

/usr/share/tst-harbour-great-app/...

harbour-great-

app-fake

subpackage

Garbage other packages

don't need

great-app.pro

source files

resources

harbour-great-

app.spec

Extra detais

Tell we are not

requiring/providing

anything not allowed

Pass QMake vars

E.g. version number

Or dir with platform-specific

resources

for bundling into app

/home/deploy/installroot/

usr/bin/harbour-great-app

...on Mer build machine

INSTALLS

harbour-great-app-0.1-1.armv7hl.rpm

harbour-great-app-test-0.1-1.armv7hl.rpm

harbour-great-app-fake-0.1-1.armv7hl.rpmRPM packaging

To App Store!

22.02.14@AgileArtem

http://www.codingsubmarine.com

PACKAGING FOR APP STORE

22.02.14@AgileArtem

http://www.codingsubmarine.com

Build RPM package

1. Choose ARMV7 platform

2. *Clean* not to package i486 binaries

3. Deploy RPM

22.02.14

Validate

Submit to harbour

• http://harbour.jolla.com

• Icon templates can be found at https://sailfishos.org/apps_icons.html

– As mentioned in README.md

• You’ll need screenshots

– Use Screenshot or SailshotMe app on device

– Upload to Dropbox via Sailbox app

22.02.14@AgileArtem

http://www.codingsubmarine.com

TROUBLESHOOTING DEPLOYMENTS

22.02.14@AgileArtem

http://www.codingsubmarine.com

Troubleshooting failed deployments and not runnable apps

• Examine the content of the Mer machine and emulator directories. And device too if you need

• Is covered well at https://sailfishos.org/develop-faq.html

• Mer: ssh -p 2222 -i~/SailfishOS/vmshare/ssh/private_keys/engine/root root@localhost

• Emulator: ssh -p 2223 -i~/SailfishOS/vmshare/ssh/private_keys/SailfishOS_Emulator/root root@localhost

• Real device: ssh nemo@192.168.1.38– Address and password from the Developer Settings

on device

22.02.14@AgileArtem

http://www.codingsubmarine.com

Debugging

• C++ debugging doesn’t work from IDE

• If you comfortable with GDB, it is supposed to work

• Rumors tell that QML debugging does

– I failed to get it working

• Use logging

• Use automated tests

22.02.14@AgileArtem

http://www.codingsubmarine.com

Getting support and further questions

• IRC: #sailfishos on freenode(irc.freenode.net)

• devel-subscribe@lists.sailfishos.org

• This slideset –http://www.codingsubmarine.com/classes/2014-Tampere-Feb

• @AgileArtem on twitter

22.02.14@AgileArtem

http://www.codingsubmarine.com