meezi/mobile/meezi_app/BUILD_IRAN.md

Building meezi_app from Iran (sanctions mirrors)

pub.dev, Google's package storage, and Google's Android maven2 artifacts are sanctions-filtered from Iranian IPs (403 / 404). Use the reachable mirrors below.

1. Environment (set once, persistently)

setx PUB_HOSTED_URL          "https://pub.flutter-io.cn"
setx FLUTTER_STORAGE_BASE_URL "https://storage.flutter-io.cn"

These make flutter pub get, flutter create, and engine/artifact downloads work. Web already builds with just these (flutter build web).

2. Android — Maven/Gradle mirror

Google's Android maven2 (AGP, androidx, etc.) 404s here, so:

• android/settings.gradle.kts and android/build.gradle.kts already point their repositories at the Aliyun mirrors (committed).
• Flutter's included flutter_tools/gradle build has its own repositories, so add a global Gradle init script. Put this at %GRADLE_USER_HOME%/init.gradle (e.g. C:\gradlecache\init.gradle, then build with GRADLE_USER_HOME=C:\gradlecache):

def aliyun = [
    'https://maven.aliyun.com/repository/gradle-plugin',
    'https://maven.aliyun.com/repository/google',
    'https://maven.aliyun.com/repository/central',
]
beforeSettings { settings ->
    settings.pluginManagement { repositories { aliyun.each { u -> maven { url u } } } }
    if (settings.rootDir.path.replace('\\', '/').contains('flutter_tools')) {
        settings.dependencyResolutionManagement { repositories { aliyun.each { u -> maven { url u } } } }
    }
}

3. Build

$env:GRADLE_USER_HOME = "C:\gradlecache"   # keep the cache on a drive with space
cd mobile/meezi_app
flutter build apk --debug

Status

• ✅ flutter build web — works.
• ✅ Android dependency resolution — works via the Aliyun mirrors (verified).
• ⛔ APK build currently blocked only by disk space (needs a few GB free for the Gradle cache + build output). Free space (the large Docker WSL vhdx on C: is the obvious reclaim), then flutter build apk completes.