ドライバーのバージョンをアップグレードする

v4.1 でシステムの重大な変更をビルド

v 4.1ドライバーは、ビルド システムに次の重大な変更を導入します。

• MongoDB Cドライバー v 2.0.0以降が必要

• Cドライバーの自動ダウンロード バージョンの ENABLE_TESTS 構成オプションをデフォルトで OFF に設定します。これは、v4.0 で行われた変更の展開です。

v4.1 の ABI 重大な変更

v4.1 ドライバーは、ABI に次の重大な変更を導入します。

• bsoncxx::v1::stdx名前空間の optional<T> と string_view のC++ 17 ポリゴンの実装を宣言します。bsoncxx::v_noabi::stdx名前空間には、v1 と同等の型エイリアスが含まれるようになりました。

  注意

  これは、 C++17 以降でコンパイルし、 が に設定されていないユーザーには影響しません。 BSONCXX_POLY_USE_IMPLS=ON

v4.0 でシステムの重大な変更をビルド

v 4.0ドライバーは、ビルド システムに次の重大な変更を導入します。

• Boost および MNMLSTC/core 外部 polyfill ライブラリのサポートを削除します。 次の構成オプションは設定できなくなりました。

  • ENABLE_BSONCXX_POLY_USE_IMPLS。このオプションは暗黙的に ON に設定されています。

  • BSONCXX_POLY_USE_MNMLSTC.

  • BSONCXX_POLY_USE_SYSTEM_MNMLSTC.

  • BSONCXX_POLY_USE_BOOST.

• MONGOCXX_OVERRIDE_DEFAULT_INSTALL_PREFIX 構成オプションのサポートを廃止します。 CMAKE_INSTALL_PREFIX のデフォルトの CSpec 動作が尊重されるようになりました。

• ENABLE_TESTS 構成オプションをデフォルトで OFF に設定します。 テスト ターゲットの構築を再度有効にするには、ENABLE_TESTS を ON に設定する必要があります。 「すべて」ターゲットにテストターゲットを含めるには、BUILD_TESTING オプションも ON に設定する必要があります。

  注意

  この変更は、 Cドライバーの自動ダウンロード バージョンには適用されません。自動ダウンロード バージョンの変更は v4.1 に追加されました。

v4.0 のAPI重大な変更

v4.0 ドライバーは、 APIに次の重大な変更を導入します。

• Boost または MNMLSTC/コア ライブラリと同等のエイリアスとして bsoncxx::stdx::string_view と bsoncxx::stdx::optional<T> を構成するサポートを廃止します。 コンテキストについては、「 ビルド システムの重大な変更 」セクションを参照してください。

• 次のヘッダー ファイルを削除します。

  • <bsoncxx/stdx/make_unique.hpp>

  • <bsoncxx/types/value.hpp>

  • <bsoncxx/util/functor.hpp>

  • <mongocxx/options/create_collection.hpp>

• string に相当する次の非推奨の utf8 型と関数を削除します。

  • k_utf8 bsoncxx::v_noabi::typeクラスからの 。 代わりに、k_string を使用してください。

  • b_utf8 bsoncxx::v_noabi::typesクラスからの 。 代わりに、b_string を使用してください。

  • get_utf8() bsoncxx::v_noabi::document::element、bsoncxx::v_noabi::array::element、bsoncxx::v_noabi::types::bson_value::view クラスからの。 代わりに、get_string() を使用してください。

  • k_cannot_append_utf8 bsoncxx::v_noabi::exception::error_codeクラスからの 。 代わりに、k_cannot_append_string を使用してください。

  • k_need_element_type_k_utf8 bsoncxx::v_noabi::exception::error_codeクラスからの 。 代わりに、k_need_element_type_k_string を使用してください。

• mongocxx::stdx名前空間を削除します。 コード内の次の型を置き換えます。

  • mongocxx::stdx::optional<T>。代わりに、bsoncxx::stdx::optional<T> を使用してください。

  • mongocxx::stdx::string_view。代わりに、bsoncxx::stdx::string_view を使用してください。

• 次のドキュメント化されていない using のディレクティブと宣言を削除します。

  • bsoncxx::builder::types <bsoncxx/builder/list.hpp> ヘッダーファイルからの。 代わりに、<bsoncxx/types.hpp> から bsoncxx::types を使用してください。

  • bsoncxx::builder::stream::concatenate <bsoncxx/builder/stream/helpers.hpp> ヘッダーファイルからの。 代わりに、<bsoncxx/builder/concatenate.hpp> から bsoncxx::builder::concatenate を使用してください。

  • mongocxx::events::read_preference <mongocxx/events/topology_description.hpp> ヘッダーファイルからの。 代わりに、<mongocxx/read_preference.hpp> から mongocxx::read_preference を使用してください。

v4.0 の ABI 重大な変更

v4.0 ドライバーは、ABI に次の重大な変更を導入します。

• Boost または MNMLSTC/コア ライブラリと同等のエイリアスとして bsoncxx::stdx::string_view と bsoncxx::stdx::optional<T> を構成するサポートを廃止します。 コンテキストについては、「 ビルド システムの重大な変更 」セクションを参照してください。

• string に相当する非推奨の utf8 関数を排除します。 これらの変更の完全なリストについては、 「 API重大な変更 」セクションを参照してください。

v3.11 でシステムの重大な変更をビルド

v 3.11ドライバーは、ビルド システムに次の重大な変更を導入します。

• MongoDB Server v 3.6のサポートを廃止します。

• MongoDB Cドライバー v 1.28.0以降が必要です。

• ENABLE_TESTS 構成オプションが ON に設定されている場合は、 C++14 以降が必要です。 CMax の構成中に ENABLE_TESTS=OFF を使用したテストを無効にすることで、 C++14 要件をオプトアウトできます。

v3.11 の ABI 重大な変更

v3.11 ドライバーは、ABI に次の重大な変更を導入します。

• bsoncx ABI 内の次のプライベート ノード関数のエクスポートを削除します。

  bsoncxx::v_noabi::types::bson_value::value::value(const uint8_t*, uint32_t, uint32_t, uint32_t)
  bsoncxx::v_noabi::types::bson_value::view::_init(void*)
  bsoncxx::v_noabi::types::bson_value::view::view(const uint8_t*, uint32_t, uint32_t, uint32_t)
  bsoncxx::v_noabi::types::bson_value::view::view(void*)

• mongocx ABI 内の次のプライベート ノード関数のエクスポートを削除します。

  mongocxx::v_noabi::options::change_stream::as_bson()
  mongocxx::v_noabi::options::aggregate::append(bsoncxx::v_noabi::builder::basic::document&)
  mongocxx::v_noabi::options::index::storage_options()

• MSVC でコンパイルされた場合は、エクスポートされたすべての関数シンボルを__cdeclで宣言します。 プロジェクトを構築するときに、代替のデフォルトの呼び出し規則を使用する場合、これは ABI の重大重大な変更です。

v3.10 でシステムの重大な変更をビルド

v 3.10ドライバーは、ビルド システムに次の重大な変更を導入します。

• find_package(libbsoncxx)とfind_package(libmongocxx)の呼び出しのサポートを廃止します。 代わりにfind_package(bsoncxx)とfind_package(mongocxx)を使用してください。

• レガシーCSpecパッケージ構成ファイルによって提供されるLIBBSONCXX_*およびLIBMONGOCXX_* CSpec 変数のサポートを廃止します。 代わりに、 mongo::bsoncxx_*とmongo::mongocxx_* CSpec ターゲットを使用してください。

• BSONCXX_POLY_USE_STD_EXPERIMENTAL Cake オプションを削除し、実験的なC++標準ライブラリを polyfill オプションとして選択するためのサポートを廃止します。

v3.9 でシステムの重大な変更をビルド

v 3.9ドライバーは、次の重大な変更を導入します。

• CSpecプロジェクト構築ツリーからエクスポートされたターゲットのサポートを削除します

• macOS 10.14 、 macOS 10.15 、 Ubuntu 14.04のサポートを廃止します。

• MongoDB Cドライバー v 1.25.0以降が必要

• FetchContentモジュールをサポートするには CMax v 3.15以降が必要