Windows10主机Docker部署Flutter移动端至模拟器/真机问题求助

一、Emulator容器启动后立即退出（Pulseaudio相关错误） #

• 修复Pulseaudio总线连接问题
  1. 下载Windows版Pulseaudio并安装，启动后在设置里开启「允许网络访问」，关闭身份验证。
  2. 在WSL2的Ubuntu终端执行：

     export PULSE_SERVER=tcp:$(cat /etc/resolv.conf | grep nameserver | awk '{print $2}'):4713
     export PULSE_COOKIE=/tmp/pulse_cookie
     

  3. 在docker-compose.yml的emulator服务中添加环境变量：

     environment:
       - PULSE_SERVER=${PULSE_SERVER}
       - PULSE_COOKIE=${PULSE_COOKIE}
     

• 解决文件读取权限问题
  在docker-compose.yml的emulator服务中添加用户权限映射：

  user: "${UID}:${GID}"
  

  启动容器前先在WSL2终端执行：export UID=$(id -u) GID=$(id -g)
• 禁用KVM规避硬件加速问题
  Windows10下WSL2的KVM支持有限，在emulator启动命令中添加-no-kvm参数，避免崩溃。

二、Gradle压缩包解压失败 #

• 替换Gradle镜像源
  修改Flutter项目的android/build.gradle，替换为国内镜像：

  buildscript {
      repositories {
          maven { url 'https://maven.aliyun.com/repository/google' }
          maven { url 'https://maven.aliyun.com/repository/jcenter' }
          maven { url 'https://maven.aliyun.com/nexus/content/groups/public' }
      }
  }
  allprojects {
      repositories {
          maven { url 'https://maven.aliyun.com/repository/google' }
          maven { url 'https://maven.aliyun.com/repository/jcenter' }
          maven { url 'https://maven.aliyun.com/nexus/content/groups/public' }
      }
  }
  

• 提前下载Gradle到镜像
  修改Dockerfile，预先下载对应版本的Gradle，避免构建时网络问题：

  # 示例使用Gradle 7.4，根据项目实际版本调整
  RUN wget -O gradle-7.4-bin.zip https://services.gradle.org/distributions/gradle-7.4-bin.zip \
      && unzip gradle-7.4-bin.zip -d /opt \
      && rm gradle-7.4-bin.zip \
      && export PATH=/opt/gradle-7.4/bin:$PATH
  

• 优化Docker构建缓存
  将COPY android/build.gradle和COPY android/settings.gradle放在依赖安装步骤之前，利用缓存减少重复操作。

三、优先方案：Docker化Flutter部署至物理真机 #

• 打通WSL2与Windows的ADB连接
  1. 开启真机USB调试，连接Windows主机；
  2. 在WSL2终端执行adb kill-server，切换到Windows命令行执行adb start-server，再回到WSL2执行adb devices确认真机被识别。
• 配置容器ADB权限
  在docker-compose.yml的app服务中添加设备挂载和环境变量：

  devices:
    - /dev/bus/usb:/dev/bus/usb
  environment:
    - ADB_SERVER_SOCKET=tcp:host.docker.internal:5037
  

• 部署应用到真机
  修改run.sh脚本，直接执行flutter run -d <device-id>，其中<device-id>通过WSL2中adb devices命令获取。

内容的提问来源于stack exchange，提问作者Houssem