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:

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

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.

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.