C++ 開発環境の設定

このチュートリアルでは、Google Cloud で動作する C++ アプリの開発など、C++ 開発用のローカルマシンを準備する方法を説明します。

開発環境をすでにセットアップしている場合は、C++ と Google Cloud を参照して、Google Cloud で C++ アプリを実行する方法の概要を確認してください。

目標

• Google Cloud と互換性のあるサポートされているバージョンの C++ をインストールします。
• C++ ビルドシステムをインストールします。
• エディタのインストール（省略可）
• Google Cloud CLI をインストールします（省略可）。
• C++ 用の Cloud クライアント ライブラリをインストールします（省略可）。
• 認証を設定します。

C++ のインストール

C++ のインストール手順は、オペレーティング システムによって異なります。開発環境で実行しているオペレーティング システム（macOS、Windows、Linux）のガイドに従ってください。

macOS

1. C++ コンパイラを取得するには、Xcode のコマンドライン ツールをインストールします。

   xcode-select --install
   

2. インストールが完了したら、コンパイラが c++ として使用可能であることを確認します。

   c++ --version
   

Windows

1. Windows 環境に C++ コンパイラをインストールするには、Visual Studio のウェブサイトから Microsoft の「Visual Studio」をダウンロードします。これにより、エディタ、デバッガ、ビルドシステムを含む完全な IDE がダウンロードされます。

2. C++ コンパイラにアクセスするには、Visual Studio のスタートガイドの C++ セクションに従ってください。

Linux

ほとんどの（すべてではない）Linux ディストリビューションには、プライマリ C++ コンパイラとして GCC が含まれています。多くの Linux ディストリビューションには、代替の C++ コンパイラとして CLang も含まれています。C++ クライアント ライブラリは両方をサポートします。

1. C++ を Linux 環境にインストールするには、ご使用のディストリビューションに適したパッケージをインストールしてください。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 のための一連のツールです。これには、コマンドラインから Compute Engine、Cloud Storage、BigQuery、その他のサービスにアクセスするために使用される gcloud、gsutil、bq といったコマンドライン ツールが含まれます。これらのツールはインタラクティブに実行することも、自動スクリプトで実行することもできます。

C++ 用 Cloud クライアント ライブラリをインストールする

C++ 用 Cloud クライアント ライブラリは、C++ デベロッパーが Cloud Spanner や Cloud Storage などの Google Cloud サービスと統合するための慣用的な方法です。

たとえば、Cloud Storage API などの個々の API のパッケージをインストールするには、次のようにします。

vcpkg の CMake

1. vcpkg.json ファイルに依存関係として google-cloud-cpp を追加します。

   setup/vcpkg.json

   GitHub で表示
   {
       "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 ファイルを編集してライブラリを要求する

   setup/CMakeLists.txt

   GitHub で表示
   find_package(google_cloud_cpp_storage REQUIRED)

3. この依存関係をターゲットに追加する

   setup/CMakeLists.txt

   GitHub で表示
   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 ファイルを編集してライブラリを要求する

   setup/CMakeLists.txt

   GitHub で表示
   find_package(google_cloud_cpp_storage REQUIRED)

3. この依存関係をターゲットに追加する

   setup/CMakeLists.txt

   GitHub で表示
   target_link_libraries(hello_world PUBLIC google-cloud-cpp::storage)

4. Conda 環境内で CMake を構成します。

   cmake -S . -B [build directory]
   

Bazel

1. WORKSPACE ファイルに次のコマンドを追加して、C++ ソースコード用の Cloud クライアント ライブラリをダウンロードします。

   setup/WORKSPACE.bazel

   GitHub で表示
   load("@bazel_tools//tools/build_defs/repo:http.bzl", "http_archive")
   
   http_archive(
       name = "google_cloud_cpp",
       sha256 = "63f009092afd900cb812050bcecf607e37d762ac911e0bcbf4af9a432da91890",
       strip_prefix = "google-cloud-cpp-2.19.0",
       url = "https://github.com/googleapis/google-cloud-cpp/archive/v2.19.0.tar.gz",
   )

2. WORKSPACE ファイルで Starlark 関数を呼び出して、再帰依存関係を読み込みます。

   setup/WORKSPACE.bazel

   GitHub で表示
   load("@google_cloud_cpp//bazel:google_cloud_cpp_deps.bzl", "google_cloud_cpp_deps")
   
   google_cloud_cpp_deps()
   
   load("@com_google_googleapis//:repository_rules.bzl", "switched_rules_by_language")
   
   switched_rules_by_language(
       name = "com_google_googleapis_imports",
       cc = True,
       grpc = True,
   )
   
   load("@com_github_grpc_grpc//bazel:grpc_deps.bzl", "grpc_deps")
   
   grpc_deps()
   
   load("@com_github_grpc_grpc//bazel:grpc_extra_deps.bzl", "grpc_extra_deps")
   
   grpc_extra_deps()

3. BUILD ファイルで、Cloud Storage ライブラリを使用します。

   setup/BUILD.bazel

   GitHub で表示
   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.

詳細については、クライアント ライブラリの使用に対する認証をご覧ください。

次のステップ

• 認証の詳細を確認する。
• Google Cloud での C++ の詳細を確認する。
• Google Cloud サービスのドキュメントを見る。
• GitHub から C++ サンプル リポジトリのクローンを作成する。