Docker flutter鏡像自動部署實踐，踩坑記錄

前言

本項目主要參考cirruslabs的兩個Docker腳本

• docker-images-flutter

• docker-images-android

本筆記主要是簡化和增加一些實際過程中一些經驗總結

最簡單實踐案例

指定SDK版本

Dockerfile

FROM cirrusci/android-sdk:tools

ENV ANDROID_PLATFORM_VERSION 29
ENV ANDROID_BUILD_TOOLS_VERSION 29.0.2

RUN yes | sdkmanager \
    "platforms;android-$ANDROID_PLATFORM_VERSION" \
    "build-tools;$ANDROID_BUILD_TOOLS_VERSION"

編譯鏡像，和上面Dockerfile同級目錄執行

docker build -t "image_name" . 

• -t 指定鏡像名稱；
• . 當前目錄找Dockerfile 編譯文件

如果需要多個SDK的話，可以在上次編譯鏡像的基礎上疊一層，修改Dockfile

建議不要疊太多SDK，否則最終的鏡像會很大，而且正式環境是不需要多個SDK的

Dockerfile

FROM <上次編譯的鏡像名稱或者ID>

ENV ANDROID_PLATFORM_VERSION 29
ENV ANDROID_BUILD_TOOLS_VERSION 29.0.2

RUN yes | sdkmanager \
    "platforms;android-$ANDROID_PLATFORM_VERSION" \
    "build-tools;$ANDROID_BUILD_TOOLS_VERSION"

備註： 這裏提供自己編譯好的SDK版本，本人比較懶提供常用編譯好的SDK

dockerlinz/android-sdk:29

dockerlinz/android-sdk:28

dockerlinz/android-sdk:27

指定flutter版本

Dockerfile

FROM dockerlinz/android-sdk:27

ARG flutter_version

ENV FLUTTER_HOME=${HOME}/sdks/flutter \
    FLUTTER_ROOT=$FLUTTER_HOME \
    FLUTTER_VERSION=$flutter_version \
    PUB_HOSTED_URL=https://pub.flutter-io.cn \
    FLUTTER_STORAGE_BASE_URL=https://storage.flutter-io.cn
	
RUN mkdir -p ${FLUTTER_HOME}

ENV PATH ${PATH}:${FLUTTER_HOME}/bin:${FLUTTER_HOME}/bin/cache/dart-sdk/bin

RUN git clone --branch ${FLUTTER_VERSION} https://github.com/flutter/flutter.git ${FLUTTER_HOME} && \
    flutter doctor

這裏我們使用v1.9.1-hotfixes分支

docker build --tag --build-arg flutter_version=v1.9.1-hotfixes

測試

進入flutter工程所在目錄

docker run --rm -it -v ${PWD}:/build --workdir /build dockerlinz/flutter:stable flutter build apk 

可以加入 -v ~/.gradle:/home/cirrus/.gradle --env GRADLE_USER_HOME=/home/cirrus/.gradle，掛在本地緩存到鏡像中

注意：過來人經驗，此處沒有把握的話還是進入容器裏面測試會更省事

docker run --rm -it -v ${PWD}:/build --workdir /build dockerlinz/flutter:stable

進入後需要重新生成.packages

fluter clean 
flutter packages get 

最好進入android或mac目錄執行以下原生編譯腳本，查看編譯環境

./gradlew build -d 

最後纔是flutter編譯

flutter build apk 

出現的問題

問題一：本地正常跑，但是鏡像中很多依賴下載不下來

• android studio Could not download guava.jar
• Could not download kotlin-gradle-plugin.jar
• flutter Build file ‘/build/android/app/build.gradle’ line: 25
• Could not download kotlin-reflect.jar org.jetbrains.kotlin:kotlin-reflect:1.2.0

解決：方案

1. 在gradle中增加阿里雲國內鏡像

   buildscript {
       repositories {
           maven { url 'http://maven.aliyun.com/nexus/content/groups/public/' }
           google()
           jcenter()
       }
   
       dependencies {
           classpath 'com.android.tools.build:gradle:3.3.1'
       }
   }
   
   allprojects {
       repositories {
           maven { url 'http://maven.aliyun.com/nexus/content/groups/public/' }
           google()
           jcenter()
       }
   }
   

2. 掛載本地gradle 緩存到鏡像中

   docker run --rm -it -v ${PWD}:/build --workdir /build  -v ~/.gradle:/home/cirrus/.gradle --env GRADLE_USER_HOME=/home/cirrus/.gradle  dockerlinz/flutter:stable
   

問題二： flutter build apk 緩慢

每次都下載gradle版本，導致每次重新下載gradle版本

解決方案一

掛在本地緩存到鏡像中

 -v ~/.gradle:/home/cirrus/.gradle --env GRADLE_USER_HOME=/home/cirrus/.gradle

解決方案二

1. 掛在.gradle 緩存目錄，不用每次編譯的時候重新下載依賴

   -v ~/.gradle2:/home/cirrus/.gradle
   

2. 在疊一層gradle環境

   #https://github.com/frekele/docker-gradle/blob/master/Dockerfile
   FROM dockerlinz/flutter:1.9.1-hotfixes
   
   # Change to tmp folder
   ENV GRADLE_VERSION=4.10.2
   ENV GRADLE_HOME=/opt/gradle
   ENV GRADLE_FOLDER=/root/.gradle
   
   # Change to tmp folder
   WORKDIR /tmp
   
   # Download and extract gradle to opt folder
   RUN wget --no-check-certificate --no-cookies https://downloads.gradle.org/distributions/gradle-${GRADLE_VERSION}-bin.zip \
       && sudo unzip gradle-${GRADLE_VERSION}-bin.zip -d /opt \
       && sudo ln -s /opt/gradle-${GRADLE_VERSION} /opt/gradle \
       && sudo rm -f gradle-${GRADLE_VERSION}-bin.zip
   
   # Add executables to path
   RUN sudo update-alternatives --install "/usr/bin/gradle" "gradle" "/opt/gradle/bin/gradle" 1 && \
       sudo update-alternatives --set "gradle" "/opt/gradle/bin/gradle"
   
   # Create .gradle folder
   RUN sudo mkdir -p $GRADLE_FOLDER
   
   # Mark as volume
   VOLUME  $GRADLE_FOLDER
   
   # Add the files
   #ADD rootfs /
   
   # Change to root folder
   WORKDIR /home/cirrus/
   

3. Flutter 中Android工程指定本地gradle編譯，不是取下載，文件目錄<android_project>/.idea/gradle.xml

   <?xml version="1.0" encoding="UTF-8"?>
   <project version="4">
     <component name="GradleSettings">
       <option name="linkedExternalProjectsSettings">
         <GradleProjectSettings>
           <compositeConfiguration>
             <compositeBuild compositeDefinitionSource="SCRIPT" />
           </compositeConfiguration>
           <option name="distributionType" value="LOCAL" />
           <option name="externalProjectPath" value="$PROJECT_DIR$" />
           <option name="gradleHome" value="$USER_HOME$/.gradle/wrapper/dists/gradle-4.4-all/9br9xq1tocpiv8o6njlyu5op1/gradle-4.4/bin" />
           <option name="resolveModulePerSourceSet" value="false" />
           <option name="testRunner" value="PLATFORM" />
         </GradleProjectSettings>
       </option>
     </component>
   </project>
   

   • distributionType 改爲LOCAL
   • gradleHome 指向gradle_home/bin