开源团队协作工具 AppFlowy 安装和使用指南

AppFlowy 是一款开源的团队协作工具，与 Notion 相比，AppFlowy 允许用户完全掌控自己的数据，提供更加灵活的自定义能力，适合个人和企业使用。

AppFlowy 采用 Flutter 和 Rust 技术栈开发，支持跨平台部署，包括 macOS、Windows、Linux、iOS 和 Android。

AppFlowy 提供了强大的任务管理功能，包括：

收件箱（Inbox）：快速记录和整理待办事项

任务追踪器（Task Tracker）：按截止日期、优先级等维度管理任务

看板视图（Kanban）：通过拖拽方式管理任务状态（规划、进行中、已完成）

项目管理：支持按优先级、日期等维度组织项目任务

富文本编辑：支持多种内容块，如文本、列表、引用、代码块等

模板系统：提供多种模板，包括项目管理、团队手册、内容日历等

团队空间：创建共享空间，实现多人协作编辑

数据库功能：支持创建和管理结构化数据

AppFlowy 提供了移动应用版本，支持 iOS 和 Android 设备，用户可以在移动设备上随时随地访问和管理自己的工作内容，移动应用支持以下功能：

• 任务查看和更新

• 文档编辑

• 离线访问

• 通知提醒

技术栈

AppFlowy 采用以下技术构建：

前端：Flutter（跨平台 UI 框架）

后端：Rust（系统级编程语言，保证性能和安全性）

国际化：inlang（支持多语言翻译）

构建工具：cargo-make（Rust 构建工具）

在 Linux 上构建 AppFlowy

以下步骤在多个 Linux 发行版上验证通过，包括：

• Lubuntu 20.04 - x86_64

• Linux Mint 20.3 - x86_64

• Ubuntu 20.04 - aarch64

• Ubuntu 22.04 - x86_64

• Redhat Linux - x86_64

• Fedora 37 - x86_64

• Arch Linux - x86_64

• Deepin - x86_64

• Raspberry Pi OS - aarch64

步骤 1：获取源代码

使用 git 克隆项目仓库：

git clone https://github.com/AppFlowy-IO/AppFlowy.git

如果系统未安装 git，使用包管理器安装：

# Ubuntu
sudo apt install git
# Fedora
sudo dnf install git
# Arch
sudo pacman -S git

步骤 2：安装构建环境

Ubuntu 系统

sudo apt-get install curl build-essential libsqlite3-dev libssl-dev clang cmake ninja-build pkg-config libgtk-3-dev unzip libkeybinder-3.0-dev libnotify-dev

Fedora 系统

sudo dnf install sqlite-devel keybinder3-devel clang cmake ninja-build openssl-devel

Arch 系统

sudo pacman -S curl base-devel sqlite openssl clang cmake ninja pkg-config gtk3 unzip libkeybinder3 xdg-user-dirs

步骤 3：安装 Flutter

Flutter 3.27.4 是支持构建 AppFlowy 的稳定版本，以下是三种安装方法：

方法 1：官方安装

按照Flutter 官方文档 https://docs.flutter.dev/get-started/install/linux 进行安装，将 Flutter 安装到合适的目录。

方法 2：手动安装

git clone https://github.com/flutter/flutter.git --branch 3.27.4
cd flutter
echo -e "\nexport PATH=\$PATH:"`pwd`"/bin" >> ~/.bashrc
source ~/.bashrc
cd ..

方法 3：使用 asdf 版本管理器

# 克隆 asdf
git clone https://github.com/asdf-vm/asdf.git ~/.asdf --branch v0.11.1
# 配置 asdf
echo -e '\n# asdf 配置 \n. "$HOME/.asdf/asdf.sh"\n. "$HOME/.asdf/completions/asdf.bash"' >> ~/.bashrc
source ~/.bashrc
# 进入 AppFlowy 目录
cd AppFlowy
# 添加 flutter 插件
asdf plugin-add flutter
# 安装 Flutter 3.27.4
asdf install flutter 3.27.4-stable
# 设置本地运行时
rm -rf .tool-versions
asdf local flutter 3.27.4-stable
cd ..

步骤 4：设置开发环境

运行安装脚本：

cd AppFlowy
./frontend/scripts/install_dev_env/install_linux.sh
source ~/.bashrc

步骤 5：构建 AppFlowy

进入前端目录：

cd frontend

构建发布版本：

cargo make --profile production-linux-x86_64 appflowy

构建调试版本：

cargo make --profile development-linux-x86_64 appflowy-dev

构建后的二进制文件位于：frontend/appflowy_flutter/product/[版本号]/linux/[Release/Debug]/AppFlowy/

步骤 6：运行应用

运行发布版本：

cd appflowy_flutter/product/[版本号]/linux/Release/AppFlowy
./app_flowy

运行调试版本：

cd appflowy_flutter/product/[版本号]/linux/Debug/AppFlowy
./app_flowy

在 macOS 上构建 AppFlowy

步骤 1：获取源代码

git clone https://github.com/AppFlowy-IO/AppFlowy.git

步骤 2：安装 Flutter

如果系统未安装 Flutter，按照 Flutter 官方文档 https://docs.flutter.dev/get-started/install/macos 进行安装。安装完成后运行 flutter doctor 检查依赖。

需要安装 CocoaPods 和 VS Code，并在 VS Code 中安装 Flutter 和 Dart 扩展。

步骤 3：安装构建环境

运行设置脚本：

cd AppFlowy
./frontend/scripts/install_dev_env/install_macos.sh

添加 pub 到路径：

echo "export PATH=\"\$PATH:\$HOME/.pub-cache/bin\"" >> ~/.bashrc
source ~/.bashrc

重启终端和 VS Code。

步骤 4：运行应用

使用 VS Code 打开 AppFlowy/frontend 目录，不要打开根目录。

在 VS Code 中，进入“运行和调试”选项卡，首次运行时点击“AF-desktop: Clean + Rebuild All”。

构建发布版本

根据架构选择命令：

x86 架构：

cd AppFlowy/frontend
cargo make --profile production-mac-x86_64 appflowy

arm64 架构：

cd AppFlowy/frontend
cargo make --profile production-mac-arm64 appflowy

发布版本的二进制文件位于：AppFlowy/frontend/appflowy_flutter/product/x.x.x/[OS]/Release/AppFlowy/