Table of Contents:
Apertis follows an app-centric architecture. This means that the development is more vertical and not layered as in automotive domain. This reduces dependency and leads to less time to market.
SDK is designed to make app development fast and easy while maintaining backward compatibility. The system gets upgraded periodically; however the applications should not be affected. This is achieved by writing apps against SDK APIs. The SDK APIs are ensured to maintained backward compatibility.
The SDK will not only expose native system services integrated into the OS, but also complete high level features which are of interest for multiple Applications. The APIs are classified into Enabling APIs and SDK APIs.
SDK APIs: Realize the high level features of the SDK behind the scene (e.g. an adressbook service which can be used by Apps to store and retrieve contact data in a joint place). They are dedicated APIs, provided with good documentation and sample code, easy to use and with backward compatibility guaranteed exposed with the intention to be used by the Apps.
Enabling APIs: These are APIs from libraries/services that are typically taken from Open Source (for example, Telepathy, Tracker). Apps which use these APIs directly need to maintain the stability on their own due to API or ABI breakages. Effort may be made to ease or remove transition issues when ABI or API breakages happen.
Trying to encapsulate these into SDK APIs will be a continuous process within Apertis.
OS APIs: These are more fundamental APIs, usually used by the Enabling APIs to provide higher-level functionality. Platform upgrades may require adapting applications to new APIs and/or ABIs for these.
Please see the contribution process for guidance if your application depends on a component that is not including in Apertis.
These are a basic set of applications that are bundled together with the system and get updated with the system:
- frampton: Audio player
- eye: video player
Some infrastructure applications and services also need to be available as part of the system to provide the basic UI even if there are no user focused applications:
- mildenhall-launcher: App launcher. Every app installed in the system will be listed here.
- mildenhall-settings: Collection of system and app settings (if any)
- mildenhall-statusbar: Status information shown at the top oft he screen
- eglibc: Basic OS interfaces
- GLib: Basic programming framework
- systemd: Service manager
- OSTree: Atomic software updates
- In apertis, Clutter library is provided for UI creation.
- Clutter is an open source software library for creating fast, compelling, portable, and dynamic graphical user interfaces.
- Use Open GLES for rendering.
- Comes with rich animation f/w with vast gesture support.
- Provides layout management for easy lay-outing of widgets.
libthornbury: libthornbury is a bunch of user Interface utility libraries. Thornbury provides the helper function for customized JSON parsing which is used in view manager, texture creation for static .png files or download from the web sychronously/asynchronously using libsoup to create the texture using GdkPixbuf,View manager is intended to create/manage the views in an app using Clutter, ItemFactory is used to instantiate any given widget type which implements MxItemfactory. Model to give the MVC approach to the app inspired by ClutterModel.
Purpose API Documentation Git repository UI utility library libthornbury API https://gitlab.apertis.org/hmi/libthornbury
liblightwood: libLightwood is a widget library. It has all the basic widgets like buttons, lists, rollers, webviews, widgets, multilines and textboxes, and can be extended to add functionality to these base widgets.
Purpose API Documentation Git repository Widget library liblightwood API https://gitlab.apertis.org/hmi/liblightwood
Mildenhall: Provides the reference UI widgets, used by graphical applications.
Purpose API Documentation Git repository User interface widget library Mildenhall API https://gitlab.apertis.org/hmi/mildenhall
- gdk-pixbuf: Image manipulation
- pixman: Low-level graphics
- Pango: High-level font rendering
- Mesa: Low-level graphics
- harfbuzz: Low-level font rendering
- freetype: Low-level font rendering
- JSON GLib: (De)serialization of JSON
- LLVM: Compiler technology
- libxml2: XML Parsing
- libxslt: XML Transformation
- Launching a new Application (Launch-mgr)
- Explicit or implicit information (Combination of Action, URI, and MIME) can be used to determine an app to launch
- Application life cycle management (activity-mgr)
- Managing application launch history (LUM)
- Audio management and audio priority handling(audio-manager)
- Sharing mechanism
- Application preferences (prefernce-mgr)
- IPC communication (D-Bus)
- View switching and in app back handling (View-Manager)
Canterbury : The core process in the system which deals with launch and kill of applications to be run on the system, including management of applications life cycle, creation and maintenance of application stack, etc. It also interacts on a regular basis with few other services for resource management of applications’, interaction with audio service (for audio handling and management), data exchange service (to facilitate inter-application data exchange) being 2 examples.
Purpose API Documentation Git repository Application management and process control service Canterbury API https://gitlab.apertis.org/appfw/canterbury
Didcot: Service which mediates file opening by media type (content type, MIME type), URL opening by URL scheme, and other data sharing between user applications.
Purpose API Documentation Git repository Data sharing and file opening service Didcot API https://gitlab.apertis.org/appfw/didcot
Newport: It manages large downloads for applications and other services running on the system (browser, email, other devices, etc).
Purpose API Documentation Git repository Download manager Newport API https://gitlab.apertis.org/appfw/newport
Barkway: This service caters to the global UI, providing a popup management framework, consisting of a user service and libraries that interface with it.
Purpose API Documentation Git repository Global popup management framework Barkway API https://gitlab.apertis.org/appfw/barkway
libseaton: Provides interfaces to store persistent data. It is a shared library using SQLite as the backend database.
Purpose API Documentation Git repository Persistent data management library libseaton API https://gitlab.apertis.org/hmi/libseaton
libclapton: Library which is used for system information and logging.
Purpose API Documentation Git repository Logging library TBD https://gitlab.apertis.org/pkg/libclapton
Ribchester: The service responsible for managing the application and services mount point and preparing the partitions based on the framework.
Purpose API Documentation Git repository Application installer/mounting service Ribchester API https://gitlab.apertis.org/pkg/ribchester
Rhosydd/Croesor: Rhosydd and Croesor are system services for handling access to sensors and actuators from applications. It provides a vendor-specific hardware API to connect to the services which control the hardware, and a SDK API for applications to use to access it.
Purpose API Documentation Git repository Handling access to sensors and actuators Rhosydd API https://gitlab.apertis.org/appfw/rhosydd Sensor backend utilities Croesor API https://gitlab.apertis.org/appfw/rhosydd
Shapwick: Shapwick is a platform component which monitors resource use. It provides a system service and a library for communication with the service.
Purpose API Documentation Git repository Resource Monitoring https://gitlab.apertis.org/pkg/shapwick
- Cellular and Wi-Fi Connection
- Connman manages internet connections (Automatically connects to last used network).
- Based on Bluez and profiles (PBAP, A2DP, PAN)
- Discovering / bonding / getting contacts from cell phone
- Beckfoot: Beckfoot is performs connection management and handles system connectivity services like network handling, wifi management, management of Bluetooth devices etc.
- Bluez: Bluetooth technology
- http clients
- Connected services (PIM)
- Playback of audio and video contents (local and streaming)
- Capturing images and recording audio and video
- Scanning & Playback of radio
- Complete audio management
- Extracting and displaying media content information
- Integration of External apps like VLC.
libgrassmoor : libgrassmoor is a library responsible for providing media info and media playback functionalities
Purpose API Documentation Git repository Media information and playback library libgrassmoor API https://gitlab.apertis.org/hmi/libgrassmoor
Tinwell: Is our Audio service. It focuses on complete audio handling for the system and provides facilities to play, buffer, record audio streams. It interacts with Canterbury to manage system audio effectively when multiple audio sources are active.
Purpose API Documentation Git repository Media playback service Tinwell API https://gitlab.apertis.org/hmi/tinwell
Prestwood: This service manages media and handles any activity related to the removable media (such as mounting them), UPnP devices, etc and indicates when they are ready for other services to communicate with them.
Purpose API Documentation Git repository Disk mounting service Prestwood API https://gitlab.apertis.org/hmi/prestwood
- Audio Manager: Audio Policy Management
- PulseAudio: Software mixing multiple audio streams
- Multiple-Format Codec: Various support of codec
- Media Content Service: Content management for media files
- WebKitGTK+: Web engine
- Poppler: PDF rendering
- Canberra: High-level sounds
- Grilo: Media indexing
- Tracker-extract, Tracker-miner, Tracker-sparql: Media indexing
GStreamer: Low-level multimedia
Apertis deploys only license verified Gstreamer plugins. Each Gstreamer plugin is developed under the LGPL license, but only gstreamer core, base and good provide license and patent-free plugins. The ugly and bad plugins are not considered safe from the license and patent issues. The “bad” plugins usually have API stablity issues as well as license problems. In addition, the plugins which have potential issues with patents, or license fees should be located in “ugly”. For more information, please refer to gstreamers documentation.
- Location based services
- Route guidance
- Traprain: Traprain is a set of libraries allowing navigation services,
such as a car GPS routing application, to share navigation and routing
information to third party applications.
Purpose API Documentation Git repository Navigation and routing libraries Traprain API https://gitlab.apertis.org/appfw/traprain
- Geoclue – Deliver location info from various positioning sources (http://freedesktop.org/wiki/Software/GeoClue/)
- libchamplain – Map rendering (https://wiki.gnome.org/Projects/libchamplain)
- Call handling
- ofono - includes consistent, minimal, and easy to use complete APIs for telephony
VoIP, IM and Groupware
- IP telephony
- Chat, etc.
- Telepathy-GLib (http://telepathy.freedesktop.org/doc/telepathy-glib/)
- Telepathy: Communication framework
- libGData (https://developer.gnome.org/gdata/unstable/)
- SyncEvolution D-Bus (http://api.syncevolution.org/)
- Farstream: Communication