プラグインのコンパイル

ヒント:

.NET を初めて使用する場合、以下の「グローバルアセンブリキャッシュ(GAC)を使用する」のセクションも参照してください。

プラグインをコンパイルするには

Softimage コマンドプロンプトを開き、devenv と入力して Visual Studio .NET を起動します。

Softimage コマンドプロンプトから Visual Studio .NET を起動すると、XSI_HOME などの環境変数を確実に設定することができます(これを設定しないと、ビルドエラーやリンクエラーが発生します)。
Visual Studio .NET で、.csproj プロジェクトファイルを開きます。

[ソースコントロール](Source Control)ダイアログボックスが表示されたら[OK]をクリックし、続けて[ソースコントロールの変更](Change Source Control)ダイアログボックスで[接続しないで作業](Work Disconnected)をクリックします。
このプラグインが共有ネットワークからロードされる場合は、プラグインに対して厳密な名前のキーを作成するようにします。
構成([デバッグ]または[リリース])を選択し、DLL をビルドします。

プラグインを最初にビルドするときに、ソリューションファイル(.sln)を保存するように求めるメッセージが表示されます。
このプラグインが共有ネットワークからロードされる場合は、プラグインアセンブリを GAC(グローバルアセンブリキャッシュ)に追加します。追加するには、コマンドプロンプトで以下を実行します。
```
gacutil /i \servername\<plugin_path>\YourPluginName.dll
```
次のいずれかの方法で、プラグインを Softimage にロードします。
- プラグインマネージャで、[すべて更新](Update All)をクリックします。
- プラグインマネージャで[ロード](Load)をクリックし、プラグインの .DLL を指定してから、[OK]をクリックします。
- プラグインマネージャでプラグインフォルダを右クリックし、コンテキストメニューから[更新](Update)を選択して、ロードするプラグインを選択します。

グローバルアセンブリキャッシュ(GAC)を使った操作

グローバルアセンブリキャッシュ(GAC)には、1 台のマシン上の複数のアプリケーションに対して実行が可能なアセンブリが含まれています。 GAC はアセンブリがキャッシュに追加されると整合性のチェックを実行します。また、常に正しいバージョンがロードされるように、厳密な名前を使用します。

このキャッシュはグローバルアセンブリキャッシュユーティリティ(gacutil)を使用して管理できます。このユーティリティを使用すると、キャッシュ内のアセンブリをインストールまたはアンインストールしたり、インストール済みのアセンブリを確認することができます。 gacutil を使用するには、MSDN Framework デベロッパーセンターから入手できる .NET Framework SDK をインストールする必要があります。

Softimage 上では、Softimage SDK アセンブリがインストールされていることを確認し、実行しているバージョンを確認する必要があります。 SDK アセンブリがインストールされていない場合は、インストールする必要があります。

Softimage アセンブリがインストールされているかどうかを確認するには

Softimage コマンドプロンプトから以下のコマンドを実行します。
```
gacutil /l Softimage.XSIOM
gacutil /l Softimage.XSIUtil
gacutil /l Softimage.XSIMath
```
重要:
このユーティリティを実行するとき、以下のメッセージが表示される場合があります。
```
'gacutil' is not recognized as an internal or external command, operable program or batch file.
```
C:¥Program Files¥Microsoft SDKs ディレクトリ下(たとえば、Microsoft Visual Studio 8 では C:¥Program Files¥Microsoft SDKs¥Windows¥v6.0A¥bin)を確認し、フォルダを %PATH% に追加します。

これらが適切にインストールされている場合は、次のような文字列が表示されます。

The Global Assembly Cache contains the following assemblies:
	Softimage.XSIMath, Version=1.0.0.0, Culture=neutral, PublicKeyToken=a90401fcf6bc5571, processorArchitecture=MSIL
Number of items = 1

The Global Assembly Cache contains the following assemblies:
	Softimage.XSIUtil, Version=1.0.0.0, Culture=neutral, PublicKeyToken=a90401fcf6bc5571, processorArchitecture=MSIL
Number of items = 1

The Global Assembly Cache contains the following assemblies:
	Softimage.XSIMath, Version=1.0.0.0, Culture=neutral, PublicKeyToken=a90401fcf6bc5571, processorArchitecture=MSIL
Number of items = 1

適切にインストールされていない場合は、次のメッセージが表示されます。

The Global Assembly Cache contains the following assemblies:

Number of items = 0

Softimage アセンブリを GAC にインストールするには

Softimage コマンドプロンプトを開き(ファクトリロケーションの Application/bin ディレクトリで自動的に開きます)、以下の 3 つのコマンドを入力します。
```
gacutil /i Softimage.XSIOM.dll
gacutil /i Softimage.XSIUtil.dll
gacutil /i Softimage.XSIMath.dll
```
インストールが成功すると、次のメッセージが表示されます。
```
Assembly successfully added to the cache
```

Softimage アセンブリを GAC からアンインストールするには

Softimage コマンドプロンプトを開き(ファクトリロケーションの Application/bin ディレクトリで自動的に開きます)、以下の 3 つのコマンドを入力します。
```
gacutil /u Softimage.XSIOM.dll
gacutil /u Softimage.XSIUtil.dll
gacutil /u Softimage.XSIMath.dll
```

厳密な名前

厳密な名前とはエンコードされたシグネチャのことであり、各システム上で独自のアセンブリを維持するのに役立ちます。 GAC にアセンブリを追加するためには、厳密な名前のキーを使用する必要があります。通常、このキーはファイル(.snk)に保存されます。

厳密な名前のキーを作成するには:

Visual Studio .NET で .csproj プロジェクトファイルを開き、[プロジェクト](Project)メニューの[<プロジェクト名>プロパティ](<YourProjectName> Properties)を選択します。
[署名](Signing)タブをクリックしてから、[アセンブリに署名](Sign the assembly)オプションをオンにします。
[厳密な名前のキーファイルを選択してください](Choose a strong name key file)ドロップダウンボックスから、[<新規作成...>](<New...>)を選択します。 [厳密な名前キーの作成](Create Strong Name Key)ダイアログボックスが開きます。
厳密な名前のキーファイルを入力し、[OK]をクリックします。