RU | EN

Background Tasker

Description

The application allows you to run processes (tasks) in the background. You can run a regular task that will be executed once. It is also possible to run a periodically recurring task. There is a limitation for such a task, the minimum time interval between the repetition is 15 minutes. You can also cancel running processes.
Background tasks are created using the Workmanager plugin, which uses RuntimeManager.
An event log is also recorded in the $HOME/.local/share/en.auroraos/BackgroundTasker directory.

Table of Contents

• Compatibility
• Build features
• Branch info
• Install and launch
• Screenshots
• Usage options
• Project Structure
• Terms of Use and Participation in Development

Compatibility

The project is compatible with version 5.0.0 of the Aurora OS.

Build features

Go to the directory with the application, first update the dependencies:

flutter-aurora pub get

The following dependencies are used for the application:

• workmanager_aurora
• flutter_local_notifications_aurora
• path_provider_aurora

Start build:

flutter-aurora run

Branch info

Application versions conform to the branch naming convention

Install and launch

Important. The application needs a sandbox to run. So running the application from vscode(normal or debugging) will not allow you to to use the workmanager plugin. You need to run the application directly from the device.

Using the plugin requires modifying the .desktop file of the target application:

[X-Application].
Permissions=UserDirs

In the X-Task block for a normal task, you need to add:

[X-Task rescheduledTaskKey]
Type=worker

In the X-Task block for a recurring task, you need to add:

[X-Task periodicTaskKey]
Type=periodic

Screenshots

Usage options

• Create a regular background task and cancel it.
• Create a recurring background task and cancel it.
• Cancel all registered tasks

Project Structure

The project has a standard application structure based on Dart and Flutter for Aurora OS.

• aurora the directory contains the C++ source code and resources needed for installation.
• lib the directory contains the source code for the Dart application.
  • src the directory contains the application implementation.
  • main.dart the file is the entry point to the application.
• pubspec.yaml the file describes the dependencies and settings of the plugin name.

Terms of Use and Participation in Development

The source code of the project is provided under license, which allows to use it in third-party applications.

To participate in the development of the project, please read the member agreement. If you plan to submit your own source code for inclusion in the project, you will need to accept the CLA terms and conditions.

Participant information is listed in the AUTHORS file.

The Code of Conduct is the current set of rules of the Open Mobile Platform Company, which informs about the expectations for interaction between community members when communicating and working on projects.