Setting up a C++ development environment

macOS

1. You can get a C++ compiler by installing Xcode's command-line tools.

   xcode-select --install
   

2. After the installation is complete, verify that your compiler is available as c++:

   c++ --version
   

Windows

1. To install a C++ compiler in a Windows environment, download the Microsoft's "Visual Studio" from the Visual Studio website. This will download a full IDE, including an editor, debugger and build systems.

2. To access your C++ compiler follow the C++ section in Visual Studio's Getting Started guide.

Linux

Most (if not all) Linux distributions include GCC as their primary C++ compiler. Many Linux distributions also include CLang as an alternative C++ compiler. The C++ client libraries support both.

1. To install C++ in a Linux environment, install the appropriate packages for your distribution. For Debian and Ubuntu, this package is g++.

   Install these packages using the following commands:

   sudo apt update
   sudo apt install g++
   

2. After the installations are complete, verify that you have g++ installed:

   g++ --version
   

CMake with vcpkg

1. Your operating system may provide packages for CMake installed. If it does not, install it from the CMake download page

2. To install vcpkg, see Get Started with vcpkg

CMake with Conda

1. Your operating system may provide packages for CMake installed. If it does not, install it from the CMake download page

2. To install Conda, see the Installation section in Conda's User Guide.

Bazel

1. To install Bazel, see Installing Bazel

Other

If you need to use a different build system or package manager the C++ client libraries repository include instructions to build from source.

CMake with vcpkg

1. Add google-cloud-cpp as dependency to your vcpkg.json file:

   {
       "name": "setup-cpp-vcpkg",
       "version-string": "unversioned",
       "description": "Setting up C++ for Google Cloud with CMake and vcpkg",
       "dependencies": [
           {"name": "google-cloud-cpp", "default-features": false, "features": ["storage"]}
       ]
   }
   

2. Edit your CMakeLists.txt file to require the library

   find_package(google_cloud_cpp_storage REQUIRED)

3. Add this dependency to your targets

   target_link_libraries(hello_world PUBLIC google-cloud-cpp::storage)

4. Configure CMake using the vcpkg toolchain. This will automatically download, and compile google-cloud-cpp and its dependencies.

   cmake -S . -B [build directory] \
       -DCMAKE_TOOLCHAIN_FILE=[vcpkg location]/scripts/buildsystems/vcpkg.cmake
   

CMake with Conda

1. Install the dependencies using Conda:

   conda config --add channels conda-forge
   conda config --set channel_priority strict
   conda install -y -c conda-forge cmake ninja cxx-compiler google-cloud-cpp libgoogle-cloud

2. Edit your CMakeLists.txt file to require the library

   find_package(google_cloud_cpp_storage REQUIRED)

3. Add this dependency to your targets

   target_link_libraries(hello_world PUBLIC google-cloud-cpp::storage)

4. Configure CMake within your Conda environment..

   cmake -S . -B [build directory]
   

Bazel

1. In your WORKSPACE file add the follow command to download the Cloud Client Libraries for C++ source code:

   load("@bazel_tools//tools/build_defs/repo:http.bzl", "http_archive")
   
   http_archive(
       name = "google_cloud_cpp",
       sha256 = "db69dd73ef4af8b2e816d80ded04950036d0e0dccc274f8c3d3ed1d7f5692a1b",
       strip_prefix = "google-cloud-cpp-2.32.0",
       url = "https://github.com/googleapis/google-cloud-cpp/archive/v2.32.0.tar.gz",
   )

2. In your WORKSPACE file call the Starlark functions to load recursive dependencies:

   load("@google_cloud_cpp//bazel:workspace0.bzl", "gl_cpp_workspace0")
   
   gl_cpp_workspace0()
   
   load("@google_cloud_cpp//bazel:workspace1.bzl", "gl_cpp_workspace1")
   
   gl_cpp_workspace1()
   
   load("@google_cloud_cpp//bazel:workspace2.bzl", "gl_cpp_workspace2")
   
   gl_cpp_workspace2()
   
   load("@google_cloud_cpp//bazel:workspace3.bzl", "gl_cpp_workspace3")
   
   gl_cpp_workspace3()
   
   load("@google_cloud_cpp//bazel:workspace4.bzl", "gl_cpp_workspace4")
   
   gl_cpp_workspace4()
   
   load("@google_cloud_cpp//bazel:workspace5.bzl", "gl_cpp_workspace5")
   
   gl_cpp_workspace5()

3. In your BUILD file use the Cloud Storage library:

   cc_binary(
       name = "hello_world",
       srcs = ["hello_world.cc"],
       deps = ["@google_cloud_cpp//:storage"],
   )