The PiBox Launcher was designed to be a replaceable component within the PiBox Media Center, similar to but much simpler than the launchers on Android. This talk describes the design and implementation of the launcher application.

1. TheThe
PiBox LauncherPiBox Launcher
Michael J. HammelMichael J. Hammel
h t t p : / / w w w . g r a p h i c s - m u s e . o r gh t t p : / / w w w . g r a p h i c s - m u s e . o r g
m j h a m m e l @ g r a p h i c s - m u s e . o r gm j h a m m e l @ g r a p h i c s - m u s e . o r g

2. OverviewOverview
● Purpose
● Build and Install
● Features
● Code

3. Purpose

4. PiBox Media Center UIPiBox Media Center UI
Consumer
Ready
Interface
Application
Selection
Rules for
Application
integration Drop in
Front end!

5. Consumer Ready InteraceConsumer Ready Interace

6. Build and Install

7. BuildBuild
Download
https://gitlab.com/pibox/launcher.git
Set TC, SD and Opkg dir
export TC=<path to toolchain>
export SD=<path to staging tree>
export OD=/usr/local/bin (usually)
Build
./cross.sh ­o=$OD ­s=$SD ­t=$TD
Generates package in
opkg directory

8. Features

9. Application PackageApplication Package
Provides icons
Provides icons
Icon points to XML config
Icon points to XML config
XML config links to app
XML config links to app
Launcher calls appmgr
Launcher calls appmgr
App runs on top!
App runs on top!

10. Code

11. Source TreeSource Tree
●
Build files: autconf basedBuild files: autconf based
●
autoreconf ­iautoreconf ­i
●
./configure./configure
●
makemake
●
src: the C source filessrc: the C source files
●
data: XML, other config files, imagesdata: XML, other config files, images
●
opkg: Handles generating packagesopkg: Handles generating packages

12. Source CodeSource Code
●
launcher.c: main, UI codelauncher.c: main, UI code
●
db.c: Read XML configsdb.c: Read XML configs
●
cli.c: handle command line optionscli.c: handle command line options
●
log.c: Debug library (replaced by libpnc's pncLogger() functions)log.c: Debug library (replaced by libpnc's pncLogger() functions)
●
utils.c: Utility functions like string handling utils.c: Utility functions like string handling

13. Launcher UILauncher UI
●
Two screen areas: app icons and app splashTwo screen areas: app icons and app splash
●
Both are Cairo­capable drawing areasBoth are Cairo­capable drawing areas
●
Callbacks for screen updatesCallbacks for screen updates
●
Callback for keypress – move from icon to Callback for keypress – move from icon to
iconicon
●
Notify function messages appmgr daemon Notify function messages appmgr daemon
And that's it!
And that's it!

14. XML ConfigXML Config
<?xml version="1.0" encoding="ISO­8859­1"?><?xml version="1.0" encoding="ISO­8859­1"?>
<launcher><launcher>
<appName> Network Configuration </appName><appName> Network Configuration </appName>
<author> Michael J. Hammel </author><author> Michael J. Hammel </author>
<contact> mjhammel@graphics­muse.org </contact><contact> mjhammel@graphics­muse.org </contact>
<command> /usr/bin/pibox­network­config ­e </command><command> /usr/bin/pibox­network­config ­e </command>
<icon> icons/Wifi.png </icon><icon> icons/Wifi.png </icon>
<splash> icons/Wifi­Splash.png </splash><splash> icons/Wifi­Splash.png </splash>
<description> Configure the network </description><description> Configure the network </description>
</launcher></launcher>

15. Icons and SplashIcons and Splash
●
PNG onlyPNG only
●
Icons: 118 x 120Icons: 118 x 120
●
Splash: 390 x 390Splash: 390 x 390
●
Selected icon gets white border automaticallySelected icon gets white border automatically
Icons can't be square on ARM due to Cairo bug!Icons can't be square on ARM due to Cairo bug!