Better MAUI Windows Docker Image #22230

asi-evin · 2024-05-06T14:41:57Z

asi-evin
May 6, 2024

I'm trying to create a slimmer docker image on windows. I would prefer windows as I can build for android, iOS, windows, macos (not maui I know), and maccatalyst. The problem is the only success I have had is to download the Visual Studio Build Tools and install all the necessary packages. Docker file looks like this:

# escape=`
# Copyright (c) Microsoft Corporation.
# Licensed under the MIT License.

ARG dockerHost=mcr.microsoft.com
ARG WindowsServerCoreRepo=windows/servercore
ARG tag=ltsc2022

# Use server core as an installer container to extract PowerShell,
# As this is a multi-stage build, this stage will eventually be thrown away
FROM mcr.microsoft.com/${WindowsServerCoreRepo}:${tag} AS installer-env

ARG PS_VERSION=6.2.0
ARG PS_PACKAGE_URL=https://github.com/PowerShell/PowerShell/releases/download/v${PS_VERSION}/PowerShell-${PS_VERSION}-win-x64.zip

SHELL ["C:\\Windows\\System32\\WindowsPowerShell\\v1.0\\powershell.exe", "-command"]

ARG PS_PACKAGE_URL_BASE64

RUN Write-host "Verifying valid Version..."; `
    if (!($env:PS_VERSION -match '^\d+\.\d+\.\d+(-\w+(\.\d+)?)?$' )) { `
        throw ('PS_Version ({0}) must match the regex "^\d+\.\d+\.\d+(-\w+(\.\d+)?)?$"' -f $env:PS_VERSION) `
    } `
    $ProgressPreference = 'SilentlyContinue'; `
    if($env:PS_PACKAGE_URL_BASE64){ `
        Write-host "decoding: $env:PS_PACKAGE_URL_BASE64" ;`
        $url = [System.Text.Encoding]::Unicode.GetString([System.Convert]::FromBase64String($env:PS_PACKAGE_URL_BASE64)) `
    } else { `
        Write-host "using url: $env:PS_PACKAGE_URL" ;`
        $url = $env:PS_PACKAGE_URL `
    } `
    Write-host "downloading: $url"; `
    [Net.ServicePointManager]::SecurityProtocol = [Net.ServicePointManager]::SecurityProtocol -bor [Net.SecurityProtocolType]::Tls12; `
    Invoke-WebRequest -Uri $url -outfile /powershell.zip -verbose; `
    Expand-Archive powershell.zip -DestinationPath  \PowerShell

# Install PowerShell into WindowsServerCore
FROM mcr.microsoft.com/${WindowsServerCoreRepo}:${tag}

# Copy PowerShell Core from the installer container
ENV ProgramFiles="C:\Program Files" `
    # set a fixed location for the Module analysis cache
    PSModuleAnalysisCachePath="C:\Users\Public\AppData\Local\Microsoft\Windows\PowerShell\docker\ModuleAnalysisCache" `
    # Persist %PSCORE% ENV variable for user convenience
    PSCORE="$ProgramFiles\PowerShell\pwsh.exe" `
    POWERSHELL_DISTRIBUTION_CHANNEL="PSDocker-WindowsServerCore-ltsc2022" `
    POWERSHELL_TELEMETRY_OPTOUT="1"

# Copy PowerShell Core from the installer container
COPY --from=installer-env ["\\PowerShell\\", "$ProgramFiles\\PowerShell\\latest"]

# Set the path
RUN setx /M PATH "%ProgramFiles%\PowerShell\latest;%PATH%;"

# intialize powershell module cache
RUN pwsh `
        -NoLogo `
        -NoProfile `
        -Command " `
          $stopTime = (get-date).AddMinutes(15); `
          $ErrorActionPreference = 'Stop' ; `
          $ProgressPreference = 'SilentlyContinue' ; `
          while(!(Test-Path -Path $env:PSModuleAnalysisCachePath)) {  `
            Write-Host "'Waiting for $env:PSModuleAnalysisCachePath'" ; `
            if((get-date) -gt $stopTime) { throw 'timout expired'} `
            Start-Sleep -Seconds 6 ; `
          }"

# re-enable telemetry
ENV POWERSHELL_TELEMETRY_OPTOUT="0"

CMD ["pwsh.exe"]

# Use the latest Windows Server Core 2022 image.
# FROM mcr.microsoft.com/windows/servercore:ltsc2022

# Restore the default Windows shell for correct batch processing.
SHELL ["cmd", "/S", "/C"]

# Download the Build Tools bootstrapper. 
RUN curl -SL --output vs_buildtools.exe https://aka.ms/vs/17/release/vs_buildtools.exe && `

# Install Build Tools
	(start /w vs_buildtools.exe --quiet --wait --norestart --nocache `
		--add Microsoft.VisualStudio.Workload.ManagedDesktopBuildTools `
		--add Microsoft.VisualStudio.Workload.MSBuildTools `
		--add Microsoft.VisualStudio.Workload.XamarinBuildTools `
		--add Component.Android.SDK.MAUI `
		--add macos `
		--add Microsoft.VisualStudio.Component.Windows10SDK.18362 `
		--remove Microsoft.VisualStudio.Component.Windows10SDK.10240 `
		--remove Microsoft.VisualStudio.Component.Windows10SDK.10586 `
		--remove Microsoft.VisualStudio.Component.Windows10SDK.14393 `
		--remove Microsoft.VisualStudio.Component.Windows81SDK `
		|| IF "%ERRORLEVEL%"=="3010" EXIT 0) && `
`
# Cleanup 
	del /q vs_buildtools.exe


# Install Workloads
# RUN dotnet workload install maui android ios macos maccatalyst # (oops, on my last build I forgot to uncomment this... Oh well, it still worked...)

And this TECHNICALLY works, but the problem is it comes in at 27GB, and anytime I want to update, it takes hours. I have attempted a slimmer version, by using the official dotnet images, but I can't figure out a way to install the android sdk in a way dotnet will find it; I keep getting "Android SDK not found" errors no matter where I put it.

I have seen successful Linux docker images for Android, but I wish to stick with windows so that can compile my nuget project with just the "dotnet pack" command; as far as I can tell, windows is the only platform this will work on.

And I can't use Github actions as I'm using a local Gitlab server.

Most annoyingly, I can't just run this directly on the build machine because the path length becomes too long for android >:(.

Any plan for an official MAUI docker image? and if not, has anybody successfully made a slightly slimmer docker image for MAUI on windows that can compile android?

Answered by Steve0212a

Jul 2, 2024

This one comes in at 11.9 GB and works to build my .Net 8 Android Maui project.

FROM mcr.microsoft.com/dotnet/sdk:8.0-windowsservercore-ltsc2019

# $ProgressPreference: https://github.com/PowerShell/PowerShell/issues/2138#issuecomment-251261324
SHELL ["powershell", "-Command", "$ErrorActionPreference = 'Stop'; $ProgressPreference = 'SilentlyContinue';"]

# MAUI
RUN dotnet nuget locals all --clear; \
	dotnet workload install maui;

# JAVA
ENV JAVA_HOME C:\\openjdk-17
RUN $newPath = ('{0}\bin;{1}' -f $env:JAVA_HOME, $env:PATH); \
	Write-Host ('Updating PATH: {0}' -f $newPath); \
	setx /M PATH $newPath; \
	Write-Host 'Complete.'
ENV JAVA_URL=https://download.java.net/java/GA/jdk17.0.2/dfd4a8…

View full answer

Steve0212a · 2024-06-26T18:49:58Z

Steve0212a
Jun 26, 2024

I am looking for this as well. Have you made any progress on this?

1 reply

asi-evin Jun 26, 2024
Author

No progress as I've been on other projects, but I'll be diving into it in the next few months again.

Steve0212a · 2024-07-02T14:55:13Z

Steve0212a
Jul 2, 2024

This one comes in at 11.9 GB and works to build my .Net 8 Android Maui project.

FROM mcr.microsoft.com/dotnet/sdk:8.0-windowsservercore-ltsc2019

# $ProgressPreference: https://github.com/PowerShell/PowerShell/issues/2138#issuecomment-251261324
SHELL ["powershell", "-Command", "$ErrorActionPreference = 'Stop'; $ProgressPreference = 'SilentlyContinue';"]

# MAUI
RUN dotnet nuget locals all --clear; \
	dotnet workload install maui;

# JAVA
ENV JAVA_HOME C:\\openjdk-17
RUN $newPath = ('{0}\bin;{1}' -f $env:JAVA_HOME, $env:PATH); \
	Write-Host ('Updating PATH: {0}' -f $newPath); \
	setx /M PATH $newPath; \
	Write-Host 'Complete.'
ENV JAVA_URL=https://download.java.net/java/GA/jdk17.0.2/dfd4a8d0985749f896bed50d7138ee7f/8/GPL/openjdk-17.0.2_windows-x64_bin.zip
ENV JAVA_SHA256 b2208206bda47f2e0c971a39e057a5ec32c40b503d71e486790cb728d926b615
RUN Write-Host ('Downloading {0} ...' -f $env:JAVA_URL); \
	#[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12; \
	Invoke-WebRequest -Uri $env:JAVA_URL -OutFile 'openjdk.zip'; \
	Write-Host ('Verifying sha256 ({0}) ...' -f $env:JAVA_SHA256); \
	if ((Get-FileHash openjdk.zip -Algorithm sha256).Hash -ne $env:JAVA_SHA256) { \
		Write-Host 'FAILED!'; \
		exit 1; \
	}; \
	\
	Write-Host 'Expanding ...'; \
	New-Item -ItemType Directory -Path C:\temp | Out-Null; \
	Expand-Archive openjdk.zip -DestinationPath C:\temp; \
	Move-Item -Path C:\temp\* -Destination $env:JAVA_HOME; \
	Remove-Item C:\temp; \
	\
	Write-Host 'Removing ...'; \
	Remove-Item openjdk.zip -Force; \
	\
	Write-Host 'Verifying install ...'; \
	Write-Host '  javac --version'; javac --version; \
	Write-Host '  java --version'; java --version; \
	\
	Write-Host 'Complete.'

# ANDROID
ENV ANDROID_URL=https://dl.google.com/android/repository/commandlinetools-win-11076708_latest.zip
ENV ANDROID_SHA256 4d6931209eebb1bfb7c7e8b240a6a3cb3ab24479ea294f3539429574b1eec862
ENV ANDROID_SDK_TOOLS C:\\Program Files (x86)\\Android\\android-sdk
ENV ANDROID_LICENSE_FILE C:\\Program Files (x86)\\Android\\android-sdk\\licenses\\android-sdk-license

RUN Write-Host ('Downloading {0} ...' -f $env:ANDROID_URL); \
	#[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12; \
	Invoke-WebRequest -Uri $env:ANDROID_URL -OutFile 'commandlinetools.zip'; \
	Write-Host ('Verifying sha256 ({0}) ...' -f $env:ANDROID_SHA256); \
	if ((Get-FileHash commandlinetools.zip -Algorithm sha256).Hash -ne $env:ANDROID_SHA256) { \
		Write-Host 'FAILED!'; \
		exit 1; \
	}; \
	\
	Write-Host 'Expanding to $env:ANDROID_SDK_TOOLS...'; \
	New-Item -ItemType Directory -Path "$env:ANDROID_SDK_TOOLS" | Out-Null; \
	Expand-Archive commandlinetools.zip -DestinationPath "$env:ANDROID_SDK_TOOLS"; \
	\
	Write-Host 'Removing ...'; \
	Remove-Item commandlinetools.zip -Force; \
	\
	Write-Host 'Setting proper structure in latest folder...'; \
	New-Item -ItemType Directory -Path "$env:ANDROID_SDK_TOOLS\cmdline-tools\latest" | Out-Null; \
	move "$env:ANDROID_SDK_TOOLS\cmdline-tools\bin" "$env:ANDROID_SDK_TOOLS\cmdline-tools\latest"; \
	move "$env:ANDROID_SDK_TOOLS\cmdline-tools\lib" "$env:ANDROID_SDK_TOOLS\cmdline-tools\latest"; \
	move "$env:ANDROID_SDK_TOOLS\cmdline-tools\*.*" "$env:ANDROID_SDK_TOOLS\cmdline-tools\latest"; \
	\
	Write-Host 'Creating Android License File...'; \
	New-Item -ItemType Directory -Path "$env:ANDROID_SDK_TOOLS\licenses" | Out-Null; \
	$licenseArray=@('','24333f8a63b6825ea9c5514f83c2829b004d1fee'); \
	[IO.File]::WriteAllLines($env:ANDROID_LICENSE_FILE, $licenseArray, [Text.Encoding]::GetEncoding(1252)); \
	\
	Write-Host 'Installing Android Packages...'; \
	cd "$env:ANDROID_SDK_TOOLS\cmdline-tools\latest\bin"; \
	\
	./sdkmanager 'build-tools;34.0.0'; \
	./sdkmanager 'platform-tools'; \
	./sdkmanager 'platforms;android-34'; \
	\
	Write-Host 'Complete.'

1 reply

asi-evin Jul 8, 2024
Author

Just wanted to write that I got a chance to try it and it worked!!! Thank you, it's a large improvement on the size.

Redth · 2025-07-02T01:27:30Z

Redth
Jul 2, 2025
Maintainer

I also have a repo here: https://github.com/Redth/maui-docker which builds a couple docker images.

Test (this is android only, linux guest only, and runs the emulator, appium, etc.)
GitHub actions runner (this has windows and linux variants and runs a GitHub actions runner when it starts)

Going to be adding a basic CI/CD type image that has no GitHub actions runner but installs everything you need to build still.

0 replies

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

Better MAUI Windows Docker Image #22230

Uh oh!

{{title}}

Uh oh!

Replies: 3 comments 2 replies

Uh oh!

{{title}}

Uh oh!

Uh oh!

{{title}}

Uh oh!

Uh oh!

{{title}}

Uh oh!

Uh oh!

{{title}}

Uh oh!

Uh oh!

{{title}}

Uh oh!

Select a reply

Uh oh!

Better MAUI Windows Docker Image #22230

Uh oh!

asi-evin May 6, 2024

Replies: 3 comments · 2 replies

Uh oh!

Steve0212a Jun 26, 2024

Uh oh!

asi-evin Jun 26, 2024 Author

Uh oh!

Steve0212a Jul 2, 2024

Uh oh!

asi-evin Jul 8, 2024 Author

Uh oh!

Redth Jul 2, 2025 Maintainer

asi-evin
May 6, 2024

Replies: 3 comments 2 replies

Steve0212a
Jun 26, 2024

asi-evin Jun 26, 2024
Author

Steve0212a
Jul 2, 2024

asi-evin Jul 8, 2024
Author

Redth
Jul 2, 2025
Maintainer