Troubleshooting Problems
When using any application, it's possible to encounter issues or problems that can prevent it from functioning as intended.
These issues may range from minor annoyances to major bugs that significantly impact the user experience.
As a user of the application, it's important to report these issues to the developers so that they can address and get it fixed.
Overall, reporting issues is a crucial part of the software development process, and it helps to ensure that the applications are reliable,
functional and user-friendly. Few issues are listed below.
Application Installation
If you encounter problems with some the libraries (requirements.txt), such as a few libraries that cannot be installed on the computer, as shown in the image below.
PyQt6 cannot installation
Sphinx-rtd-theme incompatible (Theme)
We recommend creating a specific virtual environment for no errors to occur when users try to install the library. As follows.
$ sudo apt-get install python3.9-venv
$ python3.9 -m venv venv
$ source venv/bin/activate
$ pip --version
Screen Recording on Application
The difficulty in using MoilApp's screen recording functions is that the captured video can only be seen as a black screen and cannot be played back due to the type system protocol. You can, however, fix this by following the instructions below.
Wayland type screen
Command to check the of type security screen
$ echo $XDG_SESSION_TYPE
open configuration
Command to open custom configuration
$ sudo nano /etc/gdm3/custom.config
Change to waylandEnable=False
Restart your computer
Command for restart your computer
$ sudo systemctl restart gdm3
The last way is if the condition has been on x11 type, however, the program still cannot be running, may you should be typing command on your terminal to fix it.
$ sudo apt install libxcb-cursor0
Python.h Missing on Python-dev
If you encounter installation problem with pybind while using MoilCV, you can install python-dev that is compatible with your Python version to resolve the issue. The steps to take are the instructions provided below.
$ sudo apt-get install python3.8-dev
or
$ sudo apt-get install python3.9-dev
Python-dev installed based on version
Sphinx Documentation for PDF
Difficulty in accessing the MoilApp documentation in PDF format is a common issue encountered by users. This is often caused by errors that occur during the initial conversion of the documentation to HTML. To resolve this issue. Please endure that you follow the instructions carefully.
Convert rst file to html file
If the following error occurs, we advise installing an additional library so that it can be converted properly.
Command for install library
$ sudo apt install latexmk
$ sudo apt install textlive-latex-extra
The command below can be typed in the terminal to access the documentation.
Command for generate file
$ make html
$ make latexpdf
This command is employed for deleting a documentation file, and it is also beneficial when updating a modified file. If the previous file is not deleted, the documentation will still show the outdated file instead of the updated version.
$ make clean
Application running
You cannot update the application when an update notification is present when you establish a new branch and add some functions, or alter the source code, you will encounter an error and a dump if you try this.
check for update on local branch
To update your branch, you can use this command in case you encounter an error. This command will ensure that any changes made are saved locally.
$ git stash save "Save comment in local computer"
And then, try do change another branch again.
$ git checkout "develop/main"
Adjustment of name your branch want to change