2016-12-04

Azure Bot Service - Part 3 (認識 Bot Service 的專案結構)

Azure Bot Service 目前僅支援 C#Node.js


C#

以 Basic Templates 為例
Location File Description
messages EchoDialog.csx C# 指令碼 檔,bot 回應的程式碼.
messages function.json json 檔,包含 Azure Function 的繫結資訊,不要自行手動修改
messages project.json json 檔,紀錄專案的 Nuget 參考資訊,只有在加入其他參考時才需要修改.
messages project.lock.json json 檔,自動產生的,不需修改.
messages run.csx C# 指令碼 檔,bot 驗證檢查以及收到訊息第一手處理位置,也是 bot 啟動的位置.
PostDeployScripts runGulp.cmd 指令檔,會去執行 npm install 跟 gulp task(gulpfile.js 不存在就執行預設的 task) template 中沒有 gulpfile.js ,也看不到預設的 task 內容
root .gitignore gitignore 檔,git 專用,用來記載不需要被 git 版本的相關檔案及資料夾。是還在 preview 階段所以才有這個嗎?
root Bot.sln Visaul Studio 的專案檔,供開發者本機電腦使用 提醒:使用本機 IDE 編輯功能,需啟用 continuous integration,啟用後將無法再次使用 Azure 線上編輯器
root commands.json json 檔,內容是在使用 Visual Studio 開啟專案時,透過工作執行器總管 (Task Runners Explorer)來執行debughost,如果 Visula Studio 沒有安裝工作執行器總管 (Task Runners Explorer),可以刪除這個檔案。關於工作執行器總管 (Task Runners Explorer),可以參考Visual Studio 2015 工作執行器 (Task Runners) 簡介
root debughost.cmd 指令檔,用來載入及執行 bot.供開發者本機偵錯使用,想了解更多可以看 Debugging C# bots built using the Azure Bot Service on Windows. Templates Overview提到該檔包含 app ID 跟密碼,但我看並沒有,, 實際測試:需要使用 func azure functionapp fetch-app-settings {YOUR_BOT_SERVICE_NAME} 抓回相關設定.
root host.json json 檔,關於 Azure Function 全域設定選項的中繼資料檔.
root readme.md markdown 檔,簡易的說明文件,只說想要知道如何偵錯,可以看 https://aka.ms/bf-docs-azure-debug.

Node.js

以 Basic Templates 為例
Location File Description
messages index.js C# 指令碼 檔,bot 回應的程式碼.
messages package.json json 檔,紀錄專案的 NPM 參考資訊,只有在加入其他參考時才需要修改.
messages/.vscode launch.json json 檔,提供 Visual Studio Code 進行偵錯的.
messages/node_modules . node.js 參考的相關 module.
PostDeployScripts runGulp.cmd 指令檔,會去執行 npm install 跟 gulp task(gulpfile.js 不存在就執行預設的 task) template 中沒有 gulpfile.js ,也看不到預設的 task 內容
root .gitignore gitignore 檔,git 專用,用來記載不需要被 git 版本的相關檔案及資料夾。是還在 preview 階段所以才有這個嗎?
root host.json json 檔,關於 Azure Function 全域設定選項的中繼資料檔.

node.js 連 readme 都沒有,連 Templates Overview資料也還沒更正

error

參考資料

  1. Templates Overview
  2. Visual Studio 2015 工作執行器 (Task Runners) 簡介
  3. 基礎 .NET - C# 指令碼

沒有留言:

張貼留言