Mac で Office アドインをデバッグする

  • [アーティクル]

アドインは HTML と JavaScript を使用して開発されているため、プラットフォーム間で動作するように設計されていますが、さまざまなブラウザーで HTML をレンダリングする方法に微妙な違いがある可能性があります。 この記事では、Mac で実行されているアドインをデバッグする方法について説明します。

重要

Office on Mac でのアドインのデバッグは、Office が Apple アプリ ストアではなく、Office.com から Mac にインストールされている場合にのみ可能です。

Mac での Safari Web インスペクタを使用したデバッグ

作業ウィンドウまたはコンテンツ アドインに UI を表示するアドインを使用している場合は、Safari Web インスペクタを使用して Office アドインをデバッグできます。

Mac で Office アドインをデバッグするには、Mac OS High Sierra および Mac Office バージョン 16.9.1 (ビルド 18012504) 以降が必要です。 Office on Mac ビルドをお持ちでない場合は、Microsoft 365 開発者プログラムを通じて Microsoft 365 E5 開発者サブスクリプションを受ける資格があります。詳細については、 FAQ を参照してください。 または、 1 か月間の無料試用版にサインアップ するか、 Microsoft 365 プランを購入することもできます。

最初に端末を開き、該当する Office アプリケーションの OfficeWebAddinDeveloperExtras プロパティを以下のように設定します。

  • defaults write com.microsoft.Word OfficeWebAddinDeveloperExtras -bool true

  • defaults write com.microsoft.Excel OfficeWebAddinDeveloperExtras -bool true

  • defaults write com.microsoft.Powerpoint OfficeWebAddinDeveloperExtras -bool true

  • defaults write com.microsoft.Outlook OfficeWebAddinDeveloperExtras -bool true

    重要

    Office の Mac App Store ビルドでは、 OfficeWebAddinDeveloperExtras フラグはサポートされていません。

次に Office アプリケーションを開き、アドインをサイドロードします。 アドインを右クリックします。コンテキスト メニューに [要素の検査] オプションが表示されるはずです。 このオプションを選択するとインスペクタが表示されます。インスペクタでは、ブレークポイントを設定してアドインをデバッグできます。

注:

インスペクタとダイアログ フリッカーを使おうとしている場合は、Office を最新バージョンに更新してください。 それでもちらつきが解決しない場合は、次の回避策を試してください。

  1. ダイアログのサイズを変更します。
  2. [要素の検査] を選択します (新しいウィンドウが開きます)。
  3. ダイアログを元のサイズに変更します。
  4. 必要に応じてインスペクタを使用します。

Mac 上の Office アプリケーションのキャッシュをクリアする

多くの場合、アドインはパフォーマンス上の理由から Office on Mac にキャッシュされます。 通常、キャッシュはアドインを再読み込みすることでクリアされます。 同じドキュメント内に複数のアドインが存在する場合、再読み込み時にキャッシュを自動的にクリアするプロセスは信頼できない可能性があります。

パーソナリティ メニューを使用してキャッシュをクリアする

作業ウィンドウ アドインの [パーソナリティ] メニューを使用してキャッシュをクリアすることができます。 ただし、Outlook アドインではパーソナリティ メニューがサポートされていないため、Outlook を使用している場合は、 キャッシュを手動でクリア するオプションを試すことができます。

  • [パーソナリティ] メニューを選択します。 次に、[Web キャッシュのクリア] を選択します。

    注:

    macOS バージョン 10.13.6 以降を実行して、パーソナリティ メニューを表示する必要があります。

    パーソナリティ メニューの [Web キャッシュのクリア] オプション。

キャッシュを手動でクリアする

~/Library/Containers/com.Microsoft.OsfWebHost/Data/フォルダーと~/Library/Containers/com.microsoft.{host}/Data/Documents/wef フォルダーの内容を削除して、キャッシュを手動でクリアすることもできます。 {host}を Office アプリケーション (Excel など) に置き換えます。 ターミナル経由でこれらのフォルダーを探します。

~/Library/Containers/com.microsoft.{host}/Data/Documents/wef フォルダーの内容を削除すると、アプリケーションのアドイン メニューからサイドロードされたアドインが削除されます。

注:

~/Library/Containers/com.Microsoft.OsfWebHost/Data/ フォルダーが存在しない場合は、ターミナル経由で次のフォルダーを確認し、見つかった場合はフォルダーの内容を削除します。

  • {host} が Office アプリケーション (例: Excel) である ~/Library/Containers/com.microsoft.{host}/Data/Library/Caches/
  • {host} が Office アプリケーション (例: Excel) である ~/Library/Containers/com.microsoft.{host}/Data/Library/Application Support/Microsoft/Office/16.0/Wef/
  • ~/Library/Containers/com.microsoft.Office365ServiceV2/Data/Caches/com.microsoft.Office365ServiceV2/
  • ~/Library/Containers/com.microsoft.Office365ServiceV2/Data/Library/Caches/com.microsoft.Office365ServiceV2/

ヒント

Finder を使用してこれらのフォルダーを検索するには、非表示のファイルを表示するように Finder を設定する必要があります。 Finder は、com.microsoft.Excel ではなく Microsoft Excel などの製品名で Containers ディレクトリ内のフォルダーを表示します。