1 Creating the Mesa Intel Linux driver asset (which supports Vulkan) 2 ============================================================ 3 4 Using the automated asset python scripts requires that Docker be installed. 5 6 mesa_intel_driver_linux$ python create_and_upload.py 7 8 See below for steps on just building the driver. 9 10 Using Docker 11 ------------ 12 It is easiest to just use the pre-built docker image. 13 14 docker run -v /tmp/out:/OUT -e MESA_VERSION=18.1.7 gcr.io/skia-public/mesa-driver-builder:latest /opt/build_mesa.sh 15 16 You may change `/tmp/out` to be the desired output directory and `18.1.7` to be the desired 17 version of the mesa driver. 18 19 Finally, use `/tmp/out` as the input directory to the upload script. 20 21 Building it manually 22 -------------------- 23 If Docker is not installed, these steps may be used to build the driver. 24 This is known to work on Ubuntu 18.04, but is stale since we use the Docker container 25 for day-to-day builds. 26 27 Install all deps 28 29 sudo apt-get install autoconf libtool scons flex bison llvm-dev libpthread-stubs0-dev x11proto-gl-dev libdrm-dev libdrm2 x11proto-dri2-dev x11proto-dri3-dev x11proto-present-dev libxcb1-dev libxcb-dri3-dev libxcb-present-dev libxshmfence-dev xserver-xorg-core xserver-xorg-dev x11proto-xext-dev libxext-dev libxdamage-dev libx11-xcb-dev libxcb-glx0-dev libxcb-dri2-0-dev libva-dev libomxil-bellagio-dev 30 31 sudo pip install mako 32 33 The following steps are also represented in `mesa-driver-builder/build_mesa.sh` 34 35 Get the source from ftp.freedesktop.org/pub/mesa/ 36 37 MESA_VERSION=18.1.7 38 wget ftp://ftp.freedesktop.org/pub/mesa/mesa-$MESA_VERSION.tar.gz 39 gunzip mesa-$MESA_VERSION.tar.gz 40 tar --extract -f mesa-$MESA_VERSION.tar 41 mv mesa-$MESA_VERSION/ mesa 42 cd mesa 43 44 45 Build the driver 46 47 # For the debug resource, use --enable-debug 48 mesa$ ./autogen.sh --disable-radeon --with-gallium-drivers=i915 --with-vulkan-drivers=intel 49 mesa$ make -j 50 50 51 52 Tweak icd.json file and output dir (mesa/lib) 53 54 mesa$ cp src/intel/vulkan/intel_icd.x86_64.json lib/ 55 # modify the pathname in the intel_icd.x86_64.json file to be ./libvulkan_intel.so 56 mesa$ rm -rf lib/gallium # We don't need this 57 mesa$ rm lib/nouveau_vieux_dri.so lib/r200_dri.so lib/radeon_dri.so # We don't need these 58 59 Finally, use mesa/lib as the input directory to the upload script. 60 61 62 Docker Image Maintanence 63 ------------------------ 64 The docker image `mesa-driver-builder` is an Ubuntu container with many build 65 tools installed (including Clang 6). It is designed specifically to build the mesa driver. 66 67 The image only needs to be re-built when the dependencies change or the build_mesa.sh is updated. 68 69 docker build -t mesa-driver-builder ./mesa-driver-builder/ 70 # use v1, v2, v3, etc to handle changes/updates to the image. 71 docker tag mesa-driver-builder gcr.io/skia-public/mesa-driver-builder:v1 72 docker push gcr.io/skia-public/mesa-driver-builder:v1
