🔁

Debugging in VS Code

Multiple launch configurations and tasks are defined for AppFlowy. These are used in the build process in order to generate needed files, clean up temporary files, and compile the source code.
Launch Configurations
A launch configuration is what is used when you type F5 or Ctrl-F5to launch the application.
You can select your preferred launch configuration by going to the Run and Debug tab in VS Code.
Name
Description
AF-desktop: Build All
This will build the Rust and Dart code of AppFlowy.
AF-desktop: Build Dart Only
This will only build the Dart code of AppFlowy. This should be your default when you are working on Flutter code.
AF-desktop: Clean + Rebuild All
This task will:
call the "AF: Clean" task,
rebuild all the generated Files (including freeze and language files)
rebuild the the Rust and Dart code of AppFlowy.
This launch configuration is a convenience. A better way to do this would be to directly trigger the "AF-desktop: Clean + Rebuild All" task.
AF-desktop: Debug Rust
This will show the lldb attach menu, in which you should select the app_flowy program to debug rust. Please note that this task is only valid when app_flowy is running and the codellb plugin for VS Code is installed.
AF-tauri: Debug backend
Run the tauri application and enable debugging the backend
Launch configurations are defined in the /frontend/.vscode/launch.json file
Tasks
Tasks are be launched manually (although you are free to keybind them locally). You can see a list of all tasks available by initiating the command palette (Ctrl-Shift-P) and then typing "run task".
Inititiate the command palette with Ctrl-Shift-P
You can now type "AF:" to see a list of all AppFlowy provided tasks. Click on the desired task to trigger it.
The AppFlowy tasks
We recommend binding the Alt-T key combination to the "Tasks: Run Task" command. This is done by initiating the command palette (Ctrl-Shift-P) and then typing "Open Keyboard Shortcuts".
Note that Ctrl-Shift-B will trigger the default build task. We have configured AF: Code Gen as the default build task.
In order to make them easy to identify, all AppFlowy defined tasks are prefixed with "AF: "
Name
Description
Depend On
AF: Clean + Rebuild All
This task will clean the code base, regenerate all needed files, and then build the Rust and Dart code of AppFlowy.
AF: Clean
AF: Flutter Pub
AF: Flutter Package Get
AF: Generate Language Files
AF: Generate Freezed Files
AF: build_flowy_sdk
AF: Build Appflowy Core
This task builds only the Rust code of AppFlowy.
​
AF: Code Gen
This task will regenerate the required files to build AppFlowy. This includes the language translations, freezed files. It does not include the protobuf files.

Note: This is the "default build task", this can be executed at any time by typing Ctrl-Shift-B.
AF: Flutter Pub
AF: Flutter Package Get
AF: Generate Language Files
AF: Generate Freezed Files
AF: Flutter Pub Get
This will execute the flutter pub get command in the /frontend/app_flowy directory
​
AF: Flutter Package Get
This will execute the flutter packages pub get command in the /frontend/app_flowy directory
​
AF: Generate Freezed Files
This will generate all the required freezed files.
​
AF: Generate Language Files
This will generate all the required language translation files
​
AF: flutter build aar
This will build AppFlowy in .aar format
​
Tasks are defined in the /frontend/.vscode/tasks.json file.

Name	Description
AF-desktop: Build All	This will build the Rust and Dart code of AppFlowy.
AF-desktop: Build Dart Only	This will only build the Dart code of AppFlowy. This should be your default when you are working on Flutter code.
AF-desktop: Clean + Rebuild All	This task will: call the "`AF: Clean`" task, rebuild all the generated Files (including freeze and language files) rebuild the the Rust and Dart code of AppFlowy. This launch configuration is a convenience. A better way to do this would be to directly trigger the "`AF-desktop: Clean + Rebuild All`" task.
AF-desktop: Debug Rust	This will show the `lldb` attach menu, in which you should select the `app_flowy` program to debug rust. Please note that this task is only valid when `app_flowy` is running and the `codellb` plugin for VS Code is installed.
AF-tauri: Debug backend	Run the tauri application and enable debugging the backend

Name	Description	Depend On
AF: Clean + Rebuild All	This task will clean the code base, regenerate all needed files, and then build the Rust and Dart code of AppFlowy.	AF: Clean AF: Flutter Pub AF: Flutter Package Get AF: Generate Language Files AF: Generate Freezed Files AF: build_flowy_sdk
AF: Build Appflowy Core	This task builds only the Rust code of AppFlowy.
AF: Code Gen	This task will regenerate the required files to build AppFlowy. This includes the language translations, freezed files. It does not include the protobuf files. Note: This is the "default build task", this can be executed at any time by typing `Ctrl-Shift-B`.	AF: Flutter Pub AF: Flutter Package Get AF: Generate Language Files AF: Generate Freezed Files
AF: Flutter Pub Get	This will execute the `flutter pub get` command in the `/frontend/app_flowy` directory
AF: Flutter Package Get	This will execute the `flutter packages pub get` command in the `/frontend/app_flowy` directory
AF: Generate Freezed Files	This will generate all the required freezed files.
AF: Generate Language Files	This will generate all the required language translation files
AF: flutter build aar	This will build AppFlowy in .aar format

Tauri Setup

Unit Test

Last modified 7d ago