LogoLogo
  • AppFlowy
    • ⭐Start here
      • Welcome to AppFlowy Docs
      • How to get help
      • Install AppFlowy
    • 🛠️Installation
      • 🖥️System Requirements
      • 💿Installation methods
        • Mac / Windows / Linux Packages
          • Installing on Linux
            • Installing & Setting up Flutter on Linux from Source
        • Docker
    • 🌱Community
      • 🤙Get in contact
      • 📔AppFlowy Mentorship Program
        • Program Guidance
        • Proposal Template
        • Pull Request Template
        • Mentorship 2023
          • Mentee Projects
            • Calendar View for AppFlowy Database
            • Custom Themes
            • Shortcuts and Customized Hotkeys for AppFlowy
            • Table
            • ⭐Favorites
            • Code Block
            • Outlines
            • Importers
            • AI Writers
            • Templates
          • Project Ideas
      • ✍️Write for AppFlowy
        • 📃Drafts
          • [Draft] Use Case: Software Engineer
          • [Draft] Use Case: High School Students
          • [Draft] How to add a new property to appflowy database
      • 🍂Hacktoberfest
    • 🛣️Roadmap
    • 🌋Product
      • 💽Data Storage
      • 🎨Customize and Style Content
      • ⏮️Duplicate, Delete, and Restore
      • 💎Databases
        • 🔢Database Properties
        • 🗃️Manage Properties
      • Ⓜ️Markdown
      • ⌨️Shortcuts
      • 🪄AppFlowy AI
      • 🦙AppFlowy Local AI - Ollama
      • 🎨Themes
      • ☁️AppFlowy Cloud
      • 🧩AppFlowy Plugins
        • Table-view Databases
        • Kanban Board
        • Calendar
        • Auto Generator
        • Smart Edit
        • Code Blocks
        • Math Equations
        • Cover
        • Emoji
  • Documentation
    • 💎Software Contributions
      • 🟢Get started
      • 💀Architecture
        • Frontend
          • Tauri
            • 🗺️CodeMap
          • Web
            • 🌟Design Philosophy
          • Flutter
            • 🗺️Project Structure: CodeMap
            • 🧮Grid
            • ⚙️Setting
          • Inter-Process Communication
          • User
            • User Data
            • Events & Notifications
          • Folder
            • Events & Notifications
          • Document
          • Database View
            • Events & Notifications
            • Grid
            • Calendar
            • Kanban Board
        • Backend
          • Initialize
          • Events
          • Delta(WIP)
          • Profiling
          • Database
        • Domain Driven Design
        • Proposals
      • 🏗️Conventions
        • 🔤Naming Conventions
        • ⌨️Code Conventions
          • 🐦Flutter
        • 🐙Git Conventions
      • 💛Submitting Code
        • 🏦Setting Up Your Repositories
        • ⤴️Submitting your first Pull Request
      • 🤟Coding Standards and Practices
        • 👽Rust Backend
    • 🚀AppFlowy
      • 👾How to contribute to AppFlowy
      • 🏗️Building from Source
        • 🌳Flutter Setup
          • 🐧Building on Linux
          • 🍎Building on macOS
          • 🪟Building on Windows
        • 🌐Web Setup
        • 📡Tauri Setup
      • ☁️Debugging with AppFlowy Cloud
      • 🔁Debugging in VS Code
      • ☎️Translate AppFlowy
      • ❓Troubleshooting
      • 👮‍♀️Licenses
    • 🏍️AppFlowy Editor
      • ⌨️How to Implement Markdown Syntax To Style Text In AppFlowy Editor
      • 🧩How to Create a Plugin for AppFlowy Editor
      • 👮‍♀️Licenses
    • ☁️AppFlowy Cloud
      • 🌈Architecture
      • ☀️Deployment
  • Guides
    • Sync Desktop and Mobile
    • Self-Hosting AppFlowy
      • ☁️Self-hosting AppFlowy with AppFlowy Cloud
      • 🆓Self-hosting AppFlowy for free Using Supabase
    • Import From Notion
  • Blog Highlights
    • 🔮Demystifying AppFlowy Editor's Codebase
  • Handbook
    • Core values
Powered by GitBook
On this page
  • ❓ Troubleshooting
  • 1. Protobuf Generation Errors
  • 2. Remove outdated files
  • 3. Error: Not found: 'dart:ffi'
  • 4. How to use sql-data.json
  • 5. How to create a pull request
  • 6. Permission denied
  • 7. Failed to load dynamic library 'libdart_ffi.so'
  • 8. Build failed on Ubuntu 20.04
  • 9. The document data could not be saved on Ubuntu
  • 10. Can't build development environment
  • 11. Docker Hub (app_flowy:1): Gtk-WARNING **: 10:44:25.079: cannot open display
  • 12. Failed to start Flutter renderer: Unable to create a GL context
  • 13. Cannot run on Macbook M1 chip
  • 14. Windows Build Failed
  • 15. Malicious software warning on install- MAC-OS
  • 16. Cannot run on Ubuntu 22.04
  • 17. Run appyflowy in docker,but it not work: cannot open display: 0
  • 18. Can't run tests on windows "Failed to load dynamic library"

Was this helpful?

Edit on GitHub
  1. Documentation
  2. AppFlowy

Troubleshooting

PreviousTranslate AppFlowyNextLicenses

Last updated 1 year ago

Was this helpful?

❓ Troubleshooting

First of all, make sure the version of flutter and rust is the version specified in

1. Protobuf Generation Errors

  1. Ensure the protoc-gen is installed

which protoc-gen-dart
  1. Ensure the $HOME/.pub-cache/bin is shown in your $PATH.

echo $PATH
  1. Ensure VS Code uses bash as the default terminal You can check out this for more information.

2. Remove outdated files

AppFlowy uses CodeGen to generate some files that are ignored by git. So remove these files if there are some errors, warnings, and reference errors.

Here are the files are safe to remove

  1. AppFlowy/frontend/app_flowy/packages/flowy_sdk

  2. AppFlowy/frontend/app_flowy/packages/appflowy_backend/lib/dispatch/dart_event

  3. AppFlowy/frontend/app_flowy/packages/appflowy_backend/lib/protobuf

3. Error: Not found: 'dart:ffi'

Flutter Web / Android / iOS is not supported yet. Please switch to macOS or other supported devices.

4. How to use sql-data.json

Q: How to use sql-data.json

A: Check the offline mode section:

5. How to create a pull request

6. Permission denied

7. Failed to load dynamic library 'libdart_ffi.so'

ArgumentError (Invalid argument(s): Failed to load dynamic library 'libdart_ffi.so': dlopen failed: library "libdart_ffi.so" not found)

A: Are you trying to build for android? Appflowy only supports desktops as of now

A: I append ubuntu 21.04 source.list's content to /etc/apt/source.list, and then upgrade libc6.

# Append the ubuntu 20.04's source.list to its tail.
$ sudo vim /etc/apt/source.list
$ sudo apt upgrade libc6

8. Build failed on Ubuntu 20.04

Q: I follow the BUILD_ON_LINUX.md and failed on step 10 cargo make --profile development-linux-x86 flowy-sdk-dev

To Reproduce Just follow the BUILD_ON_LINUX.md

A: There are some issues in protobuf generation of appflowy on linux. If you skip that step, you can get it working. Protobuf has already been generated and is tracked in the repository. So it will work without regeneration as of now.

9. The document data could not be saved on Ubuntu

10. Can't build development environment

Q. While executing install_linux.sh script at compiling diesel_cli i'm getting following error:

error: linking with `cc` failed: exit status: 1
...
= note: /usr/bin/ld: cannot find -lsqlite3
          collect2: error: ld returned 1 exit status


error: could not compile `diesel_cli` due to previous error
error: failed to compile `diesel_cli v2.0.0`, intermediate artifacts can be found at `/tmp/cargo-install4xWPP3`

11. Docker Hub (app_flowy:1): Gtk-WARNING **: 10:44:25.079: cannot open display

12. Failed to start Flutter renderer: Unable to create a GL context

⋊> ./app_flowy
** (app_flowy:21547): WARNING **: 03:05:10.061: Failed to start Flutter renderer: Unable to create a GL context
** (app_flowy:21547): WARNING **: 03:05:12.733: Unable to retrieve framework response: No engine to send to

13. Cannot run on Macbook M1 chip

[issue #255] (https://github.com/AppFlowy-IO/AppFlowy/issues/255)

14. Windows Build Failed

15. Malicious software warning on install- MAC-OS

16. Cannot run on Ubuntu 22.04

[ERROR:flutter/lib/ui/ui_dart_state.cc(198)] Unhandled Exception: Invalid argument(s): Failed to load dynamic library 'libdart_ffi.so': libssl.so.1.1: cannot open shared object file: No such file or directory
#0      _open (dart:ffi-patch/ffi_dynamic_library_patch.dart:12)
#1      new DynamicLibrary.open (dart:ffi-patch/ffi_dynamic_library_patch.dart:23)
#2      _open (package:flowy_sdk/ffi.dart:23)
#3      _dl (package:flowy_sdk/ffi.dart:10)
#4      _set_stream_port (package:flowy_sdk/ffi.dart)
#5      set_stream_port (package:flowy_sdk/ffi.dart)
#6      FlowySDK.init (package:flowy_sdk/flowy_sdk.dart:32)
#7      InitRustSDKTask.initialize.<anonymous closure> (package:app_flowy/startup/tasks/rust_sdk.dart:13)
#8      InitRustSDKTask.initialize.<anonymous closure> (package:app_flowy/startup/tasks/rust_sdk.dart:12)
#9      _rootRunUnary (dart:async/zone.dart:1434)
<asynchronous suspension>
#10     InitRustSDKTask.initialize (package:app_flowy/startup/tasks/rust_sdk.dart:12)
<asynchronous suspension>
#11     AppLauncher.launch (package:app_flowy/startup/startup.dart:99)
<asynchronous suspension>

17. Run appyflowy in docker,but it not work: cannot open display: 0

Q:

Bug Description

xhost + docker run --rm -v $HOME/.Xauthority:/root/.Xauthority:rw -v /tmp/.X11-unix:/tmp/.X11-unix -v /dev/dri:/dev/dri -v /var/run/dbus/system_bus_socket:/var/run/dbus/system_bus_socket -v appflowy-data:/home/appflowy -e DISPLAY=${DISPLAY} appflowyio/appflowy_client:main

(app_flowy:1): Gtk-WARNING **: 01:27:57.247: cannot open display: :0

A:

I add the param --network=host

and it works

18. Can't run tests on windows "Failed to load dynamic library"

If you're trying to run tests on windows, but they're failing due to this message:

Invalid argument(s): Failed to load dynamic library
'C:\Users\mathias\AppFlowy\frontend\appflowy_flutter/.sandbox/dart_ffi.dll': error code 126
dart:ffi
open
   ...

Run this command from the frontend directory: cargo make dart_unit_test

Optionally you can run this in bash instead of the above one, but you must be inside the appflowy_flutter directory: flutter test --dart-define=RUST_LOG=INFO -j, --concurrency=1 --coverage

A:

A:

Q: Hello, when I run app with vs code&android&mac m1, it gave error:

Q. Unhandled Exception: Invalid argument(s): Failed to load dynamic library 'libdart_ffi.so' on Ubuntu.

🚀
❓
here
link
issue #38
https://github.com/AppFlowy-IO/appflowy/blob/main/backend/sqlx-data.json
https://docs.rs/sqlx/0.4.0-beta.1/sqlx/macro.query.html
https://opensource.com/article/19/7/create-pull-request-github
https://stackoverflow.com/questions/2643502/git-how-to-solve-permission-denied-publickey-error-when-using-git
issue #112
issue #191
issue #106
issue #1306
issue #1076
issue #389
issue #295
issue #210
issue #18
issue #1313
issue #566
issue: #2458