Tiny PDF Viewer
The project provides an example of a PDF viewer based on PDFium.
The main purpose is to demonstrate using a minimum of source code to get a correct and extensible application.
Build status:
- example -
- dev -
Terms of Use and Participation
The source code of the project is provided under the license, which allows its use in third-party applications.
The contributor agreement documents the rights granted by contributors of the Open Mobile Platform.
Information about the contributors is specified in the AUTHORS file.
Code of conduct is a current set of rules of the Open Mobile Platform which informs you how we expect the members of the community will interact while contributing and communicating.
Project Structure
The project has a standard structure of an application based on C++ and QML for Aurora OS.
- ru.auroraos.TinyPdfViewer.pro file describes the project structure for the qmake build system.
- icons directory contains the application icons for different screen resolutions.
-
qml directory contains the QML source code and the UI resources.
- cover directory contains the application cover implementations.
- icons directory contains the additional custom UI icons.
- pages directory contains the application pages.
- ru.auroraos.TinyPdfViewer.qml file provides the application window implementation.
-
rpm directory contains the rpm-package build settings.
- ru.auroraos.TinyPdfViewer.spec file is used by rpmbuild tool.
-
src directory contains the C++ source code.
- main.cpp file is the application entry point.
- filesmodel.h file is the application entry point.
- translations directory contains the UI translation files.
- ru.auroraos.TinyPdfViewer.desktop file defines the display and parameters for launching the application.
Compatibility
The project is compatible with all the current versions of the Aurora OS.
Working flow
-
FilesModel provides a list model of the PDF files, stored on device. The FilesPage uses SilicaListView to display of these files.
-
The list of the PDF files is a result of the Tracker3 DBus query. Tracker3 DBus call is executed in the TrackerQueryWorker.
-
DBusAdaptor implements a DBus service to open the PDF files on an external query. The adaptor emits fileOpenRequested signal when the DBus method openFile is called. That signal activates Application and sends the file path to the FilesPage.
-
ContentPage uses a PdfView qml type from ru.omp.amberpdf plugin to show the PDF document content. That plugin can render PDF document in horizontal and vertical orientations, draw annotations, notes. PdfView supports fast scroll, navigation, bookmarks, notes content. It is simple to use and we recommend to use in your application.
Screenshots
