littlewing

人間とコンピューターとメディアの接点をデザインするために考えたこと

Unityで利用する c++ のDLLを作成する。(Visual Studio 2017)

基本的に、以下のページにある手順で進めればNative Plugin を作成できるのですが 解説が、VS2013ベースになっているので、Visuai Studio 2017で実施した場合に ハマッた部分を、忘れないうちにスクショ付きでまとめました。

部分的にしか解説してないので、全体は以下のページを参照してください。

qiita.com

でやりました。


DLLビルド用のVSプロジェクトの準備

  1. 既存のソリューションに、DLL作成用のプロジェクトを追加する場合はこんな感じでスタート

2018/8/17追記 VS2017 update 3 ではこの部分がまた変更になっています。 * Visual Studio 2017 Update 3 以降で Win32 プロジェクトが作成できなくなった時の対処法 - Qiita

f:id:pigshape:20180118122930p:plain

  1. DLLを作るのですが、この画面では、「c++ のWin32コンソールアプリケーション」を選択。 f:id:pigshape:20180118123005p:plain

  2. 次に表示されるこの画面で「アプリケーション設定」をクリックして、DLLを選択します。 シンボルのエクスポートも忘れないように。 f:id:pigshape:20180118123057p:plain

  3. Unityに出力するなら「SDLのチェック」は外さないといけないらしいです。

f:id:pigshape:20180118133326p:plain


で、コードを書く。ここは省略します。


exe形式で実行テスト

同一ソリューション内で、テストのためのexe用プロジェクトを作成したのであれば、 「参照の追加」を行うのが、手っ取り早いです。

f:id:pigshape:20180118131611p:plain

ただし、既存の外部DLLやlibを使う場合はこれではダメです。 そのような場合は、以下の3つを設定します。

  1. c++  > 全般 > 追加のインクルードディレクトリ include/フォルダを指定し、その中に.hファイルを置く f:id:pigshape:20180118131154p:plain

  2. リンカ >全般>追加のライブラリディレクトリ libフォルダを指定 f:id:pigshape:20180118131322p:plain

  3. リンカ >入力 >追加の依存ファイル libファイルを指定 f:id:pigshape:20180118131345p:plain


作成したDLLをUnity上で実行する

Unityからは

[DllImport("sample-opencv-dll")] private static extern int CountUp();
            Debug.Log(CountUp());
            Debug.Log(CountUp());
            Debug.Log(CountUp());

のような感じで呼びだすことができます。 「DllImport」にファイル名を書くときは拡張子 (.dll)を含めるとエラーになるので含めません。


libで追加ライブラリを指定した場合は、そのdllもPlugins内に配置しておかないと、

Plugins: Failed to load 'Assets/Plugins/x86_64/xxxxxxxx.dll' with error '指定されたモジュールが見つかりません。
'.

という警告や

DllNotFoundException: Failure has occurred while loading a type.

という例外エラーが発生するので、関連DLLの配置もお忘れなく。


おまけ 既存DLL ( or lib ) の中身を解析する方法

スタートメニューから[開発者コマンド プロンプト for VS2015]を起動する

  • DLLのインターフェースを確認する
cd (DLLの場所)
dumpbin  /exports xxxxx.dll
  • dllが32bitか64bitか確認する。
dumpbin   /HEADERS xxxxx.dll | findstr machine

Visual Studio 2017のみでdumpbin を使う。(追記2018.12.28)

[開発者コマンド プロンプト for VS2015]は、Visual Studio 2017 のみインストールしていると、スタートメニューに表示されない。

利用するにはコマンドから起動する必要がある。

Win +R を押して

cmd /k "C:\Program Files (x86)\Microsoft Visual Studio\2017\Community\Common7\tools\VsDevCmd.bat"

で起動できる。 ちなみに、dumpbin.exe自体は

この辺りにある。

参考: If you have Visual Studio 2017 installed then you can use dumpbin to dump the PE... | Hacker News