撰寫 Azure Functions 並在本機進行測試

雖然您能夠在 Azure 入口網站中開發及測試 Azure Functions，但許多開發人員仍偏好本機開發體驗。 使用 Functions 時，您將可更輕鬆地使用慣用的程式碼編輯器和開發工具，在本機電腦上建立及測試函式。 您的本機函式可以連線到即時 Azure 服務，且您可以使用完整的 Functions 執行階段在本機電腦上進行偵錯。

本文針對您慣用的語言提供特定開發環境的連結。 此外也提供本機開發的一些通用指引，例如使用 local.settings.json 檔案。

本機開發環境

您在本機電腦上開發函式的方式取決於您的語言和工具喜好設定。 下表中的環境支援本機開發：

每個本機開發環境都可讓您建立函式應用程式專案，並使用預先定義的函式範本來建立新的函式。 每個環境都會使用 Core Tool，以便您在自己的電腦上針對實際的 Functions 執行階段進行您的函式測試和偵錯，就如同處理任何其他應用程式一樣。 您也可以從上述任何環境將您的函式應用程式專案發佈至 Azure。

本機專案檔

不論何種語言，Azure Functions 專案目錄都在專案根資料夾中包含下列檔案：

專案中的其他檔案取決於您的語言和特定函式。 如需詳細資訊，請參閱以您的語言撰寫的開發人員指南。

本機設定檔

local.settings.json 檔案會儲存本機開發工具所使用的應用程式設定和設定。 只有當您在本機執行專案時，才會使用 local.settings.json 檔案中的設定。 當您將專案發佈至 Azure 時，請務必同時將任何必要的設定新增至函數應用程式的應用程式設定。

本機設定檔案具有以下結構：

{
  "IsEncrypted": false,
  "Values": {
    "FUNCTIONS_WORKER_RUNTIME": "<language worker>",
    "AzureWebJobsStorage": "<connection-string>",
    "MyBindingConnection": "<binding-connection-string>",
    "AzureWebJobs.HttpExample.Disabled": "true"
  },
  "Host": {
    "LocalHttpPort": 7071,
    "CORS": "*",
    "CORSCredentials": false
  },
  "ConnectionStrings": {
    "SQLConnectionString": "<sqlclient-connection-string>"
  }
}

當您在本機執行專案時，支援下列設定：

在本機執行時，下列應用程式設定可以包含在 Values 陣列中：

同步處理設定

當您在本機開發函式時，您部署程式碼的函數應用程式應用程式設定中，也必須出現應用程式所需的任何本機設定。 您可能也需要從函數應用程式將目前的設定下載到本機專案。 雖然您可以在 Azure 入口網站中手動設定應用程式設定，但下列工具也可讓您將應用程式設定與專案中的本機設定進行同步處理：

• Visual Studio Code
• Visual Studio
• Azure Functions Core Tools

觸發和繫結

在本機開發函式時，您必須考慮觸發程序和繫結行為。 針對 HTTP 觸發程序，您可以使用 http://localhost/，在本機電腦上簡單地呼叫 HTTP 端點。 針對非 HTTP 觸發的函式，有數個選項可在本機執行：

• 在本機開發期間測試繫結最簡單的方式是使用以即時 Azure 服務為目標的連接字串。 您可以在 local.settings.json 檔案的 Values 陣列中新增適當的連接字串設定，以將即時服務設為目標。 當您這樣做時，測試期間的本機執行就會影響即時服務資料。 因此，請考慮在開發和測試期間設定使用不同的服務，然後在生產期間切換至差異服務。
• 針對儲存體型觸發程序，您可使用本機儲存體模擬器。
• 您可使用特殊的系統管理員端點，手動執行非 HTTP 觸發程序函式。 如需詳細資訊，請參閱手動執行非 HTTP 觸發的函式。

在本機測試期間，您必須在本機執行 Core Tools (func.exe) 所提供的主機。 如需詳細資訊，請參閱 Azure Functions Core Tools。

HTTP 測試工具

在開發期間，當您支援 HTTP GET 方法時，很容易從網頁瀏覽器呼叫任何函式端點。 不過，對於支援 POST 或 PUT 等承載的其他 HTTP 方法，您必須使用 HTTP 測試工具來建立這些 HTTP 要求，並將其傳送至函式端點。

您可以選擇離線或本機運作的 HTTP 測試工具，來保護您的資料，不會將資料同步處理至雲端，而且不需要您登入線上帳戶。 某些工具也可以藉由實作特定的安全性功能，保護您的數據免於意外暴露。

避免使用集中儲存 HTTP 要求歷程記錄的工具（包括敏感性資訊）、不要遵循最佳安全性做法，或不尊重數據隱私權考慮。

請考慮使用下列其中一個工具來安全地將 HTTP 要求傳送至您的函式端點：

• Visual Studio Code 搭配 Visual Studio Marketplace 的擴充功能，例如 REST 用戶端
• PowerShell Invoke-RestMethod
• Microsoft Edge - 網路主控台工具
• Bruno
• curl

本機儲存體模擬器

在本機開發期間，您可以在使用 Azure 儲存體繫結 (佇列儲存體、Blob 儲存體和表格儲存體) 測試函式時，使用本機 Azurite 模擬器，而不必連線到遠端儲存體服務。 Azurite 會與 Visual Studio Code 和 Visual Studio 整合，您也可以使用 npm，從命令提示字元加以執行。 如需詳細資訊，請參閱使用 Azurite 模擬器進行本機 Azure 儲存體開發。

local.settings.json 檔案 Values 集合中的下列設定會告知本機 Functions 主機，針對預設 AzureWebJobsStorage 連線使用 Azurite：

"AzureWebJobsStorage": "UseDevelopmentStorage=true"

採用此設定值，任何使用 AzureWebJobsStorage 來做為其連線的 Azure 儲存體觸發程序或繫結，都會在本機執行時連線到 Azurite。 在本機執行期間使用儲存體模擬時，請記住這些考量：

• 您必須安裝並執行 Azurite。
• 在發佈至 Azure 之前，您應該先測試與 Azure 服務的實際儲存體連線。
• 當您發佈專案時，請勿以 UseDevelopmentStorage=true 形式發佈 AzureWebJobsStorage 設定。 在 Azure 中，AzureWebJobsStorage 設定一律是函式應用程式所使用的儲存體帳戶連接字串。 如需詳細資訊，請參閱AzureWebJobsStorage。

下一步

• 若要深入了解如何使用 Visual Studio 在本機開發已編譯的 C# 函式 (包含內含式和隔離背景工作處理序)，請參閱使用 Visual Studio 開發 Azure Functions。
• 若要深入了解如何在 Mac、Linux 或 Windows 電腦上使用 VS Code 進行函式的本機開發，請參閱您慣用語言的 Visual Studio Code 入門文章：
  • C# (內含式)
  • C# (隔離背景工作處理序)
  • Java
  • JavaScript
  • PowerShell
  • Python
  • TypeScript
• 若要深入了解如何從命令提示字元或終端機開發函式，請參閱使用 Azure Functions Core Tools。