yx_only_office_flutter/example/QUICK_START.md

1.5 KiB

快速运行指南

🚀 运行高级示例 (main_advanced.dart)

Windows (PowerShell)

cd example
flutter run -t lib/main_advanced.dart `
  --dart-define ONLYOFFICE_SERVER_URL=https://your-server.com `
  --dart-define ONLYOFFICE_FILE_URL=https://example.com/document.docx

Linux/macOS

cd example
flutter run -t lib/main_advanced.dart \
  --dart-define ONLYOFFICE_SERVER_URL=https://your-server.com \
  --dart-define ONLYOFFICE_FILE_URL=https://example.com/document.docx

📋 必需环境变量

  • ONLYOFFICE_SERVER_URL - 服务器地址
  • ONLYOFFICE_FILE_URL - 文档地址
  • ONLYOFFICE_JWT_SECRET - JWT 密钥(可选)
  • UPLOAD_URL - 图片上传地址(可选)

🔧 运行前准备

# 1. 安装依赖
cd example
flutter pub get

# 2. 检查设备
flutter devices

# 3. 运行
flutter run -t lib/main_advanced.dart --dart-define ...

📱 选择设备

# Android
flutter run -t lib/main_advanced.dart -d android --dart-define ...

# iOS
flutter run -t lib/main_advanced.dart -d ios --dart-define ...

# 查看所有设备
flutter devices

⚠️ 常见问题

问题: 找不到文件

# 确保在 example 目录下
cd example

问题: 环境变量未生效

# 检查拼写,确保使用 --dart-define
flutter run -t lib/main_advanced.dart --dart-define ONLYOFFICE_SERVER_URL=...

📖 更多信息

查看 HOW_TO_RUN_ADVANCED.md 获取详细说明。