一、准备工作
1. 网络环境配置
- 确保局域网内可以访问必要的开发资源
- 配置内部代理服务器(如需访问外部资源)
- 设置内部DNS解析(如需自定义域名)
2. 基础软件安装
- 操作系统:Windows/macOS/Linux(推荐macOS,便于iOS开发)
- 版本控制:Git(配置内部GitLab/Git服务器)
- IDE:Android Studio/VSCode(局域网内分发安装包)
二、Flutter SDK安装
1. 内部镜像源配置
# 配置Flutter国内镜像(或搭建内部镜像)
export PUB_HOSTED_URL=https://your-internal-mirror/pub/
export FLUTTER_STORAGE_BASE_URL=https://your-internal-mirror/flutter/
2. Flutter SDK安装
# 从内部服务器下载Flutter SDK
wget http://your-internal-server/flutter-sdk.zip
unzip flutter-sdk.zip -d ~/development
# 添加到PATH
echo 'export PATH="$PATH:$HOME/development/flutter/bin"' >> ~/.bashrc
source ~/.bashrc
3. 验证安装
flutter doctor
三、各平台开发环境配置
1. Android开发环境
- 下载Android Studio内部安装包
- 配置Android SDK内部镜像
- 设置ANDROID_HOME环境变量
# 示例环境变量配置
export ANDROID_HOME=$HOME/Android/Sdk
export PATH=$PATH:$ANDROID_HOME/tools
export PATH=$PATH:$ANDROID_HOME/platform-tools
2. iOS开发环境(仅macOS)
- 安装Xcode(通过内部App Store或安装包分发)
- 配置Xcode命令行工具
sudo xcode-select --switch /Applications/Xcode.app/Contents/Developer
sudo xcodebuild -runFirstLaunch
3. Web开发环境
flutter config --enable-web
4. Windows/Linux桌面环境
flutter config --enable-windows-desktop
flutter config --enable-linux-desktop
flutter config --enable-macos-desktop
四、内部依赖管理
1. Pub私有仓库配置
在~/.pub-cache/config.json
中添加:
{
"pub_hosted_url": "https://your-internal-pub-server",
"disable_analytics": true
}
2. 私有插件管理
- 在
pubspec.yaml
中引用内部插件:
dependencies:
your_private_package:
git:
url: git@your-internal-git:team/your_private_package.git
ref: main
五、构建环境配置
1. 构建机器配置
- 配置Jenkins/GitLab CI等持续集成服务
- 设置构建缓存目录
- 配置构建代理(如需访问外部资源)
2. 构建脚本示例
#!/bin/bash
# 设置环境变量
export FLUTTER_HOME=/opt/flutter
export PATH=$PATH:$FLUTTER_HOME/bin
# 构建Android
flutter build apk --release
# 构建iOS
flutter build ios --release --no-codesign
# 构建Web
flutter build web --release
六、常见问题解决
1. 网络连接问题
- 配置代理:
export http_proxy=http://your-proxy:port
export https_proxy=http://your-proxy:port
2. 证书问题
- 将内部CA证书添加到系统信任链
- 配置Flutter信任证书:
flutter config --android-http-proxy=http://your-proxy:port
3. 资源下载问题
- 搭建内部镜像服务器
- 预下载所有依赖并放入内部仓库
七、安全配置
- 禁用不必要的外部访问
- 配置防火墙规则
- 定期更新SDK和依赖
- 使用内部代码签名证书
八、维护与更新
- 定期同步官方Flutter版本到内部镜像
- 维护内部插件和依赖的更新
- 文档化环境配置流程
- 建立开发者onboarding流程
通过以上步骤,可以在企业内部局域网中搭建完整的全平台Flutter开发环境,支持Android、iOS、Web和桌面应用的开发与构建。