data/cross-files/README.md

   1 # Cross compiling GStreamer with gst-build
   2
   3 GStreamer can be cross compiled for various platforms using gst-build. However,
   4 only dependencies that are ported to the Meson build system will be built. It is
   5 recommended to use Cerbero to cross compile GStreamer when other external
   6 dependencies are required.
   7
   8 Once the toolchain is installed and a Meson cross file is created, to build
   9 GStreamer simply run for example: `meson --cross-file data/cross-files/mingw_w64_x86-64.txt builddir`.
  10
  11 ## Android
  12
  13 Requires Android API level >= 28, previous versions are missing *iconv* dependency.
  14
  15 - Download and extract the [NDK](https://developer.android.com/ndk/)
  16 - Create a Meson cross file, you can use `android_arm64_api28.txt` as example
  17   and change CPU architectures and toolchain path using the prebuilt toolchains
  18   from the NDK.
  19
  20 Notes:
  21 - On fedora the Android NDK requires the `ncurses-compat-libs` package.
  22
  23 ## Windows
  24
  25 GStreamer can be cross compiled for Windows using mingw packaged in most
  26 distribution.
  27
  28 The Meson cross file `mingw_w64_x86-64.txt` can be used when targeting amd64
  29 architecture, or adapted for i686 arch.
  30
  31 ### Fedora
  32
  33 - Install the toolchain packages: `mingw64-gcc`, `mingw64-gcc-c++`. Fedora
  34   provides many other optional dependencies that could be installed as well.
  35   For example: `mingw64-gettext`, `mingw64-libffi`, `mingw64-zlib`.
  36
  37 ### Ubuntu
  38
  39 - Install the toolchain package: `gcc-mingw-w64`.