共用方式為

測試套件指導方針

  • 發行項

重要事項

Microsoft 365 的測試基礎將於 2024 年 5 月 31 日轉換為生命周期結束 (EOL) 。 我們致力於與每位客戶密切合作，以提供支援和指引，讓轉換盡可能順暢。 如果您有任何問題、疑慮或需要協助， 請提交支援要求。

1.參考腳本

當您將 .zip 檔案上傳至入口網站時，我們會將該檔案的所有內容解壓縮到根資料夾。 您不需要撰寫任何程式代碼來執行此初始解壓縮作業。 您也可以使用相對於所上傳 zip 檔案的路徑，參考 .zip 內的任何檔案。

在下列範例中，我們會示範如何從 [工作] 索引卷標中的輸入欄位參考您的二進位檔/腳本。藍色文字應該輸入 到 [腳本路徑] 字段 中，而不需要加上引號。

在上傳 ZIP 檔案之前，請務必留意該檔案中的內容。 壓縮資料夾時，本機計算機通常會在 zip 檔案下建立主要資料夾。 在此情況下，參考會如下方 粗體 所示：

Contoso_App_Folder.zip：

├── Contoso_App_Folder

│   ├── file1.exe

│   ├── ScriptX.ps1

│   ├── folder1

│      ├── file3.exe

│      ├── script.ps1
  • ScriptX.ps1 - “Contoso_App_Folder/ScriptX.ps1”
  • Script.ps1 - “Contoso_App_Folder/folder1/script.ps1”

其他時候，zip 檔案的底下可能會有您的檔案或內容 (例如，沒有第二層資料夾) ：

Zip_file_uploaded.zip：

├── file1.exe

├── ScriptX.ps1

├── folder1

│   ├── file3.exe

│   ├── script.ps1
  • ScriptX.ps1 - “ScriptX.ps1”
  • Script.ps1 - “folder1/script.ps1”

2.腳本執行

現成可用的測試： 應用程式套件必須包含至少三個PowerShell腳本。 這些文稿會自動安裝、啟動和關閉應用程式及其相依性。 每個腳本都應該處理檢查自己的必要條件、驗證自己的成功，並在必要時自行清除 () 。

功能測試： 應用程式套件至少必須包含一個 PowerShell 腳本。 提供多個腳本時，腳本會以上傳順序執行，而特定腳本中的失敗將會阻止後續腳本執行。

腳本需求

  • PowerShell 5.1+ 版
  • 自動執行
  • 錯誤傳回碼
  • 驗證成功
  • 記錄至文稿特定記錄檔資料夾

每個腳本都需要自動執行， (使用者不會提示) 在測試管線中成功執行。

注意事項

腳本應該會在成功完成時傳回 「0」 如果在執行期間發生任何錯誤，則傳回非零的錯誤碼。

每個腳本都應該驗證它是否已成功執行。 例如，安裝腳本應該在安裝程式二進位檔完成執行之後，檢查系統上是否有特定的二進位檔和/或登錄機碼。 這項檢查有助於確保安裝成功具有合理的信賴度。

必須進行驗證，才能正確診斷測試回合期間發生錯誤的位置。 例如，如果腳本無法成功安裝應用程式，或無法啟動它。

重要事項

避免下列事項：

  • 腳本不應該重新啟動電腦，如果需要重新啟動，請在上傳腳本期間指定此專案。
  • 請勿修改 Windows IP 組態中的 DNS 後綴搜尋清單。

重要事項

可用的光碟空間上限為 127 Gb。 將不會執行耗用超過此空間量的套件。

重要事項

與 Windows UI 互動的套件必須啟用自動註冊認證，才能正確執行。

重要事項

封裝內的腳本都有 60 分鐘的運行時間限制。 腳本在 60 分鐘後執行會逾時。

3.記錄收集

每個腳本都應該將其產生的任何記錄輸出到名為 的檔案 logs夾中。 目錄中所有名為 logs 的資料夾都會複製並呈現，以供頁面下載 Test Results 。

例如，可能位於 App/scripts/install 目錄) 的安裝腳本 (可以將其記錄輸出到： logs/install.log，因此最終記錄會位於： Apps/scripts/install/logs/install.log

系統會與其他資料夾內logs的其他檔案一起挑選install.log檔案，並將其定序以供下載。

4.應用程式二進位檔

任何二進位檔和相依性都應該包含在單一 zip 檔案中。

這些二進位檔應該包含安裝應用程式所需的一切 (例如，應用程式安裝程式) 。 如果應用程式相依於任何架構，例如 .NET Core/Standard 或 .NET Framework，這些架構應該包含在檔案中，並在提供的腳本中正確參考。

注意事項

上傳的 zip 檔案名稱中不能有任何空格或特殊字元

5.應用程式/測試規則

為了讓您的應用程式/測試在測試基底基礎結構下正確執行，它們必須符合應用程式 /測試規則 中所述的規則。

後續步驟

前往下一篇文章，以檢視常見 問題 (常見問題)

下一步