MPOS (シールド) と CPOS 拡張機能のデバッグ

  • [アーティクル]

この記事では、シールドの Modern 販売時点管理 (MPOS) と Cloud POS 拡張機能のデバッグ方法について説明します。 Retail ソフトウェア開発キット (SDK) バージョン 10.0.18 以降に適用されます。

メモ

Store Commerce アプリのデバッグについては、Visual Studio Code を使用し Store Commerce 拡張機能のデバッグ を参照してください

Visual Studio 2017 を使用したシールド Modern POS のデバッグ

次の手順に従って拡張機能をデバッグします。

  1. シールドされた MPOS インストーラーを使用して、開発マシンでシールドされた Modern POS をインストールします。 Modern POS (SEALED) インストーラは、https://lcs.dynamics.com/V2/SharedAssetLibrary> Retail セルフ サービス パッケージ セクションからダウンロードが可能です。

  2. Modern POS (SEALED) インストーラのインストール後に、デスクトップ ショートカット アイコンは POS Universal Windows Platform (UWP) アプリをインストールまたは更新するために作成されます。 デスクトップ上で Retail Modern POS のインストールまたは更新アイコンをダブル クリックし、UWP アプリをインストールします。 この前に必要なバックエンド コンポーネントを配置し、UWP アプリをインストールします。

  3. Microsoft Visual Studio で、MPOS 拡張機能パッケージ プロジェクト (JavaScript プロジェクト ファイル [.jsproj file]) を構築します。

  4. MPOS 拡張機能パッケージを配置します。 ソリューション エクスプローラーで、MPOS .jsproj ファイルを選択したまま (または右クリック) にして、配置を選択します。

  5. デバッガーが関連付けられるように POS を開きます。

    1. デバッグ メニューで、その他のデバッグ ターゲット > インストールされたアプリ パッケージをデバッグする。
    2. Commerce Modern POS を検索して選択します。
    3. 開始を選択すると、アプリケーションが開きます。

Cloud POS の実行およびデバッグ

Cloud POS 拡張機能の開発環境のコンフィギュレーション

拡張機能パッケージがマシン上で初めて開発されたとき、またはリンクが削除された場合は、次の手順を実行します。 Cloud POS (CPOS) 拡張機能ディレクトリに、拡張機能パッケージ ルート ディレクトリへのディレクトリ シンボル リンクを作成します。

  1. CPOS がマシンに配置されていることを確認します。 配置されていない場合は、Commerce Scale Unit (自己ホスト) インストーラーを使用して配置します。

  2. インターネット インフォメーション サービス (IIS) を開きます。 Windows ロゴ キーと R キーを同時に押して、実行ダイアログ ボックスに inetmgr と入力し、OK を選択します。

  3. サイトを展開し、RetailCloudPos を選択したまま (または右クリック) にして、エクスプローラーを選択します。

  4. ファイルを選択し、管理者として Windows PowerShell を開くを選択します。

  5. Windows PowerShell ウィンドウで次のコマンドを実行し、Windows コマンド プロンプトを開きます。

    cmd .

  6. 次のコマンド を実行して、現在のディレクトリを拡張機能のルート ディレクトリに変更します。

    cd Extensions

  7. 次のコマンドを実行して、拡張機能パッケージの名前を持つセッション変数を作成します。

    set ExtensionPackageName=Contoso.Pos.Developer.Samples

    メモ

    Contoso.Pos.Developer.Samples を POS 拡張機能パッケージの名前に置き換えます。 拡張機能パッケージ名は、POS 拡張機能パッケージを構成する Commerce Runtime CRT トリガー拡張機能の ExtensionPackageDefinition で指定された名前と一致する必要があります。

  8. 次のコマンドを実行して、POS 拡張機能パッケージ プロジェクト ディレクトリへの絶対パスを持つセッション変数を作成します。

    set AbsolutePathToExtensionPackageProject=%FullPathToPOSExtensionProjectRootDirectory%

    メモ

    %FullPathToPOSExtensionProjectRootDirectory% を POS 拡張機能パッケージ プロジェクトへの絶対パスに置き換えます。 次に例を示します。

    set AbsolutePathToExtensionPackageProject=K:\RetailCloudPos\WebRoot\Extensions\ Contoso.Pos.Developer.Samples

  9. 次のコマンドを実行して、拡張機能ディレクトリから拡張機能パッケージ プロジェクトのルート ディレクトリへのリンクを作成します。

    mklink /D %ExtensionPackageName% %AbsolutePathToExtensionPackageProject%

  10. 拡張機能パッケージのリンク フォルダーが CPOS 拡張機能パッケージ ディレクトリに作成されているかどうかを確認します。

Microsoft Edge 開発者ツールを使用した CPOS のデバッグ

  1. この記事で前述されている Cloud POS 拡張機能の開発環境のコンフィギュレーション セクションの手順に従います。
  2. CPOS 拡張機能プロジェクトを構築します。
  3. Microsoft Edge で、CPOS Web サイトを開きます。
  4. F12 キーを選択して、Microsoft Edge 開発者ツールを開きます。
  5. CPOS 拡張機能パッケージのルート ディレクトリを指すワークスペースを設定します。 この手順を初めて実行する場合は、ワークスペースを設定する必要があります。
  6. JavaScript ソース マッピングが有効であることを確認します。