Linux/Docker 中使用 System.Drawing.Common 踩坑小計

前言

在項目遷移到 .net core 上面後,我們可以使用 System.Drawing.Common 組件來操作 Image,Bitmap 類型,實現生成驗證碼、二維碼,圖片操作等功能。System.Drawing.Common 組件它是依賴於 GDI+ 的,然後在 Linux 上並沒有 GDI+,面向Google編程之後發現,Mono 團隊使用 C語言 實現了GDI+ 介面,提供對非Windows系統的 GDI+ 介面訪問能力,這個應該就是libgdiplus。所以想讓程式碼在 linux 上穩定運行有關 System.Drawing.Common 的程式碼的時候,必須安裝組件libgdiplus。而現在大多是 docker 進行發布,如果快速簡單的安裝 libgdiplus

安裝 libgdiplus

方案一

基於微軟提供的 mcr.microsoft.com/dotnet/core/aspnet:3.1 重新構建一個帶libgdiplus 的鏡像,但是帶來的問題是,將來版本更新了,都得重新構建一遍。當然寫腳本自動構建,那就沒問題了。哈哈

方案二

這也是我目前採用的,構建應用鏡像的時候安裝 libgdiplus,但是因為系統鏡像源是國外,導致安裝 libgdiplus 十分緩慢,不忍直視。我們把系統包源地址修改成阿里雲包源地址,問題就迎刃而解了。 參考 Dockerfile 如下:

FROM mcr.microsoft.com/dotnet/core/aspnet:3.1
RUN sed -i "s@//deb.debian.org@//mirrors.aliyun.com@g" /etc/apt/sources.list 
RUN apt-get update -y && apt-get install -y libgdiplus && apt-get clean && ln -s /usr/lib/libgdiplus.so /usr/lib/gdiplus.dll
ARG PROJECT
WORKDIR /app
...

替換包源地址,注意哦,官方鏡像使用的是 debian 而不是 ubuntu 的源,一開始我一直以為 ubuntu 搞半天沒成功。

sed -i "s@//deb.debian.org@//mirrors.aliyun.com@g" /etc/apt/sources.list

番外:缺少中文字體咋辦呢?好辦

除了遭遇以上問題外,還遇到了字體缺失,導致的生成圖片中有關中文字體全部是亂碼的情況,這裡的中文是指我們通過程式自己畫上去的。對於這個問題嘛?缺啥補啥唄,缺字體補字體。基於上面的 Dockerfile 調整:

FROM mcr.microsoft.com/dotnet/core/aspnet:3.1
RUN sed -i "s@//deb.debian.org@//mirrors.aliyun.com@g" /etc/apt/sources.list 
RUN apt-get update -y && apt-get install -y libgdiplus locales fontconfig && apt-get clean && ln -s /usr/lib/libgdiplus.so /usr/lib/gdiplus.dll
RUN sed -ie 's/# zh_CN.UTF-8 UTF-8/zh_CN.UTF-8 UTF-8/g' /etc/locale.gen && locale-gen && mkdir /usr/share/fonts/truetype/deng/
ADD ./fonts/* /usr/share/fonts/truetype/deng/
RUN fc-cache -vf && fc-list
ENV LANG zh_CN.UTF-8
ARG PROJECT
WORKDIR /app
...
Tags: