eql5-sfos/README.org

• Dependencies
• Build and deploy
• Attach a REPL
• Reload QML files
• Customize

This package is here to help bootstrap application development for Sailfish OS using ecl and eql5.

Dependencies

You’ll need ecl and eql5 installed in the build engine that comes with sfos sdk. These are available through my repository on openrepos.net. You can activate it and install the packages with the following command:

rpm --import https://sailfish.openrepos.net/openrepos.key
zypper ar -f https://sailfish.openrepos.net/razcampagne/personal-main.repo
zypper in eql5

Build and deploy

You can use the build button in qtcreator or do this manually in the sdk engine:

qmake eql5-sfos.pro
make

But the way I recommend to do it is by using the command-line tool sfdk that comes with the sdk. Use the following command for a comprehensive manual:

sfdk --help-building

The TL;DR would be one of the following:

sfdk build

Or,

sfdk qmake
sfdk make
sfdk make-install
sfdk package

You also have the option to build against ecl and eql5 statically to distribute your application without the need to depend on development packages. You can do this by configuring qmake like so:

sfdk qmake -- 'CONFIG += standalone'

Once the target and device options have been set, you just have to issue the command:

sfdk deploy

This will compile and build the package and send it to your phone as a rpm.

Attach a REPL

Upon initialization of the application, a slynk server is created with the port 4005. You just have to fire up emacs and connect to it using sly-connect. Only sly-fancy contribs are supported for now so you’ll have to disable the others you may have configured for it to work with this application.

If you wish to disable this feature, you can configure qmake like so:

sfdk qmake -- 'CONFIG += norepl'

Note that statically linking ecl and eql5 will also disable the repl.

Reload QML files

You can find a file `webserver.sh` in the repository which will launch a simple http server. You can then edit the qml files on your host machine and issue the following command in the application REPL:

(reload-qml "http://host-ip-address:8000")

This will reload all qml files but not the ones packaged on the device, the ones on your host system, served by the http server. You can even do that directly in emacs with the following code:

(let ((httpd-port 8000)) ; default 8080 port is already used by the sdk build engine
  (call-interactively 'httpd-serve-directory))

Customize

The code included in this repository is voluntarily barebone. Fill free to use it to bootstrap your application development and rename or replace files, packages to better suit your needs. You can even replace slynk with swank if you prefer.