Yeoman ジェネレーターを使用して Office アドイン プロジェクトを作成する

Office アドイン用 Yeoman Generator ("Yo Office" とも呼ばれます) は、Office アドイン開発プロジェクトを作成する対話型の Node.js ベースのコマンド ライン ツールです。 これらのプロジェクトは Node.js ベースです。 アドインのサーバー側コードを に配置する場合。NET ベースの言語 (C# や VB.Net など) またはインターネット インフォメーション サーバー (IIS) でアドインをホストする場合は、 Visual Studio を使用してアドインを作成します。

ツールによって作成されるプロジェクトには、次の特性があります。

• package.json ファイルを含む標準的な npm 構成があります。
• これには、プロジェクトをビルドしたり、サーバーを起動したり、アドインを Office にサイドロードしたりするための便利なスクリプトがいくつか含まれています。
• これらは、バンドルと基本的なタスク ランナーとして webpack を使用します。
• 開発モードでは、これらは、ホットリロードと再コンパイルオン変更をサポートする 高速 サーバーの開発指向バージョンである、webpack の Node.js ベースの webpack-dev-server によって localhost でホストされます。
• 既定では、すべての依存関係がツールによってインストールされますが、コマンド ライン引数を使用してインストールを延期できます。
• 完全なアドイン マニフェストが含まれています。
• ツールが完了するとすぐに実行できる "Hello World" レベルのアドインがあります。
• これには、TypeScript を ES5 JavaScript にトランスパイルするトランスパイラーと、ES5 JavaScript で以降のバージョンの JavaScript の機能を使用できるようにするためのポリフィルが含まれます。 これらは、Trident (インターネット エクスプローラー) などの従来の Web ビューとの下位互換性を提供しますが、Microsoft はこれらの古い Web ビューを使用する Office のバージョンのアドインの開発をサポートしていません。

前提条件

• Node.js (最新 LTS バージョン)。 Node.js サイトにアクセスして、オペレーティング システムに適したバージョンをダウンロードしてインストールします。

• 最新バージョンの Yeoman と Office アドイン用の Yeoman ジェネレーター。これらのツールをグローバルにインストールするには、コマンド プロンプトから次のコマンドを実行します。

  npm install -g yo generator-office
  

  注:

  Yeomanのジェネレーターを過去に取付けている場合でも、npmからのパッケージを最新のバージョンにすることをお勧めします。

• Microsoft 365 サブスクリプションに接続されている Office (Office for the web を含む)。

  注:

  まだ Office をお持ちでない場合は、Microsoft 365 開発者プログラムを通じてMicrosoft 365 E5開発者サブスクリプションを受ける資格があります。詳細については、FAQ を参照してください。 または、 1 か月間の無料試用版にサインアップ するか、 Microsoft 365 プランを購入することもできます。

ツールを使用する

(bash ウィンドウではなく) システム プロンプトで次のコマンドを使用してツールを起動します。 これにより、現在のディレクトリの新しいフォルダーに新しいプロジェクトが作成されます。

yo office 

多くの読み込みが必要なので、ツールが起動するまでに 40 秒かかる場合があります。 このツールでは、一連の質問が表示されます。 一部のユーザーは、プロンプトに対する回答を入力するだけです。 他のユーザーには、考えられる回答の一覧が表示されます。 一覧が表示された場合は、上方向キーと下方向キーを使用して 1 つを選択し、[ Enter] を選択します。

最初の質問では、いくつかの種類のプロジェクトから選択するように求められます。 以下のオプションがあります:

• Office アドイン作業ウィンドウ プロジェクト
• Microsoft 365 用の統合マニフェストを含む Excel、PowerPoint、またはWord作業ウィンドウ (プレビュー)
• React フレームワークを使用した Office アドイン作業ウィンドウ プロジェクト
• 共有ランタイムを使用した Excel カスタム関数
• JavaScript 専用ランタイムを使用した Excel カスタム関数
• シングル サインオンをサポートする Office アドイン作業ウィンドウ プロジェクト
• 入れ子になったアプリ認証シングル サインオンをサポートする Office アドイン作業ウィンドウ プロジェクト (プレビュー)
• マニフェストのみを含む Office アドイン プロジェクト

次の質問では、 TypeScript と JavaScript のどちらかを選択するように求 められます。 (前の質問でマニフェストのみのオプションを選択した場合、この質問はスキップされます)。

その後、アドインに名前を付けるよう求められます。 指定した名前はアドインのマニフェストで使用されますが、後で変更できます。 これは、プロジェクトのフォルダー名でもあります。

その後、アドインを実行する Office アプリケーションを選択するように求められます。 Excel、OneNote、Outlook、PowerPoint、Project、Wordの 6 つのアプリケーションから選択できます。 1 つだけ選択する必要がありますが、マニフェストを後で変更して、追加の Office アプリケーションをサポートできます。 例外は Outlook です。 Outlook をサポートするマニフェストは、他の Office アプリケーションをサポートできません。

Office アプリケーションとして [Outlook ] を選択すると、使用するマニフェストの種類を確認する追加の質問が表示されます。 統合マニフェストではまだサポートされていない機能拡張機能がアドインに含まれていない限り、 Microsoft 365 の統合 マニフェストを選択することをお勧めします。

すべての質問に回答すると、ジェネレーターによってプロジェクトが作成され、依存関係がインストールされます。 画面の npm 出力に WARN メッセージが表示される場合があります。 これらは無視できます。 また、脆弱性が見つかったというメッセージが表示される場合もあります。 現時点ではこれらを無視できますが、最終的にはアドインが運用環境にリリースされる前に修正する必要があります。 詳細については、「 Node.js と npm の世界での警告と依存関係」を参照してください。

作成が成功した場合は、コマンド ウィンドウに [おめでとう! ] メッセージが表示され、その後に推奨される次の手順がいくつか表示されます。 (クイック スタートまたはチュートリアルの一部としてジェネレーターを使用している場合は、コマンド ウィンドウの次の手順を無視して、記事の手順に進んでください)。

yo office --skip-install

マニフェストのみのオプション

このオプションでは、アドインのマニフェストのみが作成されます。 結果のプロジェクトには、Hello World アドイン、スクリプト、または依存関係がありません。 次のシナリオでは、このオプションを使用します。

• Yeoman ジェネレーター プロジェクトが既定でインストールおよび構成するツールとは異なるツールを使用する必要があります。 たとえば、別のバンドル、トランスパイラー、タスク ランナー、または開発サーバーを使用します。
• Vue などのReact以外の Web アプリケーション開発フレームワークを使用する必要があります。

Word、PowerPoint、または Excel と統合マニフェスト オプション

Microsoft 365 の統合マニフェストは、Excel、PowerPoint、Word アドインのプレビュー段階にあります。運用環境のアドインには使用しないでくださいが、Yo Office でこのオプションを選択して、これらの Office アプリケーションの 1 つ (または 3 つすべて) のアドインを作成できます。 どの Office アプリケーションを選択するかを求められます。 [ すべて ] を選択して、3 つの Office アプリケーションすべてにインストールできるアドインを作成することもできます。 作成されるプロジェクトでは、TypeScript が使用されます。

コマンド ライン パラメーターを使用する

パラメーターを yo office コマンドに追加することもできます。 2 つの最も一般的なオプションは、次のとおりです。

• yo office --details: これにより、他のすべてのコマンド ライン パラメーターに関する簡単なヘルプが出力されます。
• yo office --skip-install: これにより、ジェネレーターが依存関係をインストールできなくなります。

コマンド ライン パラメーターの詳細については、 Office アドイン用 Yeoman ジェネレーターのジェネレーターの readme を参照してください。

トラブルシューティング

ツールを使用して問題が発生した場合は、最初に再インストールして、最新バージョンがインストールされていることを確認する必要があります。 (詳細については 、「前提条件 」を参照してください)。それでも問題が解決しない場合は、 GitHub リポジトリの問題を検索して、ツールを検索 して、他のユーザーが同じ問題を検出し、解決策を見つけたかどうかを確認します。 誰もいない場合は、 新しい問題を作成します。