Lines Matching +full:cross +full:- +full:ios +full:- +full:build
5 …img.shields.io/github/license/cloudflare/quiche.svg)](https://opensource.org/licenses/BSD-2-Clause)
6 [](https://travis-ci.com/cloudfl…
22 [post]: https://blog.cloudflare.com/enjoy-a-slice-of-quic-and-rust/
25 ----------------
29 quiche powers Cloudflare edge network's [HTTP/3 support][cloudflare-http3].
33 quiche can be [integrated into curl][curl-http3] to provide support for HTTP/3.
37 quiche can be [integrated into NGINX][nginx-http3] using an unofficial patch to
40 [cloudflare-http3]: https://blog.cloudflare.com/http3-the-past-present-and-future/
41 [curl-http3]: https://github.com/curl/curl/blob/master/docs/HTTP3.md#quiche-version
42 [nginx-http3]: https://github.com/cloudflare/quiche/tree/master/extras/nginx
45 ---------------
47 ### Command-line apps
50 quiche tools provided as part of the [quiche-apps](tools/apps/) crate.
55 $ cargo run --manifest-path=tools/apps/Cargo.toml --bin quiche-client -- https://quic.tech:8443/
61 $ cargo run --manifest-path=tools/apps/Cargo.toml --bin quiche-server -- \
62 --cert tools/apps/src/bin/cert.crt \
63 --key tools/apps/src/bin/cert.key
66 (note that the certificate provided is self-signed and should not be used in
69 Use the `--help` command-line flag to get a more detailed description of each
84 On the client-side the [`connect()`] utility function can be used to create
141 timer to react to time-based connection events. The timer expiration can be
233 -------------------------
240 When running ``cargo build``, a static library called ``libquiche.a`` will be
241 built automatically alongside the Rust one. This is fully stand-alone and can
247 --------
249 quiche requires Rust 1.39 or later to build. The latest stable Rust release can
252 Once the Rust build environment is setup, the quiche source code can be fetched
256 $ git clone --recursive https://github.com/cloudflare/quiche
262 $ cargo build --examples
274 available during the build process. On Windows you also need
279 In alternative you can use your own custom build of BoringSSL by configuring
283 $ QUICHE_BSSL_PATH="/path/to/boringssl" cargo build --examples
290 To build quiche for Android, you need the following:
292 - Install the [Android NDK] (13b or higher), using Android Studio or directly.
293 - Set `ANDROID_NDK_HOME` environment variable to NDK path, e.g.
296 $ export ANDROID_NDK_HOME=/usr/local/share/android-ndk
299 - Install the Rust toolchain for Android architectures needed:
302 …$ rustup target add aarch64-linux-android arm-linux-androideabi armv7-linux-androideabi i686-linux…
313 For NDK version 19 or higher (21 recommended), you can build in a simpler
314 way using [cargo-ndk]. You need to install [cargo-ndk] first.
317 $ cargo install cargo-ndk
320 You can build the quiche library using the following procedure. Note that
321 `--target` and `--android-platform` are mandatory.
324 $ cargo ndk --target aarch64-linux-android --android-platform 21 -- build
331 [cargo-ndk]: https://docs.rs/crate/cargo-ndk
336 If you need to use NDK version < 18 (gcc), you can build quiche in the following way.
338 To prepare the cross-compiling toolchain, run the following command:
348 After it run successfully, run the following script to build libquiche:
351 $ tools/android/build_android.sh --features ndk-old-gcc
354 It will build binaries for aarch64, armv7 and i686. You can pass parameters to
355 this script for cargo build. For example if you want to build a release binary
359 $ tools/android/build_android.sh --features ndk-old-gcc --release -vv
362 ### Building for iOS
364 To build quiche for iOS, you need the following:
366 - Install Xcode command-line tools. You can install them with Xcode or with the
370 $ xcode-select --install
373 - Install the Rust toolchain for iOS architectures:
376 $ rustup target add aarch64-apple-ios x86_64-apple-ios
379 - Install `cargo-lipo`:
382 $ cargo install cargo-lipo
385 To build libquiche, run the following command:
394 $ cargo lipo --release
397 iOS build is tested in Xcode 10.1 and Xcode 11.2.
401 In order to build the Docker images, simply run the following command:
404 $ make docker-build
409 - [cloudflare/quiche](https://hub.docker.com/repository/docker/cloudflare/quiche)
410 - [cloudflare/quiche-qns](https://hub.docker.com/repository/docker/cloudflare/quiche-qns)
418 **cloudflare/quiche-qns**
420 …s the script to test quiche within the [quic-interop-runner](https://github.com/marten-seemann/qui…
423 ---------
425 Copyright (C) 2018-2019, Cloudflare, Inc.