yx_only_office_flutter/example/QUICK_START.md

73 lines
1.5 KiB
Markdown

# 快速运行指南
## 🚀 运行高级示例 (main_advanced.dart)
### Windows (PowerShell)
```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
```bash
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` - 图片上传地址(可选)
## 🔧 运行前准备
```bash
# 1. 安装依赖
cd example
flutter pub get
# 2. 检查设备
flutter devices
# 3. 运行
flutter run -t lib/main_advanced.dart --dart-define ...
```
## 📱 选择设备
```bash
# 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
```
## ⚠️ 常见问题
**问题**: 找不到文件
```bash
# 确保在 example 目录下
cd example
```
**问题**: 环境变量未生效
```bash
# 检查拼写,确保使用 --dart-define
flutter run -t lib/main_advanced.dart --dart-define ONLYOFFICE_SERVER_URL=...
```
## 📖 更多信息
查看 [HOW_TO_RUN_ADVANCED.md](HOW_TO_RUN_ADVANCED.md) 获取详细说明。