Point Cloud Library is available in Vcpkg

English (United States)
日本語

What is Package Management System?

パッケージ管理システムはソフトウェアやライブラリのインストールや依存関係の解決などの管理を行うためのシステムです。
LinuxのAPTやYum、MacのMacPortsやHomebrewなど広く利用されています。
また、WindowsではC#などのManaged Language向けにNuGetが利用されています。

What is Vcpkg?

VcpkgはVisual C++向けのライブラリを管理するパッケージ管理システムです。
CMakeベースのパッケージ管理システムになっており、GitHubでオープンソースで開発されています。
このVcpkgを利用することで、様々なライブラリを簡単に導入することができます。インストールやプロジェクトの設定などライブラリごとに異なるこれらの作業をすべてVcpkgのコマンドで行うことができます。

VcpkgはVisual C++ 2017とVisual C++ 2015に対応しています。
BoostやOpenCVをはじめ、すでに300以上のライブラリをサポートしています。
サポートしているライブラリはportsディレクトリやvcpkg searchコマンドで参照してください。

Vcpkg Support PCL

Point Cloud Library (PCL)は3次元点群処理向けのオープンソースのライブラリです。
点群処理に関する様々な機能を持つライブラリですが、依存関係が多く導入が難しいとされています。

そこで、誰でもPCLを簡単に導入できるようにVcpkgでサポートしました。
以下のコマンドを実行することで依存ライブラリを含め簡単にインストールすることができます。^*1

# x86 dynamic link library
vcpkg install pcl:x86-windows

# x64 dynamic link library
vcpkg install pcl:x64-windows

# x86 static link library (Not Supported Yet)
# vcpkg install pcl:x86-windows-static

# x64 static link library (Not Supported Yet)
# vcpkg install pcl:x64-windows-static

^{*1 あらかじめ「chcp 65001」コマンドを実行して文字コードをUTF-8にしてください。}

How to install Vcpkg

Vcpkgは非常に簡単にインストールできます。

Vcpkgをダウンロード、任意の場所に展開する(e.g. C:\vcpkg)

以下のリンクからダウンロードすることができます。

Microsoft Vcpkg

Vcpkgをビルドする

vcpkg\bootstrap-vcpkg.batを起動すると自動的にビルドされます。
ビルドが正常に完了するとvcpkg\vcpkg.exeが生成されます。

環境変数Pathを設定しておくと便利でしょう。

Variable	Value
Path	;C:\vcpkg

Vcpkgが正常にインストールされているかどうか確認する

PowerShellを開いて以下のコマンドが実行してみましょう。

	vcpkg

以下のようなVcpkgのヘルプが表示されれば正常にインストールされています。

Basic Commands

Vcpkgでよく使う基本的なコマンドは以下の通りです。
この6種のコマンドだけ使えればVcpkgをマスターしたも同然です。

vcpkg install <pkg>:[triplet] / vcpkg remove <pkg>:[triplet]

パッケージをインストールまたはアンインストールします。
そのさい、パッケージの依存ライブラリも一緒にインストールされます。

明示的にターゲット(triplet)を指定しない場合、x86のdynamic link libraryをインストールします。他のターゲットを利用する場合、パッケージ名の後ろに指定します。

パッケージはvcpkg/installed/<triplet>にインストールされます。

	# x86 dynamic link library (default)
	vcpkg install boost:x86-windows
	
	# x86 static link library
	vcpkg install boost:x86-windows-static
	
	# x64 dynamic link library
	vcpkg install boost:x64-windows
	
	# x64 static link library
	vcpkg install boost:x64-windows-static

	# x86 dynamic link library (default)
	vcpkg remove boost:x86-windows
	
	# x86 static link library
	vcpkg remove boost:x86-windows-static
	
	# x64 dynamic link library
	vcpkg remove boost:x64-windows
		
	# x64 static link library
	vcpkg remove boost:x64-windows-static

vcpkg search

現在サポートしているパッケージ一覧を表示します。

	# List Supported Packages
	vcpkg search

vcpkg list

現在インストールされているパッケージ一覧を表示します。

	# List Installed Packages
	vcpkg list

vcpkg integrate install / vcpkg integrate remove

すべてのVisual C++のプロジェクトでインストールされたパッケージを利用できるようにします。それぞれのプロジェクトで設定を行う必要はなく、そのままライブラリを利用してプログラムを開発することができます。

設定するときはvcpkg integrate install、解除するときはvcpkg integrate removeを一度だけ実行します。

	# Integrate
	vcpkg integrate install
	
	# UnIntegrate
	vcpkg integrate remove

How to Generate Own Projects that use Installed Packages?

Vcpkgでインストールしたライブラリを自分のプロジェクトで使用するには以下の方法があります。

Vcpkgのコマンドを利用する方法

一度だけ以下のコマンドを実行することで、新規に作成したプロジェクトや既存のプロジェクトを含むすべてのプロジェクトで特別な設定をすることなくライブラリを利用することができます。

	# Integrate Vcpkg Settings to All Visual C++ Projects
	vcpkg integrate install

CMakeでプロジェクトを生成する方法

CMakeListsをもとに設定済みのプロジェクトを生成します。
これまで利用していたCMakeListsに以下の行を加えるだけでfind_package()はVcpkgのライブラリを探索します。

	 # Setting to use Vcpkg
	set( CMAKE_TOOLCHAIN_FILE "C:/vcpkg/scripts/buildsystems/vcpkg.cmake" )

手動で設定する方法

Reference

Vcpkgのドキュメントは以下にあります。
バグの報告や質問、リクエストなどありましたらissuesに登録してみましょう。