So far the only supported and default backend is GStreamer. So in order to build this crate you need to install all gstreamer-rs dependencies for your specific platform as listed here.
For Android there are some extra requirements.
First of all, you need to install the appropriate toolchain for your target.
The recommended approach is to install it through
rustup. Taking arm-linux-androideabi
as our example
target you need to do:
rustup target add arm-linux-androideabi
In addition to that, you also need to install the Android NDK. The recommended NDK version is r16b. The Android SDK is not mandatory but recommended for practical development.
Once you have the Android NDK installed in your machine, you need to create what the NDK itself calls a standalone toolchain.
$ ${ANDROID_NDK}/build/tools/make-standalone-toolchain.sh \
--platform=android-18 --toolchain=arm-linux-androideabi-4.9 \
--install-dir=android-18-arm-toolchain --arch=arm
The final thing for us to do is tell Cargo where to find the android linker,
which is in the standalone NDK toolchain we just created. To do that we
configure the arm-linux-androideabi
target in .cargo/config
(or in
~/.cargo/config
if you want to apply the setting globaly) with the linker
value.
[target.arm-linux-androideabi]
linker = "<path-to-your-toolchain>/android-18-toolchain/bin/arm-linux-androideabi-gcc"
This crate indirectly depends on
libgstreamer_android_gen:
a tool to generate the required libgstreamer_android.so
library with all
GStreamer dependencies for Android and some Java code required to initialize
GStreamer on Android. If you want to generate your own libgstreamer_android.so
bundle, check the documentation from that repo and tweak the
build script accordingly.
For OSX, Windows and Linux, simply run:
cargo build
For Android, run:
PKG_CONFIG_ALLOW_CROSS=1 cargo build --target=arm-linux-androideabi
Make sure that you have adb
installed and you have adb access to your
Android device. Go to the examples/android
folder and run:
./setup.sh
This will download and add the required GStreamer code generated by
libgstreamer_android_gen
required to initialize GStreamer on Android. This
step is only required once. After that you can run:
source run.sh