Office 365 應用開發的 .NET Core 模板庫

概述

前不久我寫過一篇文章擁抱開源，Office 365開發迎來新時代，給你們介紹了Office 365開發的典型場景是如何支持開源平臺的：Office 365經過Microsoft Graph，以REST API的方式提供服務，任何開發平臺均可以很方便地與其進行集成；Office Add-ins，SharePoint Add-ins和Microsoft Teams Apps開發，均可以基於標準的Web開發技術棧來實現，並且官方提供了對NodeJS，React，TypeScript等主流平臺和框架的默認支持（工具和模板層面都有）。

文章發表以後，我收到很多反饋，其實我心裏深處牽掛的還有廣大的.NET開發人員啊。你們知道，.NET從頭到腳都是已經徹底開源了的，針對Office 365的這些開發場景，是否有開箱即用的模板可供你們使用呢？利用週末的時間，我開始了這個新的項目，就是爲你們整理出來一套標準的.NET Core模板庫，歡迎用你最熟悉的姿式關注 https://github.com/chenxizhang/dotnetcore-office365dev-templates，你能夠簡單粗暴地直接給我 star,也能夠 fork 這個項目經過 pull request 提交你的模板，你還能夠經過issue通道給我反饋問題。

這一套模板庫，不只僅能夠下降廣大的.NET 開發人員（準確地說是.NET Core開發人員）學習和使用Office 365開發平臺的門檻（尤爲是如何在不一樣的場景下完成OAuth認證以及快速經過實例學習Graph的典型功能），還有一個獨特的價值是可讓你在國際版和國內版這兩個平臺的選擇和切換過程當中少走一些彎路，我相信真正作過這方面開發的朋友們如今必定是熱淚盈眶的表情。

但願你們喜歡！

計劃支持的模板

先決條件

要使用這些模板，你只須要在開發機器上面安裝了 .NET Core SDK 版本2.0 及以上便可。請經過官方網站提示到的方式進行下載和安裝(https://www.microsoft.com/net/download/)。請注意，咱們如今是跨平臺的哦，不管Windows，仍是Mac，或是Linux都支持進行.NET Core開發。

另外，你可能至少須要一款代碼編輯器，你能夠安裝Visual Studio，也可使用Visual Studio Code，甚至是任何一個文本編輯器。我是使用 Visual Studio Code.

如何安裝模板

安裝這些模板很是簡單，你只須要一行命令便可，dotnet new -i 模板標識，例如使用dotnet new -i chenxizhang.dotnetcore.msgraph.console.CSharp 來安裝能夠快速實現Microsoft Graph的控制檯應用程序模板。

如何使用模板

模板安裝成功後，你能夠在模板列表中看到這些新的模板，每一個模板都有一個短名稱（Short Name），你能夠經過 dotnet new 模板短名稱來使用這些模板，例如 dotnet new graphconsole 這句命令就能夠快速基於模板建立一個能夠快速實現Microsoft Graph的控制檯應用程序。

每一個模板都帶有一些參數以便支持不一樣的場景，最典型的參數是 --instance，這個參數將告訴模板引擎，你使用的Office 365環境是國際版仍是國內版的，它是一個必填項，有兩個選項，分別是global表明國際版，gallatin表明國內版，但默認會設置爲國際版。

你不須要記住全部這些參數，而是能夠經過 dotnet new 模板短名稱 -h這樣的命令來查看該模板的介紹和參數說明。

每一個模板都帶有一個詳細的說明文檔，你能夠點擊上表中模板短名稱跳轉，同時在生成的代碼文件的頂部也有連接，我很是歡迎你們給我反饋。

如何卸載模板

在以下兩種狀況下，你可能須要卸載模板

1. 你再也不喜歡這些模板（我但願這種狀況不會發生）
   
2. 你須要安裝模板的更新版本

不管是哪種緣由，你均可以隨時簡單地經過 dotnet new -u 模板標識 進行卸載，例如dotnet new -u chenxizhang.dotnetcore.msgraph.console.CSharp能夠卸載控制檯應用程序模板。請放心，我不會帶走一片雲彩。

常見問題解答（將持續更新）

1. 這些模板支持哪些開發語言？
   

   目前僅支持C#。限於能力和精力，其餘的語言暫時沒有支持計劃，歡迎有其餘語言特長（例如F#,VB.NET等）的朋友參與該項目。