Solid/Projects/BlueDevil: Difference between revisions

From KDE Community Wiki
m (Fix some spelling)
 
(19 intermediate revisions by 4 users not shown)
Line 19: Line 19:
documentation=Currently we're lacking a good End user documentation, help is needed. |
documentation=Currently we're lacking a good End user documentation, help is needed. |


howToCollaborate=Bluedeivl is a KDE project, so we use the usual ways to communicate to each other, and to work together. |  
howToCollaborate=BlueDevil is a KDE project, so we use the usual ways to communicate to each other, and to work together. |  


projectPage = Currently BlueDevil is under extragear/base
projectPage = Currently BlueDevil is under extragear/base
Line 25: Line 25:


}}
}}
==Debugging==
BlueDevil is composed by a set of components, some of them are debugged in a completely different way.
===KIO's===
The kio's are the hardest part of BlueDevil to debug:
*Execute kdebugdialog --fullmode
*Select kio_bluetooth or kio_obexftp
*In all 4 sections choose the "File" option, and introduce an output path (for example /home/youruser/kio_obexftp.txt
In case that the bug is reproducible in Konqueror and Dolphin, use the first is preferred.
===KCM===
Try to reproduce the bug only using the affected module. For example in case that the affected module were filetransfer, you should execute:
kcmshell4 bluedevilfiletransfer
To get a complete list you can execute:
kcmshell4 --list | grep bluedevil
===Wizard===
Execute kdebugdialog, search "bluedevil" and activate everything. Then execute bluedevil-wizard in the terminal and provide the output.
===Systray===
Try to reproduce the bug step by step, restarting all BlueDevil (in the KCM)
===Reporting===
And finally, we're using http://bugs.kde.org, search twice before post a new bug. If a developer ask for feedback, and it is not provided within the following 30 days, the bug may be closed.
== Testing before release ==
A set of tests must be done before a new version can be released so we can be quite sure that at least no regressions has been introduced.
[[Solid/Projects/BlueDevil/Tests | Tests page]]
== Releases ==
*[[Solid/Projects/BlueDevil/Releases/1.0.1 | 1.0.1]]


== Roadmap ==
== Roadmap ==
===BlueDevil 1.1 ===
*[[Solid/Projects/BlueDevil/Roadmaps/1.1 | BlueDevil 1.1]]
The focus of 1.1 release will be add more Elegance into BlueDevil, for example by adding a better error hanlding, making things react as the user expect etc...
 
There is not a release date for it, but can be expected somewhere close to KDE 4.6 release.
===BlueDevil 1.2 ===
We have one simple objective for BlueDevil 1.2, perfectionism


====KDE Bluetooth Agent====
====KDE Bluetooth Agent====
Line 35: Line 71:
|- style="background: #ececec; white-space:nowrap;"
|- style="background: #ececec; white-space:nowrap;"
! Status !! Type !! Description !! Contact
! Status !! Type !! Description !! Contact
{{FeatureTodo |Feature| Support all Bluetooth pairing modes |alex@eyeos.org|Alex Fiestas}}
{{TestFail |Research| Research last "unhandler" method |afiestas@kde.org|Alex Fiestas}}
{{FeatureTodo |Revision| Be sure that all the helpers work |alex@eyeos.org|Alex Fiestas}}
|}
|}


Line 43: Line 78:
|- style="background: #ececec; white-space:nowrap;"
|- style="background: #ececec; white-space:nowrap;"
! Status !! Type !! Description !! Contact
! Status !! Type !! Description !! Contact
{{FeatureTodo |Improvement| Improve notifications |alex@eyeos.org| Alex Fiestas}}
{{FeatureProjectTodo |Research| Port to obexd |afiestas@kde.org| Alex Fiestas}}
|}
|}


Line 50: Line 85:
|- style="background: #ececec; white-space:nowrap;"
|- style="background: #ececec; white-space:nowrap;"
! Status !! Type !! Description !! Contact
! Status !! Type !! Description !! Contact
{{FeatureTodo |Improvement| Use random 8 digit random PIN |[email protected]| Alex Fiestas}}
{{FeatureTodo |Improvement| Detect when a device can introduce the PIN |[email protected]| Alex Fiestas}}
{{FeatureTodo |Feature| Support all Bluetooth pairing modes |[email protected]| Alex Fiestas}}
|}
|}


Line 65: Line 97:
|- style="background: #ececec; white-space:nowrap;"
|- style="background: #ececec; white-space:nowrap;"
! Status !! Type !! Description !! Contact
! Status !! Type !! Description !! Contact
{{FeatureTodo |Improvement| We need to have a better error handling, using the kio interface to report the errors|alex@eyeos.org| Alex Fiestas}}
{{FeatureProjectTodo |Improvement| We need to have a better error handling, using the kio interface to report the errors|afiestas@kde.org| Alex Fiestas}}
{{FeatureTodo |Improvement| Improve the overall stability |alex@eyeos.org| Alex Fiestas}}
|}
|}
====kio_bluetooth====
====kio_bluetooth====
Line 72: Line 103:
|- style="background: #ececec; white-space:nowrap;"
|- style="background: #ececec; white-space:nowrap;"
! Status !! Type !! Description !! Contact
! Status !! Type !! Description !! Contact
{{FeatureInProgress |Improvement| Show the configured devices first, and discover in the background |alex@eyeos.org| Alex Fiestas}}
{{FeatureProjectInProgress |Improvement| Show the configured devices first, and discover in the background |afiestas@kde.org| Alex Fiestas}}
|}
|}
====Control Module====
====Control Module====
Line 78: Line 109:
|- style="background: #ececec; white-space:nowrap;"
|- style="background: #ececec; white-space:nowrap;"
! Status !! Type !! Description !! Contact
! Status !! Type !! Description !! Contact
{{FeatureDone |Feature| Add a Connect button in configure devices (like systray has) |[email protected]|Rafael Fernandez Lopez}}
{{FeatureProjectTodo |Feature| Add a Connect button in configure devices (like systray has) |[email protected]|Rafael Fernandez Lopez}}
|}
|}
====System tray====
====System tray====
{| class="sortable" border="1" cellpadding="4" cellspacing="0" style="border: gray solid 1px; border-collapse: collapse; text-align: left; width: 100%;"
{| class="sortable" border="1" cellpadding="4" cellspacing="0" style="border: gray solid 1px; border-collapse: collapse; text-align: left; width: 100%;"
|- style="background: #ececec; white-space:nowrap;"
|- style="background: #ececec; white-space:nowrap;"
! Status !! Type !! Description !! Contact
! Status !! Type !! Description !! Contact
{{FeatureDone |Improvement| Implement a better order in the systray options |alex@eyeos.org|Alex Fiestas}}
{{FeatureProjectTodo |Improvement| Improve way to connect and disconnect services |ereslibre@kde.org| Rafael Fernández López}}
{{FeatureDone |Improvement| Show a overlay icon when a device is connected |[email protected]| Alex Fiestas}}
{{FeatureProjectTodo |Improvement| Global disconnect from device (all services and device itself) |ereslibre@kde.org| Rafael Fernández López}}
{{FeatureDone |Improvement| Add a tooltip |alex@eyeos.org| Alex Fiestas}}
|}
|}
===BlueDevil 1.2 ===


====File Sharing====
====File Sharing====
Line 95: Line 124:
|- style="background: #ececec; white-space:nowrap;"
|- style="background: #ececec; white-space:nowrap;"
! Status !! Type !! Description !! Contact
! Status !! Type !! Description !! Contact
{{FeatureTodo |Feature|Be able to share folders and files |alex@eyeos.org|Alex Fiestas}}
{{FeatureProjectDone |Feature|Be able to share folders and files |afiestas@kde.org|Alex Fiestas}}
{{FeatureTodo |Feature| Add a KCM to configure/show the shared files  
{{FeatureProjectDone |Feature| Add a KCM to configure/show the shared files
|alex@eyeos.org|Alex Fiestas}}
|afiestas@kde.org|Alex Fiestas}}
{{FeatureTodo |Feature| Indicate in dolphin part with an overlay icon the shared files/folders |alex@eyeos.org|Alex Fiestas}}
{{FeatureProjectTodo |Feature| Indicate in dolphin part with an overlay icon the shared files/folders |afiestas@kde.org|Alex Fiestas}}
{{FeatureTodo |Feature| Be able to share folders/files directly from dolphinpart|alex@eyeos.org|Alex Fiestas}}
{{FeatureProjectTodo |Feature| Be able to share folders/files directly from dolphinpart|afiestas@kde.org|Alex Fiestas}}
|}
|}

Latest revision as of 19:52, 22 July 2022

How we work

All Solid projects operates in the same way, be sure to read How we work

Description

BlueDevil is the codename for the project which aims to integrate the Bluetooth technology into KDE Frameworks and KDE Plasma Desktop. The project is composed of a few components each of them have they own roadmap and maintainer.

List of components since 1.0:

  • KDE Bluetooth Agent: Alex Fiestas
  • Send File: Alex Fiestas
  • kio_obexftp: Alex Fiestas
  • kio_bluetooth: Alex Fiestas
  • Pairing Wizard: Alex Fiestas
  • File receiving: Alex Fiestas
  • Control Module: Rafael Fernandez Lopez
  • System tray: Rafael Fernandez Lopez

Project Status

The version 1.0 considered as stable has been released and will receive updates as minor versions (1.0.1 will be the first).

The version 1.1 is under a heavy development the roadmap can be found here

Documentation

Currently we're lacking a good End user documentation, help is needed.

How to collaborate

BlueDevil is a KDE project, so we use the usual ways to communicate to each other, and to work together.

Project Page

Currently BlueDevil is under extragear/base KDE Project Page

Mailing list

We're using the kde-hardware-devel mailing list kde-hardware-devel

Debugging

BlueDevil is composed by a set of components, some of them are debugged in a completely different way.

KIO's

The kio's are the hardest part of BlueDevil to debug:

  • Execute kdebugdialog --fullmode
  • Select kio_bluetooth or kio_obexftp
  • In all 4 sections choose the "File" option, and introduce an output path (for example /home/youruser/kio_obexftp.txt

In case that the bug is reproducible in Konqueror and Dolphin, use the first is preferred.

KCM

Try to reproduce the bug only using the affected module. For example in case that the affected module were filetransfer, you should execute: kcmshell4 bluedevilfiletransfer

To get a complete list you can execute: kcmshell4 --list | grep bluedevil

Wizard

Execute kdebugdialog, search "bluedevil" and activate everything. Then execute bluedevil-wizard in the terminal and provide the output.

Systray

Try to reproduce the bug step by step, restarting all BlueDevil (in the KCM)

Reporting

And finally, we're using http://bugs.kde.org, search twice before post a new bug. If a developer ask for feedback, and it is not provided within the following 30 days, the bug may be closed.

Testing before release

A set of tests must be done before a new version can be released so we can be quite sure that at least no regressions has been introduced.

Tests page

Releases

Roadmap

BlueDevil 1.2

We have one simple objective for BlueDevil 1.2, perfectionism

KDE Bluetooth Agent

Status Type Description Contact

bgcolor="#FFABAB" | FAILED

File receiving

Status Type Description Contact
TODO Research Port to obexd <[email protected]>

Pairing Wizard

Status Type Description Contact

Send File

Status Type Description Contact

kio_obexftp

Status Type Description Contact
TODO Improvement We need to have a better error handling, using the kio interface to report the errors <[email protected]>

kio_bluetooth

Status Type Description Contact
IN PROGRESS Improvement Show the configured devices first, and discover in the background <[email protected]>

Control Module

Status Type Description Contact
TODO Feature Add a Connect button in configure devices (like systray has) <[email protected]>

System tray

Status Type Description Contact
TODO Improvement Improve way to connect and disconnect services <[email protected]>
TODO Improvement Global disconnect from device (all services and device itself) <[email protected]>

File Sharing

Status Type Description Contact
DONE Feature Be able to share folders and files <[email protected]>
DONE Feature Add a KCM to configure/show the shared files <[email protected]>
TODO Feature Indicate in dolphin part with an overlay icon the shared files/folders <[email protected]>
TODO Feature Be able to share folders/files directly from dolphinpart <[email protected]>