Solid/Projects/BlueDevil: Difference between revisions

From KDE Community Wiki

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

1.0.1

Roadmap

BlueDevil 1.1

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]>

Retrieved from "https://community.kde.org/index.php?title=Solid/Projects/BlueDevil&oldid=94239"

@@ Line 19: / Line 19: @@
 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
@@ 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 ==
-===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====
@@ Line 35: / Line 71: @@
 |- style="background: #ececec; white-space:nowrap;"
 ! 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;"
 ! 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;"
 ! 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 59: / Line 91: @@
 |- style="background: #ececec; white-space:nowrap;"
 ! Status !! Type !! Description !! Contact
-{{FeatureTodo |Feature| Support all Bluetooth pairing modes |[email protected]| Alex Fiestas}}
-{{FeatureTodo |Revision| Be sure that all the helpers work |[email protected]| Alex Fiestas}}
 |}
 ====kio_obexftp====
 {| 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;"
 ! 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====
@@ Line 73: / Line 103: @@
 |- style="background: #ececec; white-space:nowrap;"
 ! 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====
@@ Line 79: / Line 109: @@
 |- style="background: #ececec; white-space:nowrap;"
 ! 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====
 {| 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;"
 ! 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 |[email protected]| Rafael Fernández López}}
-{{FeatureDone |Improvement| Show a overlay icon when a device is connected |alex@eyeos.org| Alex Fiestas}}
+{{FeatureProjectTodo |Improvement| Global disconnect from device (all services and device itself) |[email protected]| Rafael Fernández López}}
-{{FeatureDone |Improvement| Add a tooltip |alex@eyeos.org| Alex Fiestas}}
+|}
+====File Sharing====
+{| 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;"
+! Status !! Type !! Description !! Contact
+{{FeatureProjectDone |Feature|Be able to share folders and files |[email protected]|Alex Fiestas}}
+{{FeatureProjectDone |Feature| Add a KCM to configure/show the shared files
+|afiestas@kde.org|Alex Fiestas}}
+{{FeatureProjectTodo |Feature| Indicate in dolphin part with an overlay icon the shared files/folders |afiestas@kde.org|Alex Fiestas}}
+{{FeatureProjectTodo |Feature| Be able to share folders/files directly from dolphinpart|afiestas@kde.org|Alex Fiestas}}
 |}