Office ソリューションのビルド

  • [アーティクル]

一般に、Office プロジェクトのビルドとデバッグは、Visual Studio のその他の種類のプロジェクト (Windows フォームなど) のビルドおよびデバッグとほとんど同じです。 このセクションのトピックでは、いくつかある相違点について説明します。 アプリケーションのビルド方法に関する一般的な情報については、「Visual Studio でのコンパイルとビルド」を参照してください。

Note

複数のプラットフォームで Office エクスペリエンスを拡張するソリューションの開発に関心がありますか。 新しい Office アドイン モデルを確認してください。 Office アドインの占有領域は、VSTO アドインやソリューションと比較して小さく、その作成には、HTML5、JavaScript、CSS3、XML など、ほぼすべての Web プログラミング テクノロジを使用できます。

Office プロジェクトのプロジェクト出力

Office プロジェクトは、 プロジェクト名\bin\release または プロジェクト名\bin\debug に出力されます。 配置ディレクトリにはビルドできません。

ドキュメントレベルのプロジェクト

ドキュメント レベルのプロジェクトをビルドすると、プロジェクト出力には次の項目が含まれるようになります。

  • プロジェクト ドキュメントのコピー。

  • プロジェクト アセンブリと、 ［ローカル コピー］ プロパティが trueに設定されているすべての参照先アセンブリ。

  • アプリケーション マニフェスト。ファイル名には .manifest というファイル名拡張子が付けられます。 詳細については、「Office ソリューションのアプリケーション マニフェスト」を参照してください。

  • 配置マニフェスト。ファイル名には .vsto というファイル名拡張子が付けられます。 詳細については、「Office ソリューションの配置マニフェスト」を参照してください。

  • プログラム データベース (PDB) ファイル。

Note

ドキュメント レベルのソリューションを、ローカル コンピューターではなくリモートの場所に作成する場合は、アプリケーションのセキュリティ センターにある信頼できる場所のリストに完全修飾パスを追加します。 詳細については、「Office ソリューションをセキュリティで保護する」の「ドキュメントへの信頼の付与」セクションを参照してください。

アプリケーション レベルのプロジェクト

VSTO アドイン プロジェクトをビルドすると、次の項目がプロジェクト出力に含まれます。

  • プロジェクト アセンブリと、 ［ローカル コピー］ プロパティが trueに設定されているすべての参照先アセンブリ。

  • アプリケーション マニフェスト。ファイル名には .manifest というファイル名拡張子が付けられます。 詳細については、「Office ソリューションのアプリケーション マニフェスト」を参照してください。

  • 配置マニフェスト。ファイル名には .vsto というファイル名拡張子が付けられます。 詳細については、「Office ソリューションの配置マニフェスト」を参照してください。

  • プロジェクト アセンブリのプログラム データベース (PDB) ファイル。

    VSTO アドイン プロジェクトのビルド処理により、開発用コンピューターには、VSTO アドインの読み込みに必要な一連のレジストリ エントリも作成されます。 詳細については、「VSTO アドインのレジストリ エントリ」を参照してください。

    フォーム領域を含む Outlook VSTO アドイン プロジェクトをビルドすると、ビルド処理により、次に示す情報がレジストリに追加されます。

  • 1 つ以上のフォーム領域に関連付けられている各メッセージ クラスのキー。

  • 各フォーム領域のエントリと、Outlook VSTO アドインの名前を表す関連値。

    この情報は、Outlook がフォーム領域を読み込むために必要になります。

参照アセンブリ

Office ソリューションのビルド プロジェクトからアセンブリ (クラス ライブラリ プロジェクトを含む) を参照できます。 各参照先アセンブリには、 ［ローカル コピー］というプロパティがあります。 ［ローカル コピー］ では、アセンブリを出力ディレクトリにコピーするかどうかを指定します。 既定では trueに設定されています。 ［ローカル コピー］ が true に設定されている参照先アセンブリは、すべて出力ディレクトリにコピーされます。

ビルド処理中のセキュリティ

ビルド処理中、Visual Studio は、ソリューションに信頼を付与するように、開発用コンピューター上のセキュリティ設定を自動的に構成します。 これにより、デバッグしながらソリューションを実行できるようになります。

Office プロジェクトでは、発行者を確認するために証明書が使用されます。 Visual Studio は、Office ソリューションを識別するための一時的な証明書を自動的に作成し、その一時的な証明書を信頼するように開発コンピューターを構成します。

詳細については、「Office ソリューションをセキュリティで保護する」を参照してください。

ネットワーク プロジェクト

アセンブリまたはドキュメントの場所がネットワーク共有上に存在している場合は、ローカル (User レベル) セキュリティ ポリシーを更新するだけでは、ソリューションを実行できるようになりません。 管理者は、ソリューションの実行前に、コンピューター (Machine) レベルで、ネットワーク共有上のアセンブリとドキュメントに完全な信頼を付与する必要があります。 セキュリティ ポリシーの設定方法の詳細については、「Office ソリューションをセキュリティで保護する」を参照してください。

ドキュメント レベルのプロジェクトでは、Office の信頼できるフォルダーのリストに、ドキュメントの完全修飾位置を追加する必要もあります。 詳細については、「ドキュメントへの信頼の付与」を参照してください。

プラットフォーム ターゲットの変更

既定では、Office プロジェクトのプラットフォーム ターゲットは Any CPUです。 通常、この設定を変更する必要はありません。 Any CPU プラットフォーム ターゲット設定でビルドされた Office ソリューションは、32 ビット バージョンと 64 ビット バージョンの Microsoft Office 2013 か Office 2010 で実行するようになります。

64 ビット バージョンの Microsoft Office 2013 か Office 2010 でのみ実行するソリューションを作成していて、そのソリューションからネイティブの 64 ビット API を呼び出す場合は、プラットフォーム ターゲットを x64 に限定して設定する必要があります。 プラットフォームの対象設定変更の詳細については、「方法: プロジェクトを構成して対象プラットフォームを設定する」を参照してください。

プラットフォーム ターゲットを x64 に設定すると、そのソリューションは 32 ビット バージョンの Windows または Office では実行できなくなります。 x64 プラットフォーム ターゲットには、64 ビット プロセスで実行するソリューションが必要になります。

[クリーン] コマンドの使用

開発用コンピューターからビルド済みのプロジェクト ファイルを削除する場合は、Visual Studio の [ビルド] メニューにある [クリーン] コマンドを使用できます。 [クリーン] コマンドにより、ビルドの出力場所にあるファイルがすべて削除されます。 アプリケーション レベルのプロジェクトの場合は、 [クリーン] コマンドによって、ビルド処理で作成されたレジストリ エントリも削除されます。

Title 説明
Office プロジェクトのデバッグ Office プロジェクトのデバッグに関する問題について説明します。
チュートリアル: Excel のドキュメント レベルのカスタマイズを初めて作成する Excel 用の基本的なドキュメント レベルのカスタマイズを作成する方法を示します。
方法: 無効にされた VSTO アドインを再度有効にする ハードまたはソフトに無効化されている VSTO アドインを再度有効化する方法について説明します。
Office ソリューションを設計して作成する Office ソリューションの作成に関する情報と、ソリューション内のアセンブリの役割に関する情報へのリンクが掲載されています。