flutter-china-deploy

Flutter Chinese Environment Deployment Acceleration

Quick Start

When users need to deploy a Flutter project, perform the following steps:

1. Set Environment Variable Mirrors

Execute in the terminal or write to ~/.zshrc：

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

2. Project Initialization (FVM Version)

fvm install stable
fvm use stable --force
fvm flutter pub get

Gradle Configuration Optimization

gradle-wrapper.properties

Modify android/gradle/wrapper/gradle-wrapper.properties：

distributionUrl=https\://mirrors.cloud.tencent.com/gradle/gradle-8.10.2-all.zip

settings.gradle.kts

In android/settings.gradle.kts in the repositories block add:

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

In android/build.gradle.kts configure the Maven mirror in the same way.

gradle.properties

In android/gradle.properties add optimization configuration:

kotlin.compiler.execution.strategy=in-process
org.gradle.daemon=false
android.useAndroidX=true
android.enableJetifier=true

Android SDK Configuration

local.properties

Create or modify android/local.properties：

sdk.dir=/Volumes/MacOS/Android/sdk

Environment Variable

In ~/.zshrc add:

export ANDROID_HOME=/Volumes/MacOS/Android/sdk
export PATH=$PATH:$ANDROID_HOME/tools:$ANDROID_HOME/platform-tools

Run Project

export FLUTTER_STORAGE_BASE_URL=https://storage.flutter-io.cn && \
export PUB_HOSTED_URL=https://pub.flutter-io.cn && \
fvm flutter run -d <设备ID>

Troubleshooting Common Issues

Error Message	Solution
Timeout waiting to lock build logic queue	pkill -f gradle and delete android/.gradle
Could not find io.flutter:...	Check whether settings.gradle.kts contains the download.flutter.io mirror
Operation not permitted	Check the GRADLE_USER_HOME path permissions

Configuration Script

Use scripts/configure_mirrors.py for automatic configuration:

# 检查当前配置状态
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