側載應用程式映射套件以進行測試

在開發期間，您可能需要將圖像套件側載至 Azure 球體裝置進行測試。 當您使用 Visual Studio 或 Visual Studio Code 整合式開發環境 (IDE) 建立應用程式時，SDK 會為您封裝應用程式映射。 如果您可以直接存取 Azure 球體裝置，SDK 也可以刪除未 標示為合作夥伴的現有應用程式、將新映射套件載入到裝置上、啟動它，以及啟用偵錯。 您也可以直接從命令列側載圖像套件。

您必須先啟用裝置的 app 必要 功能，並將裝置新增至不支援雲端應用程式更新的 裝置群組 。 將裝置指派給這類群組，可確保雲端部署不會覆寫您的側載應用程式。 若要準備您的裝置，請使用az 球形裝置啟用開發命令。 然後您可以側載影像。

從命令列側載及偵錯圖像套件

若要從命令列側載圖像套件，請刪除裝置上的任何現有應用程式，然後載入新的應用程式。

若要停止並刪除裝置上的所有應用程式：

az sphere device sideload delete

若要刪除單一應用程式，請新增 --元件識別碼選項，如下所示：

az sphere device sideload delete --component-id <ComponentID>

接下來，側載新的影像套件：

az sphere device sideload deploy --image-package <imagepackagepath>

以影像套件的路徑取代 imagepackagepath 。 如果您使用的是 Visual Studio 或 Visual Studio Code，您可以在應用程式專案資料夾的 bin\ARM\Debug 或 bin\ARM\Release 子資料夾中找到影像套件。 根據預設，命令會在部署後啟動應用程式。

若要偵錯應用程式，請將 --手動啟動標幟新增至 az 球體裝置側載部署 命令以隱藏自動啟動，然後啟動應用程式進行偵錯：

az sphere device sideload deploy --manual-start --image-package <imagepackagepath>

az sphere device app start --debug --component-id <ComponentID>

命令會顯示高階應用程式的輸出和偵錯埠：

   Output Port: 2342
   GDB Port: 2345

將應用程式標示為合作夥伴

相關應用程式應標示為合作夥伴應用程式。 在許多情況下，您會載入多個應用程式，例如一對互相溝通的高階和即時應用程式。 將應用程式標示為合作夥伴會在載入第二個應用程式時防止其遭到刪除。 當 Visual Studio 和 Visual Studio Code ID 側載新的影像套件時，會刪除所有未標示為合作夥伴應用程式的現有應用程式。

若要在 Visual Studio 中使用 CMake 將應用程式標示為合作夥伴：

1. 編輯應用程式的 launch.vs.json 檔案。

2. 新增下列一行：

   "partnerComponents": [ "<Component ID>" ]
   

   以合作夥伴應用程式的元件識別碼替代 <Component ID> 並儲存檔案。 您可以在其 app_manifest.json 檔案或使用已安裝的球球裝置映射清單或 az 球形裝置應用程式顯示狀態，找到每個應用程式的元件標識符。

若要在 Visual Studio Code 中使用 CMake 將應用程式標示為合作夥伴：

1. 編輯應用程式的 .vscode\launch.json 檔案。

2. 新增下列一行：

   "partnerComponents": [ "<Component ID>" ]
   

   以合作夥伴應用程式的元件識別碼替代 <Component ID> 並儲存檔案。 您可以在其 app_manifest.json 檔案或使用已安裝的球球裝置映射清單或 az 球形裝置應用程式顯示狀態，找到每個應用程式的元件標識符。