部署
- 作者仓库星标 0
- 作者仓库 skills-registry
- 领域
- 运维部署
- 作者声明的智能体
- 未找到明确声明;不据此推断已兼容或已测试
- 静态检查
- 88 / 100 · 启发式扫描,不代表运行安全
- 运行环境证据
- 未执行;当前没有隔离运行测试证据
- 作者 / 版本 / 许可证
- @tomevault-io · 未声明许可证
- 上下文用量评级
- 低消耗
- 接入复杂程度
- 需简单配置
- 是否需要外部接口密钥
- 不需要
- 兼容的系统
- macOS
- 运行环境要求
- 未检出明确要求
- 检测到的文件与系统行为
-
- 只读
- 命令执行
- 网络行为
- 仅限本地
- 安装命令数
- 无(仅作为资料)
需要注意: 未声明工具权限范围;实际权限由运行环境决定。
# Flutter 中国环境部署加速
## 快速开始
当用户需要部署 Flutter 项目时,按以下步骤执行:
### 1. 设置环境变量镜像
在终端执行或写入 `~/.zshrc`:
```bash
export PUB_HOSTED_URL=https://pub.flutter-io.cn
export FLUTTER_STORAGE_BASE_URL=https://storage.flutter-io.cn
```
### 2. 项目初始化 (FVM 版)
```bash
fvm install stable
fvm use stable --force
fvm flutter pub get
```
## Gradle 配置优化
### gradle-wrapper.properties
修改 `android/gradle/wrapper/gradle-wrapper.properties`:
```properties
distributionUrl=https\://mirrors.cloud.tencent.com/gradle/gradle-8.10.2-all.zip
```
### settings.gradle.kts
在 `android/settings.gradle.kts` 的 `repositories` 块添加:
```kotlin
repositories {
maven { url = uri("https://storage.flutter-io.cn/download.flutter.io") }
maven { url = uri("https://maven.aliyun.com/repository/google") }
maven { url = uri("https://maven.aliyun.com/repository/public") }
maven { url = uri("https://maven.aliyun.com/repository/gradle-plugin") }
google()
mavenCentral()
}
```
### build.gradle.kts
在 `android/build.gradle.kts` 同样配置 Maven 镜像。
### gradle.properties
在 `android/gradle.properties` 添加优化配置:
```properties
kotlin.compiler.execution.strategy=in-process
org.gradle.daemon=false
android.useAndroidX=true
android.enableJetifier=true
```
## Android SDK 配置
### local.properties
创建或修改 `android/local.properties`:
```properties
sdk.dir=/Volumes/MacOS/Android/sdk
```
### 环境变量
在 `~/.zshrc` 添加:
```bash
export ANDROID_HOME=/Volumes/MacOS/Android/sdk
export PATH=$PATH:$ANDROID_HOME/tools:$ANDROID_HOME/platform-tools
```
## 运行项目
```bash
export FLUTTER_STORAGE_BASE_URL=https://storage.flutter-io.cn && \
export PUB_HOSTED_URL=https://pub.flutter-io.cn && \
fvm flutter run -d <设备ID>
```
## 常见问题排查
| 错误信息 | 解决方案 |
|---------|---------|
| Timeout waiting to lock build logic queue | `pkill -f gradle` 并删除 `android/.gradle` |
| Could not find io.flutter:... | 检查 `settings.gradle.kts` 是否包含 `download.flutter.io` 镜像 |
| Operation not permitted | 检查 `GRADLE_USER_HOME` 路径权限 |
## 配置脚本
使用 `scripts/configure_mirrors.py` 自动配置:
```bash
# 检查当前配置状态
python3 scripts/configure_mirrors.py --check
# 配置 Shell 环境变量
python3 scripts/configure_mirrors.py --shell
# 配置 Gradle 镜像 (指定项目路径)
python3 scripts/configure_mirrors.py --project /path/to/flutter/project --gradle
# 执行所有配置
python3 scripts/configure_mirrors.py --project /path/to/flutter/project --all
```
---
> Source: [boshi-xixixi/TraeSkill](https://github.com/boshi-xixixi/TraeSkill) — distributed by [TomeVault](https://tomevault.io).
<!-- tomevault:4.0:skill_md:2026-05-22 -->
章节与文件索引
按说明文件中的顺序排列。
1. 设置环境变量镜像
gradle-wrapper.properties
settings.gradle.kts
build.gradle.kts
gradle.properties
文件/命令 -> ~/.zshrc · android/gradle/wrapper/gradle-wrapper.properties · android/settings.gradle.kts · repositories · android/build.gradle.kts · android/gradle.properties · android/local.properties · pkill -f gradle
内容校验值 -> 546528c9e5b3
当前原文的自动摘译,尚未人工审校。
1. 设置环境变量镜像
在终端执行或写入
~/.zshrc:gradle-wrapper.properties
修改
android/gradle/wrapper/gradle-wrapper.properties:settings.gradle.kts
在
android/settings.gradle.kts的repositories块添加:build.gradle.kts
在
android/build.gradle.kts同样配置 Maven 镜像。gradle.properties
在
android/gradle.properties添加优化配置: