- Microsoft 365 developer programへの参加
- https://learn.microsoft.com/ja-jp/office/developer-program/microsoft-365-developer-program
- OutlookのWindowsクライアントもダウンロードしておく
- Adminセンター->Admin->Subscriptions->Microsoft 365 E5 Developer 試用版->Download and install softwareからダウンロードする
- Go
- Node.jsおよびnpm
- リポジトリのホームに移動し、
build.batを実行する- アドイン用サイトをビルドする。成果物の静的サイト用ファイルはdistフォルダに作成される。
これは、以下の処理を実行している。
npm install- npmの必要なモジュールをインストール（リポジトリのモジュールが更新された場合には再実行）
nxp webpack- JavaScriptをまとめつつ、リリース用フォルダのdistフォルダに成果物の静的サイト用ファイルを出力する
- リポジトリのホームに移動し、管理者権限のコマンドプロンプトから
build-web-server.batを実行するlocal-web-server-keysフォルダにローカルHTTPSサーバー用の自己署名証明書を作成する。- 自己署名証明書を信頼されたルート証明機関の証明書としてインポートする
local-web-serverフォルダにHTTPSサーバーのexeおよび必要なキーファイルを作成する（local-web-server-keysフォルダからのコピー）
これは、以下の処理を実行している。
実際の処理はbuild-and-import-keys.batおよびbuild-web-server.batを参照のこと。
go run tools\generate_cert\generate_cert.go --host 127.0.0.1- 自己証明書およびサーバー秘密鍵用の作成
copy cert.pem cert.crt- 自己署名証明書をインストール可能な形式に変更
certutil -addstore ROOT cert.crt- 自己署名証明書を信頼されたルート証明機関の証明書としてインポートする
go build tools\https_server\https_server.go
パーソナルHTTPS Webサーバーの仕様は以下の通り。
ファイル名: https_server.exe
引数: --root Webサーバーのルートパスを指定する。デフォルトは.\web
概要: --rootで指定されたパスをhttps://127.0.0.1:10041でホスティングする。
https_server.exeと同じフォルダにkey.pem（サーバー用秘密鍵）とcert.pem（自己署名証明書）が必要。
tests\run-test-serverに移動し、管理者権限のコマンドプロンプトからrun-test-server.batを実行する。
実行すると、以下の処理を実行する。
- アドインの静的サイトファイルを
distに作成 - 自己署名証明書およびサーバー秘密鍵がなければ作成
- 自己署名証明書のインポート
- パーソナルHTTPS Webサーバーのビルド
distをtests\run-test-server\webにコピー- パーソナルHTTPS Webサーバーで
tests\run-test-server\webをホスティング
- 以下のいずれかの方法でアドイン追加ページを呼び出す
- デスクトップアプリ
- 「テスト用にパーソナルHTTPS Webサーバーを起動する」の手順を実施し、Webサーバーを起動する
- Windowsクライアント版のOutlookを起動する
- [ファイル]->[アドインの管理]を選択する
- Webアプリ
- https://aka.ms/olksideload にアクセスする
- デスクトップアプリ
- Webブラウザで[Outlook 用アドイン]ページが開く
- [個人用アドイン]->[カスタムアドイン]->[カスタムアドインの追加]を選択する
- [ファイルから追加]を選択する
flex-confirm-mail-outlook-webリポジトリのmanifest.xmlを指定する- [カスタムアドイン]にFlexConfirmMailが追加される
何らかのメールを送信しようとしたときに「FlexConfirmMail が要求を処理しています」というメッセージや、「FlexConfirmMail」というタイトルのダイアログが表示されれば正しくインストールできている。
なお、現状では、設定用のリボンのボタンなども存在しない。 設定はWebサーバーのconfigsフォルダー配下のファイルを直接編集する。
F12で開発者ツールを開くことができるので、ログやデバッガーで動作を確認する。 アドインのHTMLやJavaScriptが読み込まれるのは、実際にアドインが使用されるときであるのに注意。 例えば、メール送信時のアドインは、メールを送信したときに呼び出される。
FlexConfirmMailの警告ダイアログなど、すべてHTMLで実装されているページについては、F12で開発者ツールを開くことができる。 以降はWeb版と同様にデバッグが可能。
また、以下の手順にしたがい、フレームワークを利用したデバッグをすることも可能。 本プロジェクトの場合、Node.jsでのデバッグとなる。
https://learn.microsoft.com/ja-jp/office/dev/add-ins/testing/debug-add-ins-overview