AppFlowy-IO/AppFlowy

Fork 0

mirror of https://github.com/AppFlowy-IO/AppFlowy.git synced 2026-03-24 04:46:56 +00:00

[GH-ISSUE #56] [Help]: Debug Linux Build #29

New issue

Closed

opened 2026-03-23 20:30:40 +00:00 by mirror · 11 comments

mirror commented

2026-03-23 20:30:40 +00:00

Owner

Originally created by @appflowy on GitHub (Nov 21, 2021).
Original GitHub issue: https://github.com/AppFlowy-IO/AppFlowy/issues/56

Originally assigned to: @appflowy, @notd5a-alt on GitHub.

We have a half-baked Linux Build with some issues: some icons are missing.

So I want to debug on Ubuntu, but I'm having trouble debugging on Linux. Every time I'm on debug mode, the build process gets stuck, and my system becomes frozen.

At this point, I've come to a decision to focus on higher ROI work and put this one on hold, unfortunately. As a team of two, we have to keep going, and there are many important tasks on our plate. I'd like to make a call out here for help with this issue. Anyone interested in this can take it from where it's left out.

Debug environment setup:
Step 1:
Follow the instructions on https://github.com/AppFlowy-IO/appflowy/blob/main/doc/BUILD_ON_LINUX.md

Step 2:
open the frontend/scripts/build_sdk.sh, comment out the command based on your system.

# for macos
#cargo make --profile development-mac flowy-sdk-dev

# for window
#cargo make --profile development-windows flowy-sdk-dev


# for linux amd64
#cargo make --profile development-linux-x86 flowy-sdk-dev

# for linux aarch64
#cargo make --profile development-linux-aarch64 flowy-sdk-dev

Step 3:
open frontend/app_flowy with vs code.

Originally created by @appflowy on GitHub (Nov 21, 2021). Original GitHub issue: https://github.com/AppFlowy-IO/AppFlowy/issues/56 Originally assigned to: @appflowy, @notd5a-alt on GitHub. We have a half-baked Linux Build with some issues: some icons are missing. ![image](https://user-images.githubusercontent.com/86001920/142748349-42150dd0-d4f2-46eb-938c-d91f7721eb31.png) So I want to debug on Ubuntu, but I'm having trouble debugging on Linux. Every time I'm on debug mode, the build process gets stuck, and my system becomes frozen. At this point, I've come to a decision to focus on higher ROI work and put this one on hold, unfortunately. As a team of two, we have to keep going, and there are many important tasks on our plate. I'd like to make a call out here for help with this issue. Anyone interested in this can take it from where it's left out. Debug environment setup: Step 1: Follow the instructions on https://github.com/AppFlowy-IO/appflowy/blob/main/doc/BUILD_ON_LINUX.md Step 2: open the frontend/scripts/build_sdk.sh, comment out the command based on your system. ![image](https://user-images.githubusercontent.com/86001920/142750345-6d81bdab-2b6e-4cd8-81b9-cc0d23d7f036.png) ```shell # for macos #cargo make --profile development-mac flowy-sdk-dev # for window #cargo make --profile development-windows flowy-sdk-dev # for linux amd64 #cargo make --profile development-linux-x86 flowy-sdk-dev # for linux aarch64 #cargo make --profile development-linux-aarch64 flowy-sdk-dev ``` Step 3: open frontend/app_flowy with vs code. ![image](https://user-images.githubusercontent.com/86001920/142750352-597a08ba-8a2b-4ec4-92eb-ac0abd1dc3b8.png)

mirror

2026-03-23 20:30:40 +00:00

closed this issue
added the
help wanted
label

mirror commented

2026-03-23 20:30:40 +00:00

Author

Owner

@notd5a-alt commented on GitHub (Nov 21, 2021):

Im on Arch but i can try and see if the same issues arise there as well. If they do ill try and patch them.

@notd5a-alt commented on GitHub (Nov 21, 2021): Im on Arch but i can try and see if the same issues arise there as well. If they do ill try and patch them.

mirror commented

2026-03-23 20:30:41 +00:00

Author

Owner

@RaghaVdot24 commented on GitHub (Nov 21, 2021):

I'm on Ubuntu. Will try running this

@RaghaVdot24 commented on GitHub (Nov 21, 2021): I'm on Ubuntu. Will try running this

mirror commented

2026-03-23 20:30:41 +00:00

Author

Owner

@notd5a-alt commented on GitHub (Nov 21, 2021):

Ok. From what i can deduce, this seems to be a weird path capitalization issue with the icons.
For example: Flutter tries to load assets/images/home/trash.svg but the icon name is actually capitalized i.e. Trash.svg
The Error Thrown:

Unable to load asset: assets/images/editor/bold.svg
What its affecting:

trash.svg
add.svg
bold.svg
italic.svg
underline.svg
strikethrough.svg
numbers.svg
checkbox.svg
quote.svg
share.svg
Simply changing the icon names from: Trash.svg to trash.svg seems to fix this issue.

@notd5a-alt commented on GitHub (Nov 21, 2021): Ok. From what i can deduce, this seems to be a weird path capitalization issue with the icons. For example: Flutter tries to load `assets/images/home/trash.svg` but the icon name is actually capitalized i.e. Trash.svg The Error Thrown: > `Unable to load asset: assets/images/editor/bold.svg` What its affecting: - trash.svg - add.svg - bold.svg - italic.svg - underline.svg - strikethrough.svg - numbers.svg - checkbox.svg - quote.svg - share.svg Simply changing the icon names from: `Trash.svg` to `trash.svg` seems to fix this issue.

mirror commented

2026-03-23 20:30:41 +00:00

Author

Owner

@Silcet commented on GitHub (Nov 22, 2021):

I just managed to get AppFlowy running for the first time on a Manjaro (Arch Linux) distro. I can see that some of the icons are missing as mentioned before. I did my build based on main branch. I'll continue debugging a bit, but so far I got this screenshot in case it helps someone else:

@Silcet commented on GitHub (Nov 22, 2021): I just managed to get AppFlowy running for the first time on a Manjaro (Arch Linux) distro. I can see that some of the icons are missing as mentioned before. I did my build based on main branch. I'll continue debugging a bit, but so far I got this screenshot in case it helps someone else: ![image](https://user-images.githubusercontent.com/11076250/142915324-b50238e3-7a87-43c3-aa3d-e086f13f3a19.png)

mirror commented

2026-03-23 20:30:41 +00:00

Author

Owner

@Laegel commented on GitHub (Nov 23, 2021):

Hey, just tried to run it on my machine (Ubuntu 20.04, x86_64) and everything went well.
In my case, I already had Rust installed and didn't go through the optional steps.
I first checked it was building fine using the cargo make -p development-linux-x86 appflowy-linux-dev command.
As there was nothing wrong here, I went through steps 2 and 3 to install the debug environment and it was also working just fine:

Did you have trouble to make it run on this specific Ubuntu too or just the aarch64 architecture?
Do you want me to update the verified systems list?

[Edit] Looks like I can't type anything, neither on the title input nor in the rich text editor. Ignore this remark if it's normal.

@Laegel commented on GitHub (Nov 23, 2021): Hey, just tried to run it on my machine (**Ubuntu 20.04, x86_64**) and everything went well. In my case, I already had Rust installed and didn't go through the optional steps. I first checked it was building fine using the `cargo make -p development-linux-x86 appflowy-linux-dev` command. As there was nothing wrong here, I went through steps 2 and 3 to install the debug environment and it was also working just fine: ![image](https://user-images.githubusercontent.com/3584791/143026689-62896995-0ea5-4358-bf38-1c2f580358eb.png) Did you have trouble to make it run on this specific Ubuntu too or just the aarch64 architecture? Do you want me to update the verified systems list? [Edit] Looks like I can't type anything, neither on the title input nor in the rich text editor. Ignore this remark if it's normal.

mirror commented

2026-03-23 20:30:41 +00:00

Author

Owner

@pdckxd commented on GitHub (Nov 23, 2021):

I am experience same issue when running debug version of appflowy on lubuntu 20.04 . Looks like this is flutter issus specific for Linux.

@pdckxd commented on GitHub (Nov 23, 2021): I am experience same issue when running debug version of appflowy on lubuntu 20.04 . Looks like this is flutter issus specific for Linux.

mirror commented

2026-03-23 20:30:41 +00:00

Author

Owner

@notd5a-alt commented on GitHub (Nov 23, 2021):

So changing icon names and refs didnt fix the issue? Maybe an underlying flutter issue. Ill research and check.

@notd5a-alt commented on GitHub (Nov 23, 2021): So changing icon names and refs didnt fix the issue? Maybe an underlying flutter issue. Ill research and check.

mirror commented

2026-03-23 20:30:42 +00:00

Author

Owner

@pdckxd commented on GitHub (Nov 24, 2021):

So changing icon names and refs didnt fix the issue? Maybe an underlying flutter issue. Ill research and check.

I mean debug version of appflowy prevents people from typing. Sorry for confusion.

@pdckxd commented on GitHub (Nov 24, 2021): > So changing icon names and refs didnt fix the issue? Maybe an underlying flutter issue. Ill research and check. I mean debug version of appflowy prevents people from typing. Sorry for confusion.

mirror commented

2026-03-23 20:30:42 +00:00

Author

Owner

@notd5a-alt commented on GitHub (Nov 24, 2021):

Ah ok

On Wed, 24 Nov 2021, 12:17 am Alex Chen, @.***> wrote:

So changing icon names and refs didnt fix the issue? Maybe an underlying
flutter issue. Ill research and check.

I mean debug version of appflowy prevents people from typing. Sorry for
confusion.

—
You are receiving this because you were assigned.
Reply to this email directly, view it on GitHub
https://github.com/AppFlowy-IO/appflowy/issues/56#issuecomment-977310763,
or unsubscribe
https://github.com/notifications/unsubscribe-auth/AUYOQ53UDGM64LZMB26GSRTUNQVH7ANCNFSM5IOVRWQA
.

@notd5a-alt commented on GitHub (Nov 24, 2021): Ah ok On Wed, 24 Nov 2021, 12:17 am Alex Chen, ***@***.***> wrote: > So changing icon names and refs didnt fix the issue? Maybe an underlying > flutter issue. Ill research and check. > > I mean debug version of appflowy prevents people from typing. Sorry for > confusion. > > — > You are receiving this because you were assigned. > Reply to this email directly, view it on GitHub > <https://github.com/AppFlowy-IO/appflowy/issues/56#issuecomment-977310763>, > or unsubscribe > <https://github.com/notifications/unsubscribe-auth/AUYOQ53UDGM64LZMB26GSRTUNQVH7ANCNFSM5IOVRWQA> > . >

mirror commented

2026-03-23 20:30:42 +00:00

Author

Owner

@irfanbacker commented on GitHub (Nov 24, 2021):

I mean debug version of appflowy prevents people from typing. Sorry for confusion.

No issue for me on Pop!_OS 21.04 on both production and development builds

@irfanbacker commented on GitHub (Nov 24, 2021): > I mean debug version of appflowy prevents people from typing. Sorry for confusion. No issue for me on Pop!_OS 21.04 on both production and development builds

mirror commented

2026-03-23 20:30:42 +00:00

Author

Owner

@annieappflowy commented on GitHub (Dec 6, 2021):

Thank you all. Closing this issue as it's resolved.

@annieappflowy commented on GitHub (Dec 6, 2021): Thank you all. Closing this issue as it's resolved.

mirror referenced this issue

2026-03-23 21:35:37 +00:00

[PR #29] [MERGED] [DOCS] Added Command line source update command #3948