封裝 Power BI 視覺效果

您必須先封裝自訂視覺效果，才能將自訂視覺效果載入 Power BI Desktop 或與社群共用。使用此教學課程，您將：

輸入屬性值

在 PowerShell 中，如果視覺效果正在執行，請停止視覺效果。
在 VS Code 中，流覽至視覺效果專案的根資料夾，然後開啟 pbiviz.json 檔案。
在物件中 visual ，將 displayName 值設定為您想要成為視覺效果的顯示名稱。

當您將游標停留在視覺效果圖示上方時，視覺效果的顯示名稱會出現在 Power BI 的 [視覺效果 ] 窗格中。
在 pbiviz.json 檔案中 填入或修改下欄欄位：
- visualClassName
- description
visualClassName 是選擇性的，但 description 必須填入套件命令才能執行。
填入 supportUrl 並 gitHubUrl 填入使用者可以流覽的 URL，以取得支援並檢視視覺效果的 GitHub 專案。

下列程式碼顯示 supportUrl 和 gitHubUrl 範例：
```
{
    "supportUrl": "https://community.powerbi.com",
    "gitHubUrl": "https://github.com/microsoft/PowerBI-visuals-circlecard"
}
```
在物件中 author 輸入您的名稱和電子郵件。
儲存 pbiviz.json 檔案。

在 pbiviz.json 檔案中 ，請注意檔會定義物件中 assets 圖示的路徑。圖示是出現在 Power BI 中 [視覺效果] 窗格中的 影像。它必須是 PNG 格式檔案和 20 x 20 圖元。
在 Windows 檔案總 管中 ，複製您想要使用的 icon.png 檔案，然後貼上它來取代位於 assets 資料夾中的預設 icon.png 檔案。
在 VS Code 的 [總管] 窗格中，展開 assets 資料夾，然後選取 icon.png 檔案。
檢閱圖示。

在 VS Code 中，確定已儲存所有檔案。
在 PowerShell 中，輸入下列命令來產生 pbiviz 檔案：
```
pbiviz package
```
此命令會在 視覺效果專案的 /dist/ 目錄中建立 pbiviz 檔案 ，並覆寫可能存在的任何先前 pbiviz 檔案。

封裝會輸出至 專案的 /dist/ 資料夾。套件包含將自訂視覺效果匯入Power BI 服務或 Power BI Desktop 報表所需的所有專案。您已封裝自訂視覺效果，且已可供使用。