Sublime Kulture

Sublime Text 3 对 ASP.NET vNext 的扩展

在这篇README中，您将学习如何在Sublime Text 3中安装组件以开始使用ASP.NET。其中还包括一个入门教程，向您展示本版本中包含的一些功能。

安装：Mac OS X

1. 安装 ASP.NET vNext 命令行工具

2. 下载 Sublime Text 3

3. 使用 Package Control 插件 安装 Sublime Kulture

   • 按照这些说明安装 package control
   • 打开命令面板（在OS X上为Cmd + Shift + P，在Windows上为Ctrl + Shift + P）。
   • 选择 Package Control: Install Package
   • 当列表出现时选择 Kulture
   • Package Control 将自动将 Kulture 更新到最新版本。

手动安装 * 将 Sublime Kulture 克隆到 /Users/{user}/Library(Application Support/Sublime Text 3/Packages

git clone https://github.com/OmniSharp/Kulture.git

安装：Windows

1. 安装 ASP.NET vNext 命令行工具

   • 准备Powershell执行策略。在管理员PowerShell窗口中执行以下命令。

     Set-ExecutionPolicy RemoteSigned

   • 从管理员命令提示符窗口运行以下命令

     powershell -NoProfile -ExecutionPolicy unrestricted -Command "iex ((new-object net.webclient).DownloadString('https://raw.githubusercontent.com/aspnet/Home/master/kvminstall.ps1'))"

   • 关闭命令提示符窗口，然后在新命令提示符窗口中运行以下命令

     kvm upgrade

   • 如果您在安装 ASP.NET vNext 命令行工具时已经在运行 Sublime，则需要重新启动 Sublime 以应用更改。

2. 下载并安装 Sublime Text 3

3. 安装 Sublime Kulture

使用 Package Control 插件 * 按照这些说明安装 package control * 打开命令面板（在OS X上为Cmd + Shift + P，在Windows上为Ctrl + Shift + P）。 * 选择 Package Control: Install Package * 当列表出现时选择 Kulture * Package Control 将自动将 Schema Validator 更新到最新版本。

手动安装 * 将 Sublime vNext 克隆到 C:\Users\{user}\AppData\Roaming\Sublime Text 3\Packages

git clone https://github.com/OmniSharp/Kulture.git

注：如果你从未启动过Sublime Text，那么Sublime Text 3目录可能不存在。如果你找不到这个目录，请尝试启动Sublime，然后再次尝试。

入门教程

本教程将向您展示如何在Sublime Text 3中开始使用ASP.NET vNext。完成本教程后，您将熟悉如何使用Sublime Kulture及其主要功能。

要开始，您可以使用yeoman。

注：这要求您已经安装了node.js和npm。

npm install -g yo
npm install -g generator-aspnet

要运行yeoman脚手架，请键入：

yo aspnet

让我们使用yo aspnet创建一个新的Web项目。在Sublime中，点击文件 -> 打开文件夹，导航到要打开的文件夹。

注：在Mac上的Sublime中使用文件 -> 打开命令。

由于我们刚刚从源代码控制中获取了这些，该项目需要一些缺失的NuGet程序包。要还原NuGet程序包：

• 按Ctrl(Cmd) + Shift + P弹出命令面板。
• 键入运行K命令然后按Enter（Return）。
• 键入dnu restore然后按Enter（Return）。

注：当执行dnu restore时，如果您收到关于缺失NuGet程序包的错误，您可以使用替代命令dnu restore -s https://www.myget.org/F/aspnetvnext/api/v2。

您应该会看到一个Terminal/Powershell窗口启动并执行您的命令。

现在，让我们让Sublime使用ASP.NET作为构建系统。要做到这一点，请点击工具 -> 构建系统 -> ASP.NET。

• 按Ctrl(Cmd) + B或F7以构建项目。

您应该能够在屏幕底部的输出窗口中看到构建的结果。到此为止，您的代码应该已经成功构建。

现在让我们看看在您的.cs文件中存在错误时的体验。在Startup.cs文件中引入一个错误并尝试再次构建。现在，您应该在输出窗口中看到错误。您可以通过以下方式导航错误：

• F4可以将您带到下一个错误。
• Shift + F4可以将您带到上一个错误。

当错误获得焦点时，它将在构建结果中突出显示，并且您的光标将被带到报告错误的那一行和列。

在我们解决了所有引入的错误之后，让我们尝试运行应用程序。

• 按Ctrl(Cmd) + Shift + P弹出命令面板。
• 键入运行K命令然后按Enter（Return）。
• 键入dnx web然后按Enter（Return）。
• 如果您在Mac或Linux上，键入dnx kestrel然后按Enter（Return）。

您应该会看到Terminal/Powershell窗口启动并开始运行您的服务器。您可以在您喜欢的浏览器中导航到http://localhost:5001（或者在Mac上http://localhost:5000）来查看网站。

智能感知

要使Sublime中的智能感知生效，请安装OmnisharpSublime（遵循README中的说明）。

要使用ASP.Net vNext项目获取智能感知，您需要在Sublime中创建一个项目文件。转到项目 - 保存项目为，并为您的项目输入一个名称。OmniSharpSublime将使用此信息来决定它需要提供智能感知的哪些文件和程序集（提示：如果看不到智能感知，请关闭并重新打开Sublime，这可能需要10秒钟，一旦Sublime加载了所有插件，OmniSharpServer服务器就会启动）

一旦安装了OmniSharpSublime并且您已经有了项目文件，您应该能够看到智能感知。

致谢

Sublime终端

All of Sublime Terminal is licensed under the MIT license.

  Copyright (c) 2011 Will Bond 

  Permission is hereby granted, free of charge, to any person obtaining a copy
  of this software and associated documentation files (the "Software"), to deal
  in the Software without restriction, including without limitation the rights
  to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
  copies of the Software, and to permit persons to whom the Software is
  furnished to do so, subject to the following conditions:

  The above copyright notice and this permission notice shall be included in
  all copies or substantial portions of the Software.

  THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
  IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
  FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
  AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
  LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
  OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
  THE SOFTWARE.