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.
A launch configuration is what is used when you type F5 or Ctrl-F5to launch the application.
You can select your prefered launch configuration by going to the Run and Debug tab in VS Code.
In order to make them easy to identify, all of AppFlowy's launch configurations are prefixed with "AF: ".
| Name | Description |
|---|---|
| AF: Build All | This will build the Rust and Dart code of AppFlowy. |
| AF: 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: 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: Clean + Rebuild All | This task will:
This launch configuration is a convenience. A better way to do this would be to directly trigger the " |
| AF: Build All (rustlog: trace) | |
| AF: app_flowy (profile mode) |
Launch configurations are defined in the /frontend/.vscode/launch.json file
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".
You can now type "AF:" to see a list of all AppFlowy provided tasks. Click on the desired task to trigger it.
{% hint style="info" %}
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".
{% endhint %}
{% hint style="info" %}
Note that Ctrl-Shift-B will trigger the default build task. We have configured AF: Code Gen as the default build task.
{% endhint %}
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: build_flowy_sdk | This task builds only the Rust code of AppFlowy. This is done by calling the build_sdk script. |
|
| 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. |
|
| 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: Clean | This will call the clean.shscript, which in turn calls cargo clean |
|
| AF: flutter build aar | This will build AppFlowy in .aar format |
Tasks are defined in the /frontend/.vscode/tasks.json file.