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等）的朋友参与该项目。