skia2/site/dev/contrib/c++11.md

C++11 in Skia

Skia uses C++11. But as a library, we are technically limited by what our clients support and what our build bots support.

Skia may also be limited by restrictions we choose put on ourselves. This document is not concerned with C++11 policy in Skia, only its technical feasibility. This is about what we can use, a superset of what we may use.

The gist:

• C++11 the language as supported by GCC 4.7 or later is probably usable.
• If you break a bot, that feature is not usable.
• The C++11 standard library can't generally be used.
• Local statics are not thread safe.

Clients

The clients we pay most attention to are Chrome, Android, Mozilla, and a few internal Google projects.

Chrome builds with a recent Clang on Mac and Linux and with a recent MSVC on Windows. These toolchains are new enough to not be the weak link to use any C++11 language feature. But Chrome still supports Mac OS X 10.6, which does not ship with a C++11 standard library. So Chrome has banned the use of the C++11 standard library. Some header-only features are probably technically fine, but the Mac toolchain will prevent us from even trying at compile time as long as we target 10.6 as our minimum API level.

Chrome intentionally disables thread-safe initialization of static variables, and MSVC doesn't support it at all, so we cannot rely on that.

Android builds with either a recent GCC or a recent Clang. They're generally not a weak link for C++11 language features. Android's C++ standard library has always been a pain, but since we can't use it anyway (see Chrome), don't worry about it.

Mozilla's current weak link is a minimum requirement of GCC 4.7. Most features marked in red on Mozilla's C++11 feature matrix are marked that way because they arrived in GCC 4.8. Their minimum-supported Clang and MSVC toolchains are great. They also appear to ban the C++ standard library.

Internal Google projects tend to support C++11 completely, including the full C++11 standard library.

Bots

Most of our bots are pretty up-to-date: the Windows bots use MSVC 2013, the Mac bots a recent Clang, and the Linux bots GCC 4.8 or a recent Clang. Our Android bots use a recent toolchain from Android (see above), and our Chrome bots use Chrome's toolchains (see above). I'm not exactly sure what our Chrome OS bots are using, but they've never been a problem.

I believe our bots' ability to use C++11 matches Mozilla's list nearly identically.