终极指南：xiaozhi-android-client多平台部署教程，从Flutter环境搭建到应用发布

【免费下载链接】xiaozhi-android-client 一个基于小智、xiaozhi-server的Android、IOS语音对话应用,支持实时语音交互和文字对话。现在是flutter版本，打通IOS、Android端。请同志们动动小手，点点小星星，予以鼓励。 项目地址: https://gitcode.com/gh_mirrors/xi/xiaozhi-android-client

xiaozhi-android-client是一个基于Flutter框架开发的多平台语音对话应用，支持Android、iOS、Windows、macOS和Linux系统，实现了实时语音交互和文字对话功能。本教程将从环境搭建到应用发布，全方位指导您完成xiaozhi-android-client的部署过程。

1. 快速了解xiaozhi-android-client

xiaozhi-android-client是一款功能强大的跨平台语音对话应用，通过Flutter框架实现了多端统一体验。应用支持与小智服务器(xiaozhi-server)的实时通信，提供流畅的语音交互和文字对话功能。

上图展示了应用的对话列表界面，您可以看到多个语音对话记录，包括通话状态和时长信息。

2. 准备工作：系统环境要求

在开始部署前，请确保您的开发环境满足以下要求：

• 操作系统：Windows 10/11、macOS 10.15+或Linux (Ubuntu 18.04+)
• 硬件要求：至少4GB内存，推荐8GB以上
• 网络环境：稳定的互联网连接（用于下载依赖和工具）
• 开发工具：Visual Studio Code或Android Studio

3. 一键安装：Flutter环境搭建

3.1 获取Flutter SDK

根据您的操作系统选择合适的安装方式：

Windows:

1. 下载Flutter SDK
2. 解压到不含特殊字符和空格的目录（如 C:\flutter）
3. 将 flutter\bin 添加到系统PATH变量

macOS:

brew install --cask flutter
export PATH="$PATH:`pwd`/flutter/bin"

Linux:

tar xf flutter_linux_3.7.0-stable.tar.xz
export PATH="$PATH:`pwd`/flutter/bin"

3.2 验证安装

安装完成后，运行以下命令验证Flutter环境：

flutter doctor

该命令会检查您的开发环境并提示需要安装的依赖项。根据提示解决所有问题后，您的Flutter环境就准备好了。

4. 项目获取与配置

4.1 克隆项目代码

git clone https://gitcode.com/gh_mirrors/xi/xiaozhi-android-client
cd xiaozhi-android-client

4.2 安装项目依赖

flutter pub get

4.3 平台特定配置

Android配置:

• 安装Android Studio
• 通过SDK Manager安装所需Android SDK版本
• 配置Android设备或模拟器

iOS配置 (仅限macOS):

cd ios
pod install
cd ..

桌面平台配置:

# Windows
flutter config --enable-windows-desktop

# macOS
flutter config --enable-macos-desktop

# Linux
flutter config --enable-linux-desktop

Web平台配置:

flutter config --enable-web

5. 运行应用：开发环境测试

完成配置后，您可以在不同平台上运行应用进行测试：

# 在连接的设备上运行
flutter run

# 指定平台运行
flutter run -d windows
flutter run -d macos
flutter run -d chrome
flutter run -d <device-id>

上图展示了应用的语音通话界面，应用正在监听用户语音输入，通话时长和声学处理状态实时显示在界面上。

6. 应用发布：构建正式版本

6.1 Android平台

# 构建APK
flutter build apk --release

# 构建App Bundle
flutter build appbundle --release

构建结果位于 build/app/outputs/apk/release/app-release.apk

6.2 iOS平台

flutter build ios --release

然后在Xcode中打开 ios/Runner.xcworkspace，配置签名后生成IPA文件。

6.3 桌面平台

# Windows
flutter build windows --release

# macOS
flutter build macos --release

# Linux
flutter build linux --release

6.4 Web平台

flutter build web --release

构建结果位于 build/web 目录，可直接部署到Web服务器。

7. AI服务配置指南

7.1 小智服务配置

1. 在应用中导航至"设置" > "小智服务"
2. 输入以下信息:
   • 名称: 自定义配置名称
   • WebSocket URL: 小智服务端的WebSocket连接地址
   • MAC地址: 设备MAC地址（适用于蓝牙设备）
   • 令牌: 认证令牌

7.2 Dify配置

1. 访问Dify官网创建账户并获取API密钥
2. 在应用设置中添加新的Dify配置:
   • 名称: 自定义配置名称
   • API Key: 从Dify控制台获取的密钥
   • API URL: Dify服务的API端点

上图展示了应用的多对话管理界面，您可以看到不同AI助手的对话记录和状态。

8. 常见问题解决

8.1 依赖获取失败

尝试使用国内镜像源:

export PUB_HOSTED_URL=https://pub.flutter-io.cn
export FLUTTER_STORAGE_BASE_URL=https://storage.flutter-io.cn
flutter clean
flutter pub get

8.2 iOS构建失败

cd ios
rm -rf Pods
pod install
cd ..
flutter run

8.3 Android Gradle同步失败

编辑 android/gradle.properties 添加国内镜像或代理设置。

9. 官方文档与资源

• 详细安装指南: documents/docs/guide/Flutter安装指南.md
• 系统依赖说明: documents/docs/guide/02_系统依赖及安装.md
• Flutter官方文档: https://flutter.dev/docs

通过以上步骤，您已经成功完成了xiaozhi-android-client的多平台部署。无论是移动设备、桌面平台还是Web端，都能享受到一致的语音对话体验。如果您在部署过程中遇到任何问题，欢迎查阅官方文档或提交issue寻求帮助。

【免费下载链接】xiaozhi-android-client 一个基于小智、xiaozhi-server的Android、IOS语音对话应用,支持实时语音交互和文字对话。现在是flutter版本，打通IOS、Android端。请同志们动动小手，点点小星星，予以鼓励。 项目地址: https://gitcode.com/gh_mirrors/xi/xiaozhi-android-client