Saltar al contenido principal

Usar Flutter en China

Cómo usar, acceder y aprender sobre Flutter en China.

Para acelerar la descarga e instalación de Flutter en China, considera usar un sitio espejo o espejo.

Usar un sitio espejo de Flutter

#

El Grupo de Usuarios de Flutter en China (CFUG) mantiene un sitio web de Flutter en chino simplificado https://flutter.cn y un espejo. Se pueden encontrar otros espejos al final de esta guía.

Configurar tu máquina para usar un sitio espejo

#

Para instalar o usar Flutter en China, usa un espejo de Flutter de confianza. Esto requiere configurar dos variables de entorno en tu máquina.

Todos los ejemplos a continuación suponen que estás utilizando el espejo de CFUG.

Para configurar tu máquina para usar un sitio espejo:

Estos pasos requieren el uso de PowerShell.

  1. Abre una nueva ventana en PowerShell para prepararte a ejecutar comandos de shell.

  2. Configura PUB_HOSTED_URL con tu sitio espejo.

    $ $env:PUB_HOSTED_URL="https://pub.flutter-io.cn"

  3. Configura FLUTTER_STORAGE_BASE_URL con tu sitio espejo.

    $ $env:FLUTTER_STORAGE_BASE_URL="https://storage.flutter-io.cn"

  4. Descarga el archivo de Flutter desde tu sitio espejo preferido.

    Para CFUG, visita su archivo del SDK de Flutter, y descarga el SDK para tu plataforma y arquitectura.

  5. Crea una carpeta donde puedas instalar Flutter. Luego entra en ella. Considera una ruta como $env:USERPROFILE\dev.

    $ New-Item -Path "$env:USERPROFILE\dev" -ItemType Directory; cd "$env:USERPROFILE\dev"

  6. Extrae el SDK del archivo zip.

    Este ejemplo supone que descargaste la versión para Windows del SDK de Flutter. Deberás reemplazar la ruta del archivo con la ruta del archivo y la versión que descargaste.

    $ Expand-Archive .\flutter_windows_3.35.5-stable.zip

  7. Añade Flutter a tu variable de entorno PATH.

    $ $env:PATH = $pwd.PATH + "\flutter\bin",$env:PATH -join ";"

  8. Comienza a desarrollar con Flutter.

    Después de seguir estos pasos, Flutter obtendrá los paquetes y artefactos desde flutter-io.cn en la ventana de terminal actual.

    Para establecer estos valores de forma permanente en todas las terminales, sigue las instrucciones para añadir Flutter a tu PATH, añadiendo también las variables PUB_HOSTED_URL y FLUTTER_STORAGE_BASE_URL.

  1. Abre una nueva ventana en tu terminal para prepararte a ejecutar comandos de shell.

  2. Configura PUB_HOSTED_URL con tu sitio espejo.

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

  3. Configura FLUTTER_STORAGE_BASE_URL con tu sitio espejo.

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

  4. Descarga el archivo de Flutter desde tu sitio espejo preferido.

    Para CFUG, visita su archivo del SDK de Flutter, y descarga el SDK para tu plataforma y arquitectura.

  5. Crea una carpeta donde puedas instalar Flutter. Luego entra en ella. Considera una ruta como ~/dev.

    mkdir ~/dev; cd ~/dev

  6. Extrae el SDK del archivo zip.

    Este ejemplo supone que descargaste la versión para macOS del SDK de Flutter. Deberás reemplazar la ruta del archivo con la ruta del archivo y la versión que descargaste.

    unzip flutter_macos_3.35.5-stable.zip

  7. Añade Flutter a tu variable de entorno PATH.

    export PATH="$PWD/flutter/bin:$PATH"

  8. Comienza a desarrollar con Flutter.

    Después de seguir estos pasos, Flutter obtendrá los paquetes y artefactos desde flutter-io.cn en la ventana de terminal actual.

    Para establecer estos valores de forma permanente en todas las terminales, sigue las instrucciones para añadir Flutter a tu PATH, añadiendo también las variables PUB_HOSTED_URL y FLUTTER_STORAGE_BASE_URL.

  1. Abre una nueva ventana en tu terminal para prepararte a ejecutar comandos de shell.

  2. Configura PUB_HOSTED_URL con tu sitio espejo.

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

  3. Configura FLUTTER_STORAGE_BASE_URL con tu sitio espejo.

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

  4. Descarga el archivo de Flutter desde tu sitio espejo preferido.

    Para CFUG, visita su archivo del SDK de Flutter, y descarga el SDK para tu plataforma y arquitectura.

  5. Crea una carpeta donde puedas instalar Flutter. Luego entra en ella. Considera una ruta como ~/dev.

    mkdir ~/dev; cd ~/dev

  6. Extrae el SDK del archivo tar.

    Este ejemplo supone que descargaste la versión para Linux del SDK de Flutter. Deberás reemplazar la ruta del archivo con la ruta del archivo y la versión que descargaste.

    tar -xf flutter_linux_3.35.5-stable.tar.xz

  7. Añade Flutter a tu variable de entorno PATH.

    export PATH="$PWD/flutter/bin:$PATH"

  8. Comienza a desarrollar con Flutter.

    Después de seguir estos pasos, Flutter obtendrá los paquetes y artefactos desde flutter-io.cn en la ventana de terminal actual.

    Para establecer estos valores de forma permanente en todas las terminales, sigue las instrucciones para añadir Flutter a tu PATH, añadiendo también las variables PUB_HOSTED_URL y FLUTTER_STORAGE_BASE_URL.

Descargar archivos de Flutter basados en un sitio espejo

#

Para descargar Flutter desde el archivo del SDK desde un espejo, reemplaza storage.googleapis.com con la URL de tu espejo de confianza. Usa tu sitio espejo en el navegador o en otras aplicaciones como IDM o Thunder. Esto debería mejorar la velocidad de descarga.

El siguiente ejemplo muestra cómo cambiar la URL del sitio de descarga de Flutter del archivo de Google al espejo de CFUG.

Para descargar la versión x64 de Windows del SDK de Flutter, cambiarías la URL original de:

https://storage.googleapis.com/flutter_infra_release/releases/stable/windows/flutter_windows_3.35.5-stable.zip

a la URL del espejo:

https://storage.flutter-io.cn/flutter_infra_release/releases/stable/windows/flutter_windows_3.35.5-stable.zip

Para descargar la versión arm64 de macOS del SDK de Flutter, cambiarías la URL original de:

https://storage.googleapis.com/flutter_infra_release/releases/stable/macos/flutter_macos_arm64_3.35.5-stable.zip

a la URL del espejo:

https://storage.flutter-io.cn/flutter_infra_release/releases/stable/macos/flutter_macos_arm64_3.35.5-stable.zip

Para descargar la versión de Linux del SDK de Flutter, cambiarías la URL original de:

https://storage.googleapis.com/flutter_infra_release/releases/stable/linux/flutter_linux_3.35.5-stable.tar.xz

a la URL del espejo:

https://storage.flutter-io.cn/flutter_infra_release/releases/stable/linux/flutter_linux_3.35.5-stable.tar.xz

Configurar tu máquina para publicar tu paquete

#

Para publicar tus paquetes en pub.dev, necesitas poder acceder tanto a Google Auth como al sitio pub.dev.

Para habilitar el acceso a pub.dev:

  1. Configura un proxy. Para configurar un proxy, consulta la documentación de Dart sobre proxies.

  2. Verifica que tu variable de entorno PUB_HOSTED_URL no esté establecida o esté vacía.

    $ echo $env:PUB_HOSTED_URL

    Si este comando devuelve algún valor, elimínalo (unset).

    $ Remove-Item $env:PUB_HOSTED_URL

  1. Configura un proxy. Para configurar un proxy, consulta la documentación de Dart sobre proxies.

  2. Verifica que tu variable de entorno PUB_HOSTED_URL no esté establecida o esté vacía.

    echo $PUB_HOSTED_URL

    Si este comando devuelve algún valor, elimínalo (unset).

    unset $PUB_HOSTED_URL

  1. Configura un proxy. Para configurar un proxy, consulta la documentación de Dart sobre proxies.

  2. Verifica que tu variable de entorno PUB_HOSTED_URL no esté establecida o esté vacía.

    echo $PUB_HOSTED_URL

    Si este comando devuelve algún valor, elimínalo (unset).

    unset $PUB_HOSTED_URL

Para obtener más información sobre cómo publicar paquetes, consulta la documentación de Dart sobre la publicación de paquetes.

Sitios espejo conocidos y de confianza gestionados por la comunidad

#

El equipo de Flutter no puede garantizar la disponibilidad a largo plazo de ningún espejo. Puedes usar otros espejos si llegan a estar disponibles.

Grupo de Usuarios de Flutter en China

#

El Grupo de Usuarios de Flutter en China mantiene el espejo flutter-io.cn. Incluye el SDK de Flutter y paquetes de pub.

Configurar tu máquina para usar este espejo

#

Para configurar tu máquina para usar este espejo, usa estos comandos.

En macOS, Linux o ChromeOS:

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

En Windows:

$env:PUB_HOSTED_URL="https://pub.flutter-io.cn"
$env:FLUTTER_STORAGE_BASE_URL="https://storage.flutter-io.cn"

Obtener soporte para este espejo

#

Si tienes problemas que solo ocurren al usar el espejo flutter-io.cn, reporta el problema en su rastreador de problemas.

Grupo de Usuarios *nix de la Universidad Jiao Tong de Shanghái

#

El Grupo de Usuarios *nix de la Universidad Jiao Tong de Shanghái mantiene el espejo mirror.sjtu.edu.cn. Incluye el SDK de Flutter y paquetes de pub.

Configurar tu máquina para usar este espejo

#

Para configurar tu máquina para usar este espejo, usa estos comandos.

En macOS, Linux o ChromeOS:

export PUB_HOSTED_URL=https://mirror.sjtu.edu.cn/dart-pub
export FLUTTER_STORAGE_BASE_URL=https://mirror.sjtu.edu.cn

En Windows:

$env:PUB_HOSTED_URL="https://mirror.sjtu.edu.cn/dart-pub"
$env:FLUTTER_STORAGE_BASE_URL="https://mirror.sjtu.edu.cn"

Obtener soporte para este espejo

#

Si tienes problemas que solo ocurren al usar el espejo mirror.sjtu.edu.cn, reporta el problema en su rastreador de problemas.

Asociación TUNA de la Universidad de Tsinghua

#

La Asociación TUNA de la Universidad de Tsinghua mantiene el espejo mirrors.tuna.tsinghua.edu.cn. Incluye el SDK de Flutter y paquetes de pub.

Configurar tu máquina para usar este espejo

#

Para configurar tu máquina para usar este espejo, usa estos comandos.

En macOS, Linux o ChromeOS:

export PUB_HOSTED_URL=https://mirrors.tuna.tsinghua.edu.cn/dart-pub
export FLUTTER_STORAGE_BASE_URL=https://mirrors.tuna.tsinghua.edu.cn/flutter

En Windows:

$env:PUB_HOSTED_URL="https://mirrors.tuna.tsinghua.edu.cn/dart-pub"
$env:FLUTTER_STORAGE_BASE_URL="https://mirrors.tuna.tsinghua.edu.cn/flutter"

Obtener soporte para este espejo

#

Si tienes problemas que solo ocurren al usar el espejo mirrors.tuna.tsinghua.edu.cn, reporta el problema en su rastreador de problemas.

Ofrecerse a alojar un nuevo sitio espejo

#

Si estás interesado en configurar tu propio espejo, ponte en contacto con flutter-dev@googlegroups.com para obtener ayuda.

A menos que se indique lo contrario, la documentación de este sitio refleja Flutter 3.44.0. Página actualizada por última vez el 2026-05-05. Ver código fuente oreportar un problema.