mumble/docs/dev/build-instructions
Robert Adam b3dd3d3f79 CHANGE(server): Remove gRPC implementation
The gRPC implementation never left the experimental state and never
reached a properly stable state to the point where we would feel good
about enabling it by default. In addition to that, there has been no
further attempts at finding and fixing the encountered issues in the
implementation (except #3947 but that was discontinued).

As such we had an essentially unmaintained piece of code in our server
implementation that was known to be buggy and that nobody wanted to fix.
In addition to that the implementation itself could not be considered
very clean or elegant and therefore only represented a few smelly
corners in our code base.

For this reason, we decided to remove the gRPC support entirely from
Mumble (for now).

What we hope to gain by that is:
- Prevent people from building unstable server versions and then coming
to us complaining that it crashed/misbehaved
- Removing (essentially) dead code
- Reduce the RPC implementation complexity

That last piece is crucial: By removing gRPC support we reduce the
amount of supported RPC frameworks to only one (ignoring DBus for now).
Our future plans include a refactoring of how RPC is being handled and
implemented and only having to worry about maintaining compatibility
with one RPC system is much easier than having to worry about two (with
(slightly) different APIs).
Once the RPC implementation has been rewritten, more RPC backends may be
reintroduced and in that process we might investigate adding a proper
gRPC implementation to the code (that then hopefully is more stable than
the current one).

Fixes #4567
Fixes #4197
Fixes #3496
Fixes #3429
Fixes #3265
2022-03-16 08:23:38 +01:00
..
build_installer.md DOCS: Mention BUILD_NUMBER for building installer 2021-05-30 16:52:25 +02:00
build_linux.md CHANGE(server): Remove gRPC implementation 2022-03-16 08:23:38 +01:00
build_macos.md DOCS: Added info about Poco dependency 2021-05-14 18:24:54 +02:00
build_static.md CHANGE(server): Remove gRPC implementation 2022-03-16 08:23:38 +01:00
build_windows.md DOCS: Added instructions to install Visual Studio 2020-11-01 08:20:00 +01:00
cmake_options.md CHANGE(server): Remove gRPC implementation 2022-03-16 08:23:38 +01:00
common_build_errors.md DOCS: Add FindPythonInterpreter error to common build errors 2022-01-24 08:23:17 +01:00
faq.md DOCS: Mention unity builds 2021-03-06 18:57:22 +01:00
find_build_number.md DOCS: Extend build number docs 2022-01-09 19:54:49 +01:00
ide_integration.md DOCS: Fix vcpkg paths in build documentation 2021-01-14 19:57:06 +01:00
README.md DOCS: Updated build instructions to remove duplicated step 2022-01-18 13:01:14 -08:00
setup_visual_studio.md DOCS: Added instructions to install Visual Studio 2020-11-01 08:20:00 +01:00

Build Mumble

A fundamental dependency for building Mumble is git, so make sure you have it installed. If you are new to git, make sure to checkout this guide on git's basics in order to be able to follow the given instructions.

Furthermore Mumble requires a Cpp14-conform compiler.

The first step in building Mumble is to clone this repository via git clone https://github.com/mumble-voip/mumble.git and then going into the cloned directory and run git submodule update --init --recursive in order to also clone all submodules.

Tip: You can also build a specific version or commit of Mumble.

In order to actually build Mumble, you can follow one of the following instruction sets:

Furthermore you might find these helpful as well: