次の方法で共有

ランタイム ログを使用してアドインをデバッグする

  • [アーティクル]

ランタイム ログを使用して、アドインのマニフェストやいくつかのインストール エラーをデバッグできます。 この機能は、リソース ID の不一致のような XSD スキーマ検証では検出されないマニフェストの問題を識別して修正するのに役立ちます。 ランタイム ログは、アドイン コマンドと Excel カスタム関数を実装するアドインのデバッグに特に役立ちます。

注:

ランタイム ログ機能は現在、デスクトップで Office 2016 以降で使用できます。

重要

ランタイムのログはパフォーマンスに影響します。 アドイン マニフェストに関する問題をデバッグする必要がある場合にのみ有効にしてください。

コマンド ラインからランタイム ログを使用する

コマンド ラインからランタイム ログを有効にするのが、このログ ツールを使用する最も簡単な方法です。

重要

Office-addin-dev-settings ツールは Mac ではサポートされていません。 Mac 固有の手順については、「 Mac でのランタイム ログ記録 」セクションを参照してください。

  • ランタイムのログを有効にするには、以下を実行します。

    npx office-addin-dev-settings runtime-log --enable

  • 特定のファイルに対してのみランタイム ログを有効にするには、ファイル名と同じコマンドを使用します。

    npx office-addin-dev-settings runtime-log --enable [filename.txt]

  • ランタイム ログを無効にするには、以下を実行します。

    npx office-addin-dev-settings runtime-log --disable

  • ランタイム ログが有効になっているかどうかを表示するには、以下を実行します。

    npx office-addin-dev-settings runtime-log

  • ランタイム ログのコマンド ライン内にヘルプを表示するには、以下を実行します。

    npx office-addin-dev-settings runtime-log --help

Mac でのランタイム ログ

  1. Office 2016 デスクトップ ビルド 16.27.19071500 以降を実行していることを確認します。

  2. ターミナルを開き、defaultsコマンドを使用してランタイム ログの優先度を設定します。

    defaults write <bundle id> CEFRuntimeLoggingFile -string <file_name>

    <bundle id>は、ランタイム ログを有効にするホストを識別します。 <file_name>は、ログが書き込まれるテキスト ファイルの名前です。

    <bundle id>を次のいずれかの値に設定して、対応するアプリケーションのランタイム ログを有効にします。

    • com.microsoft.Word
    • com.microsoft.Excel
    • com.microsoft.Powerpoint
    • com.microsoft.Outlook

次の例では、Wordのランタイム ログを有効にしてから、ログ ファイルを開きます。

defaults write com.microsoft.Word CEFRuntimeLoggingFile -string "runtime_logs.txt"
open ~/library/Containers/com.microsoft.Word/Data/runtime_logs.txt

注:

ランタイム ログを有効にするには、defaultsコマンドを実行した後に Office を再起動する必要があります。

ランタイム ログを無効にするには、defaults deleteコマンドを使用します。

defaults delete <bundle id> CEFRuntimeLoggingFile

次の例では、Wordのランタイム ログをオフにします。

defaults delete com.microsoft.Word CEFRuntimeLoggingFile

ランタイム ログを使用してマニフェストでの問題のトラブルシューティングを行う

ランタイムのログを使用してアドインの読み込みに関する問題のトラブルシューティングを行うには、次のようにします。

  1. テスト用にアドインをサイドロードします。

    注:

    ログ ファイルのメッセージ数を最小限に抑えるため、テストするアドインのみをサイドロードすることをお勧めします。

  2. 何も起こらず、アドインが表示されない (アドイン ダイアログ ボックスにも表示されない) 場合は、ログ ファイルを開きます。

  3. マニフェストで定義したアドイン ID をログ ファイルで検索します。 ログ ファイルでは、この ID には SolutionIdというラベルが付けられます。

ランタイムのログに関する既知の問題

混乱を招くメッセージまたは正しく分類されていないメッセージがログ ファイルに書き込まれることがあります。 たとえば次のような場合です。

  • メッセージ "Medium Current host not in add-in's host list" に続く "Unexpected Parsed manifest targeting different host" は、誤ってエラーとして分類されています。

  • SolutionId が含まれていないメッセージ "Unexpected Add-in is missing required manifest fields DisplayName" は、多くの場合、エラーはデバッグ対象のアドインと関係ありません。

  • Monitorable メッセージは、システムの観点からのエラーと予想されます。 場合によっては、スキップされたがマニフェスト失敗の原因にはならなかったスペル ミスのある要素のような、マニフェストの問題を示していることがあります。

関連項目