設定 C++ 開發環境

本教學課程說明如何準備本機電腦以進行 C++ 開發工作，包括開發在 Google Cloud上執行的 C++ 應用程式。

如果開發環境已設置好，請參閱 C++ 和 Google Cloud，大致瞭解如何在 Google Cloud上執行 C++ 應用程式。

目標

• 安裝與 Google Cloud 相容的支援 C++ 版本。
• 安裝 C++ 建構系統。
• 安裝編輯器 (選用)。
• 安裝 Google Cloud CLI (選用)。
• 安裝 C++ 適用的 Cloud 用戶端程式庫 (選用)。
• 設定驗證方法。

安裝 C++

C++ 的安裝方式會因作業系統而異。請根據您在開發環境中使用的作業系統 (macOS、Windows 或 Linux)，按照對應的指示進行操作。

macOS

1. 安裝 Xcode 的指令列工具即可取得 C++ 編譯器。

   xcode-select --install
   

2. 安裝完成後，請確認編譯器是否可做為 c++ 使用：

   c++ --version
   

Windows

1. 如要在 Windows 環境中安裝 C++ 編譯器，請從 Visual Studio 網站下載 Microsoft 的「Visual Studio」。這會下載完整的 IDE，包括編輯器、偵錯工具和建構系統。

2. 如要存取 C++ 編譯器，請按照 Visual Studio 的「開始使用」指南中的 C++ 部分操作。

Linux

大多數 (如果不是全部) Linux 發行版都將 GCC 做為主要的 C++ 編譯器。許多 Linux 發行版也包含 CLang，可做為替代的 C++ 編譯器。C++ 用戶端程式庫同時支援這兩種方式。

1. 如要在 Linux 環境中安裝 C++，請根據您使用的發行版，安裝適用的套件。以 Debian 和 Ubuntu 而言，這個套件為 g++。

   請使用下列指令安裝這些套件：

   sudo apt update
   sudo apt install g++
   

2. 安裝完畢後，請確認已安裝 g++：

   g++ --version
   

安裝與 Google Cloud 相容的 C++ 建構系統

如要有效使用 C++，您需要支援 C++ 適用的 Cloud 用戶端程式庫的建構系統和套件管理員。用戶端程式庫支援多個這類建構系統和套件管理員。

搭配 vcpkg 使用 CMake

1. 作業系統可能會提供已安裝的 CMake 套件。如果沒有，請從 CMake 下載頁面安裝。

2. 如要安裝 vcpkg，請參閱「開始使用 vcpkg」

搭配 Conda 使用 CMake

1. 作業系統可能會提供已安裝的 CMake 套件。如果沒有，請從 CMake 下載頁面安裝。

2. 如要安裝 Conda，請參閱 Conda 使用者指南的安裝章節。

Bazel

1. 如要安裝 Bazel，請參閱「安裝 Bazel」

其他

如需使用其他建構系統或套件管理工具，請參閱 C++ 用戶端程式庫存放區的來源建構說明。

安裝編輯器

市面上有許多支援 C++ 的編輯器和 IDE。選擇符合需求的方案。選取時，請考慮下列功能：

• 完全整合的除錯功能
• 語法醒目顯示
• 補全程式碼

安裝 Google Cloud CLI

Google Cloud CLI 是一組 Google Cloud工具，其中包含 gcloud 和 bq 指令列工具，可從指令列存取 Compute Engine、Cloud Storage、BigQuery 和其他服務。您可以利用這些工具進行互動操作，也可以使用自動化指令碼執行這些工具。

安裝 C++ 適用的 Cloud 用戶端程式庫

C++ 開發人員常運用 C++ 適用的 Cloud 用戶端程式庫整合各項Google Cloud 服務，例如 Spanner 和 Cloud Storage。

舉例來說，如要為個別 API (例如 Cloud Storage API) 安裝套件，請按照下列步驟操作：

搭配 vcpkg 使用 CMake

1. 將 google-cloud-cpp 新增為 vcpkg.json 檔案的依附元件：

   {
       "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. 編輯 CMakeLists.txt 檔案，要求使用程式庫

   find_package(google_cloud_cpp_storage REQUIRED)

3. 將這項依附元件新增至目標

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

4. 使用 vcpkg 工具鍊設定 CMake。系統會自動下載及編譯 google-cloud-cpp 和其依附元件。

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

搭配 Conda 使用 CMake

1. 使用 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. 編輯 CMakeLists.txt 檔案，要求使用程式庫

   find_package(google_cloud_cpp_storage REQUIRED)

3. 將這項依附元件新增至目標

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

4. 在 Conda 環境中設定 CMake。

   cmake -S . -B [build directory]
   

Bazel

1. 在 WORKSPACE 檔案中新增下列指令，下載 C++ 原始碼的 Cloud 用戶端程式庫：

   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. 在 WORKSPACE 檔案中呼叫 Starlark 函式，載入遞迴依附元件：

   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. 在 BUILD 檔案中使用 Cloud Storage 程式庫：

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

設定驗證方法

如要在本機開發環境中使用 Cloud 用戶端程式庫，請設定應用程式預設憑證。

If you're using a local shell, then create local authentication credentials for your user account:

gcloud auth application-default login

You don't need to do this if you're using Cloud Shell.

If an authentication error is returned, and you are using an external identity provider (IdP), confirm that you have signed in to the gcloud CLI with your federated identity.

詳情請參閱「進行驗證以使用用戶端程式庫」一文。

後續步驟

• 進一步瞭解驗證。
• 如要進一步瞭解 C++，請前往 Google Cloud。
• 參閱 Google Cloud 產品說明文件。
• 從 GitHub 複製 C++ 範例存放區。